Servidor MCP

Endpoint

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

Streamable HTTP, respuestas JSON, sin sesión que mantener. Envía una clave como cabecera bearer, o deja que el cliente inicie sesión con OAuth (abajo).

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: Settings → Connectors → Add custom connector → la URL de arriba. Añade la clave como cabecera bearer si el cliente la pide; si no, te pedirá iniciar sesión.

ChatGPT y otros clientes OAuth: añade https://app.monoranks.com/api/mcp como servidor MCP. El cliente lee /.well-known/oauth-protected-resource, se registra, y tú inicias sesión y apruebas los permisos de lectura una vez. Los permisos de escritura nunca se conceden de esta forma.

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
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	search:read
ai_visibility	Lo que respondieron los asistentes de IA a tus preguntas seguidas, por semana	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 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

site_id solo hace falta cuando la clave cubre varios sitios web; list_sites muestra los ids. Si falta un permiso, vuelve un error de la herramienta que lo nombra. Las herramientas dan las mismas respuestas que la API REST, así que los detalles de allí también valen aquí.

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.