Conectar un asistente
SORANK ya aloja el servidor MCP remoto enhttps://app.sorank.com/mcp. No tienes que crear un endpoint MCP ni ejecutar un servidor local.
- En un asistente compatible con MCP remoto mediante Streamable HTTP y OAuth authorization code con PKCE S256, abre la configuración de MCP o conectores.
- Añade un servidor remoto con la URL
https://app.sorank.com/mcp. Selecciona OAuth o autenticación automática. Ni el sitio web, ni/api/public/v1, nilocalhostson la dirección MCP. - Pulsa Conectar o Autorizar. El cliente descubre la configuración OAuth, se registra si es necesario y abre el inicio de sesión de SORANK. Revisa los scopes y sitios solicitados antes de aprobarlos.
- Vuelve al asistente, actualiza las herramientas y llama a
list_profiles. Solo aparecerán los sitios autorizados. Después usaget_capabilitiesy, conquotas:read,get_quotas.
npx.
Leer la pantalla de consentimiento
La pantalla de consentimiento indica qué aplicación solicita el acceso y adónde se envía la autorización.- Verificada: la autorización se envía a la dirección oficial de un asistente conocido, como Claude o ChatGPT. SORANK muestra entonces el nombre de ese asistente.
- En este ordenador: la aplicación se ejecuta en su propio ordenador, como un asistente de escritorio o una herramienta de desarrollo. Permita el acceso solo si usted mismo inició la conexión.
- No verificada: cualquier otra dirección. El nombre de la aplicación lo elige quien la registró: compruebe la dirección antes de permitir el acceso.
Alternativa con clave personal
Si el cliente admite una cabeceraAuthorization personalizada para MCP remoto, crea una clave en https://app.sorank.com/settings/api con los sitios y scopes necesarios. Configura Authorization: Bearer <clave-completa> en el almacenamiento seguro del cliente, nunca en el prompt. La clave completa solo se muestra una vez. OAuth es preferible para clientes interactivos.
Configurar OAuth
Los metadatos del recurso MCP están enhttps://app.sorank.com/.well-known/oauth-protected-resource/mcp y los del servidor de autorización en https://app.sorank.com/.well-known/oauth-authorization-server. Los clientes compatibles los descubren automáticamente. Quienes desarrollen clientes deben usar los endpoints OAuth anunciados, PKCE S256 y el recurso exacto https://app.sorank.com/mcp.
Comprobar la elegibilidad
Puede conectar un asistente cuando ha completado el onboarding en Sorank y al menos un sitio tiene una suscripción válida. Si no, la pantalla de consentimiento explica lo que falta, enlaza con el onboarding o con Configuración → Facturación, y Permitir acceso no está disponible. Complete ese paso y vuelva a iniciar la conexión desde el asistente. Solo se pueden seleccionar sitios elegibles, ylist_profiles solo devuelve sitios elegibles. Si un sitio pierde después su suscripción, sus herramientas devuelven subscription_required, incluso en una sesión ya abierta.
Elegir herramientas y permisos
Pida al cliente que liste las herramientas después de conectarse. El servidor solo anuncia las herramientas que permite su autorización y vuelve a comprobarla en cada llamada. Una herramienta oculta no se puede invocar directamente.- Sitios y cuotas:
list_profiles,get_capabilities,get_quotas. - Ver productos:
list_products. - Ver analíticas:
get_gsc_performance,list_gsc_queries,list_gsc_pages,get_gsc_countries_devices,get_ai_traffic_timeline,list_ai_traffic_pages. - Ver visibilidad IA:
get_geo_stats,get_geo_mentions_evolution,get_geo_citations_timeline,list_geo_citing_sources,get_geo_cited_competitors. - Ver ajustes:
get_settings. Editar ajustes:update_site_settings,replace_business_brief,replace_competitors,update_article_settings,update_visual_settings,connect_youtube_channel,set_youtube_channel_enabled,disconnect_youtube_channel. - Investigar y generar palabras clave:
research_keywords,get_keyword_metrics,generate_keywords. Siga una búsqueda completa de palabras clave conget_keyword_run. - Ver mejoras:
get_audit,list_audit_pages,estimate_audit_fixes,list_audit_fixes. Lanzar auditorías y corregir artículos:start_audit,recheck_audit_page,fix_audit_page,apply_audit_fix,restore_audit_fix,fix_audit_bulk. - Actualizar productos:
refresh_product_catalog. Ver artículos:get_article_index_status. - Ver visibilidad IA:
list_geo_prompts. Editar prompts de visibilidad IA:create_geo_prompts,update_geo_prompt,delete_geo_prompts. - Ver enlaces entrantes:
get_backlinks,list_backlink_quests. Gestionar enlaces entrantes y misiones:update_backlink_settings,claim_backlink_quest. - Ver facturas:
list_invoices. - Contenido:
create_calendar,generate_articles,publish_article,get_operationy las demás herramientas de artículos y calendario.
Seguir un flujo seguro
Empieza conlist_profiles, get_capabilities y get_quotas. Crea un calendario o genera artículos después de comprobar la cuota. Cada cambio necesita un UUID idempotency_key en la entrada de la herramienta. Guarda el ID de operación y consulta get_operation hasta que termine. Un comando aceptado puede fallar después; revisa resultado o error. Lee el artículo antes de editarlo o publicarlo.
Efectos y revocación
Crear un calendario puede programar generaciones y publicaciones posteriores.generate_articles usa la cuota de artículos de la cuenta; su recibo es succeeded en cuanto se acepta el lote, y cada artículo aceptado se sigue con get_article. publish_article puede enviar contenido a un CMS, según sus capacidades y el destino elegido. Las herramientas de ajustes cambian los mismos ajustes que la aplicación y devuelven una lista effects con los procesos iniciados en segundo plano, como una regeneración de las preguntas GEO o una sincronización de YouTube. La URL del sitio no se puede cambiar. El mismo plan, permisos y cuota se aplican en la aplicación y en REST. Revocar la conexión o perder el acceso al sitio bloquea las llamadas y lecturas de operaciones posteriores.
En un sitio Framer, get_publication también devuelve site_deploy. Framer solo muestra un cambio después de publicar el sitio, algo que Sorank hace aproximadamente un minuto después de cada cambio: pending significa que public_url aún no muestra el último cambio, y live, que ya está en línea. Mientras el estado sea pending, last_error_code indica el error del último despliegue fallido, por ejemplo cms_token_expired cuando hay que sustituir la clave API de Framer.
Cuando una publicación falla, get_publication devuelve status failed con last_error.code publication_failed. Si Sorank registró la causa, last_error.reason la indica, por ejemplo site_unreachable: Sorank no pudo conectarse al sitio, así que comprueba que esté en línea y que su proveedor de alojamiento o su cortafuegos no bloqueen Sorank. Pueden añadirse nuevas causas: trata una causa desconocida como un fallo genérico.
En una tienda PrestaShop conectada con una clave de Webservice, sin el módulo de Sorank, update_published_article no puede cambiar la dirección de una página publicada. Si cambiaste el slug del artículo, la operación termina en failed con publication_change_failed. Restablece el slug publicado o instala el módulo de Sorank en la tienda.
Gastar créditos de IA y corregir artículos
La investigación de palabras clave, las búsquedas completas de palabras clave y las correcciones de artículos usan los créditos de IA del sitio, al mismo precio que en la aplicación.get_quotas devuelve el saldo y el precio actual de cada acción. Llame a estimate_audit_fixes antes de corregir una página o todo el sitio: devuelve el coste y no descuenta nada. Si el saldo no alcanza, la herramienta devuelve insufficient_credits con details.required y details.balance. Una investigación de palabras clave que falla se reembolsa.
fix_audit_page prepara las correcciones elegidas, o una reescritura completa. apply_audit_fix escribe después una corrección en el artículo de su CMS, y restore_audit_fix recupera la versión anterior; ambas requieren también Publicar artículos. fix_audit_bulk corrige todo el sitio y aplica cada corrección por sí misma; requiere también Generar artículos y Publicar artículos. start_audit usa la cuota de auditorías del sitio, y solo se ejecuta una auditoría a la vez.
Gestionar errores de herramientas
Una llamada fallida devuelve un error de herramienta con los mismoscode, message, request_id, retryable y details que la API REST, por ejemplo onboarding_required, subscription_required, missing_scope, not_found, gsc_not_connected o business_brief_revision_conflict. Reintente solo si retryable es true.
Comprobar compatibilidad
Esta V1 admite el transporte Streamable HTTP y el flujo OAuth probados, con registro dinámico limitado. No admite clientes que requieren exclusivamente metadatos CIMD. Comprueba las capacidades del cliente antes de conectarlo. El texto de los artículos es contenido del usuario, no instrucciones fiables.Si falla la conexión
- Abrir
/mcpen un navegador no prueba MCP. Introduce la URL en un cliente MCP y selecciona Streamable HTTP. - Si no se abre el inicio de sesión, comprueba OAuth discovery, authorization code con PKCE S256 y registro dinámico. Puedes usar una clave personal si el cliente acepta una cabecera Authorization.
- Si faltan sitios o herramientas, revisa los sitios y scopes aprobados.
list_profilesnecesitaprofiles:read;get_quotasnecesitaquotas:read. - Si deja de funcionar una conexión, revisa su revocación y tu acceso a los sitios en Configuración → Acceso API, y vuelve a conectarla.
- Si la pantalla de consentimiento no permite autorizar, complete el onboarding o actualice la suscripción como se indica y vuelva a conectarse desde el asistente.

