autoranko

Servidor MCP

Usa Autoranko desde tu asistente de IA (MCP)

Autoranko tiene un servidor MCP remoto, así que asistentes como Claude, ChatGPT, Claude Code, Cursor y VS Code pueden auditar páginas, investigar palabras clave y escribir o publicar artículos en tu cuenta. Claude y ChatGPT inician sesión con OAuth; los demás clientes pueden usar un token de API.

  • Unos 5 minutos para conectar (estimación)
  • Última verificación: 8 de noviembre de 2026

Cómo se conecta

El Model Context Protocol (MCP) permite que un asistente de IA llame a herramientas de otro servicio. El servidor MCP de Autoranko es remoto, así que no hay nada que instalar: tu cliente envía peticiones por Streamable HTTP a https://autoranko.com/api/mcp, con sesión iniciada por OAuth o con un token de API en la cabecera Authorization, y el servidor responde con los resultados de las herramientas.

Las herramientas se generan a partir de la misma referencia que la API REST y el archivo OpenAPI, así que siempre coinciden con lo que puede hacer la API. Las herramientas que guardan resultados los llevan a Panel → Settings → API & Apps → Saved results; las que crean o publican artículos actúan sobre tus sitios reales y usan las asignaciones de tu plan.

Conecta tu asistente

  1. 1

    Elige cómo inicia sesión

    Claude y ChatGPT inician sesión con OAuth: apruebas el acceso en una pantalla de consentimiento de Autoranko y eliges qué puede hacer la app, solo lectura si lo prefieres. Para Claude Code, Cursor o VS Code puedes crear en su lugar un token en Panel → API & Apps, limitado a los permisos y sitios que necesite.

  2. 2

    Añade el servidor a tu cliente

    En Claude, añade un conector personalizado con la URL https://autoranko.com/api/mcp (Personalizar → Conectores). En ChatGPT, añádelo como servidor MCP personalizado con OAuth. Los clientes con token añaden un servidor remoto (HTTP) con la misma URL y una cabecera Authorization con Bearer y el token; en Claude Code basta un comando claude mcp add. La documentación de MCP tiene los pasos exactos.

  3. 3

    Comprueba la conexión

    Pregunta al asistente a qué cuenta de Autoranko está conectado: llamará a whoami y mostrará tu cuenta y tu plan. Si las herramientas no aparecen, consulta la sección de problemas de abajo.

  4. 4

    Pídele trabajo real

    Pídele que audite una página, que busque ideas de palabras clave para un sitio conectado o que escriba un artículo y lo deje en revisión. Pide confirmación antes de publicar: publish_job cambia tu sitio en directo.

Qué puede hacer tu asistente

El servidor MCP ofrece 34 herramientas, generadas a partir de la misma referencia que la API REST:

  • whoamiGet the current account
  • list_sitesList sites
  • get_siteGet a site with usage
  • list_articlesList synced articles
  • get_articleGet an article
  • list_article_jobsList jobs
  • create_article_jobCreate a job
  • get_article_jobGet a job
  • publish_jobPublish a job
  • site_keyword_researchResearch keywords
  • geo_list_promptsList tracked prompts
  • geo_add_promptsAdd prompts
  • geo_start_runStart a run
  • geo_list_runsList runs
  • geo_get_runGet a run with its answers
  • geo_statsGet visibility metrics
  • geo_competitorsList the names AI answers give
  • geo_ai_trafficGet AI-assistant traffic (GA4)
  • seo_analyzeAudit a page
  • seo_keyword_researchResearch keywords for any site
  • seo_write_articleWrite a long-form article
  • seo_write_short_articleWrite a short article
  • seo_meta_tagsWrite title and meta description variants
  • seo_open_graphGenerate Open Graph and Twitter tags
  • seo_schemaGenerate JSON-LD structured data
  • seo_headingsPlan the heading structure
  • seo_content_briefCreate a content brief
  • seo_rewriteRewrite copy for SEO
  • seo_alt_textsWrite image alt text
  • robots_sitemapGenerate robots.txt and a sitemap
  • serp_previewPreview a Google result
  • list_seo_analysesList saved analyses
  • get_seo_analysisGet a saved analysis
  • list_ai_modelsList AI models

Límites y advertencias honestas

Las apps conectadas con OAuth solo reciben los permisos que apruebas, y puedes desconectarlas cuando quieras en Panel → API & Apps. Los clientes que solo ejecutan servidores locales (stdio) necesitan un puente hacia un servidor remoto; nuestro propio paquete npm aún no está publicado.

Las peticiones tienen un límite por token, igual que la API REST. Las tareas largas, como escribir un artículo completo, tardan unos minutos, durante los cuales el asistente espera a la herramienta o consulta el trabajo. Las métricas de palabras clave que devuelven las herramientas son estimaciones de IA y se señalan como tales.

Solución de problemas

Los mensajes de abajo son exactamente los que Autoranko muestra en el panel o devuelve la API (en inglés), con lo que significan y cómo resolverlos.

missing_token
La petición llegó al servidor sin credenciales. Los clientes OAuth inician el inicio de sesión a partir de esta respuesta; los clientes con token deben enviar Authorization: Bearer ar_live_…
invalid_token
El token está mal formado, se revocó, caducó o se escribió mal. Vuelve a conectar la app, o crea un token nuevo en Panel → API & Apps y actualiza la configuración del cliente.
rate_limited
El asistente envió demasiadas peticiones en poco tiempo. Espera los segundos que indica la cabecera Retry-After y pide menos llamadas en paralelo si se repite.
El cliente no muestra ninguna herramienta de Autoranko
Asegúrate de que el servidor está configurado como servidor HTTP remoto (Streamable HTTP), no como comando local, y de que la URL termina en /api/mcp. Reinicia el cliente después de editar su configuración.

Preguntas

¿Qué asistentes funcionan?+
Claude y ChatGPT se conectan con inicio de sesión OAuth. Claude Code, Cursor, VS Code y cualquier cliente que admita servidores remotos Streamable HTTP también pueden usar un token de API en una cabecera personalizada.
¿Es seguro dar acceso a un asistente?+
Con OAuth apruebas lo que puede hacer la app, por ejemplo solo lectura, y puedes desconectarla cuando quieras. Un token limitado a los permisos y sitios que necesita el asistente es más seguro que uno con acceso total: mantenlo fuera de archivos compartidos y revócalo en Panel → API & Apps si se filtra.
¿Cuesta algo más?+
No. Las llamadas MCP usan las mismas asignaciones del plan que el panel y la API: las herramientas calculadas son gratuitas, las de IA cuentan en tus acciones de IA mensuales y los artículos, en tu asignación de artículos.

Conecta tu sitio en minutos

Empieza con el plan gratuito, sin tarjeta, y publica tu primer artículo en tu propia plataforma.