Documentación para desarrolladores

Servidor MCP

MonoRanks habla el Model Context Protocol. Apunta un asistente a una URL y podrá leer tus auditorías y actuar sobre ellas.

Endpoint

https://app.monoranks.com/api/mcp

Streamable HTTP sobre POST, respuestas JSON, sin sesión que mantener. Envía una clave como Authorization: Bearer mr_ws_… (una clave de sitio web mr_site_… también funciona), o deja que el cliente inicie sesión con OAuth 2.1 (abajo). Los permisos, el límite por hora (1.200 llamadas por clave) y el acceso del dueño de la clave se comprueban en cada llamada a una herramienta, igual que en la API REST.

Conectar

Claude Code

claude mcp add --transport http monoranks https://app.monoranks.com/api/mcp \
  --header "Authorization: Bearer mr_ws_…"

Claude.ai y Claude Desktop: añade la URL de arriba como conector personalizado (sin verificar: los nombres de los menús de esas apps cambian a menudo). Si el cliente te deja poner una cabecera, envía la clave como cabecera bearer; si no, te pedirá iniciar sesión con OAuth.

ChatGPT y otros clientes OAuth: añade https://app.monoranks.com/api/mcp como servidor MCP. Sin clave, el endpoint responde 401 y remite al cliente a /.well-known/oauth-protected-resource. El cliente se registra (/api/oauth/register), te envía a iniciar sesión y aprobar el acceso (/oauth/authorize, con PKCE) y obtiene su token en /api/oauth/token. Solo puede pedir los permisos de lectura e issues:recheck; audits:run y actions:apply nunca se conceden de esta forma, así que start_audit, las herramientas apply y update_outreach_target necesitan una clave. Consulta Claves de API y permisos.

Herramientas

Leer

Herramienta Qué hace Permiso
list_sites Los sitios web que cubre la clave, con sus ids sites:read
portfolio Todos los sitios web en una llamada: puntuaciones y su cambio, problemas, acciones, última y próxima auditoría, y clics de Search Console (con search:read) sites:read
site_summary Puntuaciones, última auditoría, problemas abiertos, acceso a WordPress y lo recientes que son los datos de cada conexión sites:read
speed_results Velocidad por página probada: prueba de laboratorio y datos de visitantes reales sites:read
audit_status Las últimas auditorías, o una auditoría por audit_id, con las páginas rastreadas y el presupuesto de páginas sites:read
list_issues Problemas, la misma lista que la pantalla Issues issues:read
issue_detail Un problema con páginas, evidencia, explicación y nuevos valores sugeridos (de 100 en 100, suggestions_offset para más) issues:read
list_actions Acciones priorizadas con la ganancia estimada y cuánto tiempo lleva abierta cada una issues:read
page_findings Hallazgos de una página, por id o dirección pages:read
page_history Qué cambió en una página de una auditoría o revisión a la siguiente, por id o dirección pages:read
search_summary Totales de Search Console, páginas y consultas principales search:read
search_rows Filas de Search Console de un rango de fechas, por consulta, página, consulta y página, o día (vuelve a enviar nextCursor como cursor; la exportación CSV solo está en la API REST) search:read
near_page_one Tus pares de consulta y página que están justo detrás de la primera página (posiciones 8 a 20 por defecto), con más impresiones primero, y los clics extra que podría dar una posición top 3 search:read
topics Las páginas del sitio web agrupadas en temas, con clics, consultas principales y si cada tema es fuerte, débil o no recibe clics search:read
analytics_pages Conversiones e ingresos por página de destino de Google Analytics (GA4), junto a los clics de Search Console analytics:read
keywords Las palabras clave tal como las lista la pantalla Keywords, con demanda, posición, oportunidad y la revisión de relevancia; sin las sugerencias fuera de tema search:read
competitors El conjunto de competidores con su puntuación de coincidencia, la revisión con IA de cada sugerencia, cuáles marcan las brechas, palabras clave compartidas, palabras clave en las que están por encima de ti, fuerza y visibilidad search:read
competitor_gaps La posición de cada competidor y la tuya por palabra clave (gaps, content, lost, lead). Cada fila también indica la página en la que posiciona cada competidor. search:read
content_ideas Las brechas de palabras clave agrupadas en temas, con la mayor oportunidad primero: si conviene crear una página nueva o ampliar una, tus páginas que ya están en el tema, las páginas de competidores que posicionan y las palabras clave principales search:read
backlinks El resumen de backlinks y los dominios de referencia de una vista (all, new, lost, review, strong) search:read
list_outreach_targets Páginas y sitios a los que vale la pena pedir un enlace o una mención, ordenados, con el motivo y su estado search:read
ai_visibility Lo que respondieron los asistentes de IA a tus preguntas seguidas, por semana, con las páginas que cita cada respuesta ai:read
answer_gaps Preguntas en las que las respuestas de IA nombran otros sitios web pero no el tuyo ai:read
geo_access Acceso de los rastreadores de IA, llms.txt y señales de entidad y preparación para agentes de la última auditoría ai:read
llms_txt El llms.txt publicado y un borrador listo para publicar ai:read
ai_crawler_rules Lo que robots.txt dice ahora a cada rastreador de IA ai:read
agentic_results Resultados de navegación por agentes con lo que hay que corregir, o una nueva ejecución por job_id ai:read

Actuar

Herramienta Qué hace Permiso
recheck Pone en cola una revisión de un problema issues:recheck
run_agentic_check Vuelve a ejecutar la prueba de navegación por agentes para una página issues:recheck
start_audit Inicia ahora una auditoría completa, con un presupuesto de páginas opcional audits:run
apply Aprueba los nuevos títulos SEO, descripciones, canónicas o noindex de una acción y los escribe en WordPress actions:apply
apply_llms_txt Aprueba un nuevo llms.txt y lo escribe en WordPress actions:apply
apply_ai_crawler_rules Aprueba reglas de permitir o bloquear para rastreadores de IA y las escribe en robots.txt actions:apply
update_competitors Elige, descarta o añade un competidor; elegir o añadir consulta sus brechas de palabras clave dentro de tu límite de datos actions:apply
update_outreach_target Cambia el estado (por contactar, contactado, añadido, rechazado) y la nota de un objetivo de outreach actions:apply

Ejemplo de conversación

“¿Cuál de mis sitios web perdió más clics este mes y cuál es su acción principal?”

El asistente llama a portfolio una vez, elige el sitio web con la mayor caída, luego llama a list_actions para ese sitio y responde con la acción y su ganancia estimada. Si dices “aplícala”, lee los valores sugeridos con issue_detail, llama a apply, y el cambio aparece en la actividad de la app con Undo.

Preguntas frecuentes

¿Qué clientes funcionan?

Cualquiera que admita MCP sobre Streamable HTTP: Claude Code, Claude.ai, Claude Desktop, ChatGPT (conectores en modo desarrollador), Cursor, Windsurf y otros.

¿Puede el asistente romper mi sitio?

Solo tres herramientas cambian tu sitio web: apply, apply_llms_txt y apply_ai_crawler_rules. Siguen las mismas reglas que los botones de la app: solo sitios de WordPress conectados, el dueño de la clave queda registrado como quien aprueba, una comprobación después y Undo en la app durante 30 días. recheck, run_agentic_check y start_audit solo vuelven a leer tu sitio web. update_outreach_target y update_competitors solo cambian datos dentro de MonoRanks: el estado y la nota de un objetivo, o qué competidores sigues.

¿Por qué ChatGPT no necesita una clave?

Los clientes que descubren el inicio de sesión por sí mismos usan OAuth 2.1: te envían a iniciar sesión y aprobar el acceso una vez, y preguntan dónde conectar si puedes abrir más que tus propios sitios web. El token que reciben equivale a una clave de espacio de trabajo con los permisos de lectura y las revisiones que aprobaste, nunca auditorías ni escrituras. Aparece en Settings → Developer access y se puede revocar allí.