Servidor MCP de zaDojo: Claude, Cursor, Codex

zaDojo ofrece un servidor MCP remoto al que puede conectarse cualquier cliente compatible con MCP remoto. MCP (Model Context Protocol) es la forma estándar en que las apps de IA llaman a herramientas externas. A través de él, tu agente puede investigar palabras clave, leer los resultados de Google en directo, consultar las posiciones y los backlinks de cualquier dominio, lanzar auditorías del sitio, seguir posiciones y respuestas de IA y leer tus propios datos de Search Console y Google Analytics.

La dirección del servidor:

https://app.zadojo.com/mcp

La primera vez que un cliente se conecta, abre el inicio de sesión de zaDojo en tu navegador y te pide que apruebes el acceso. A partir de ahí, el cliente puede usar las herramientas en los proyectos que tú ves. Para trabajos de CI y servidores sin navegador, usa una clave de API.

Quien usa Claude Code o Codex saca más partido del plugin, que añade esta conexión y las doce skills de zaDojo en una sola instalación. Sigue los pasos de esta página cuando solo quieras la conexión MCP, o cuando tu cliente no tenga plugin. La guía de configuración del agente tiene un prompt que elige la vía adecuada por ti.

Qué necesitas

Una cuenta de zaDojo. Regístrate y recibe 0,10 € de créditos de prueba sin tarjeta.
Un cliente compatible con servidores MCP remotos por HTTP: Claude Code, Claude Desktop, Cursor, Codex CLI, Codex en la app de escritorio de ChatGPT, ChatGPT con una conexión personalizada, VS Code con Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed o similares.
Un navegador para iniciar sesión, o una clave de API para el uso sin interfaz.

La página Agent setup dentro de la app muestra la misma dirección con un botón para copiarla. ¿Quieres probar los datos de zaDojo antes de registrarte? Las herramientas SEO gratuitas no necesitan cuenta.

Conectar tu cliente

Claude Code

El plugin de Claude Code es la mejor opción para la mayoría. Si solo quieres la conexión, ejecuta esto en una terminal:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

--scope user deja zaDojo disponible en todos los proyectos de tu equipo. Usa --scope local para limitarlo al repositorio actual. Después Claude Code te pide iniciar sesión en zaDojo. Si no aparece el aviso, ejecuta /mcp, selecciona zaDojo y completa el inicio de sesión desde ahí.

Claude Desktop

Con un plan de pago de Claude, el plugin de zaDojo añade la conexión y las skills a la vez. Con el plan Free, o si solo quieres la conexión, añade un conector personalizado:

Abre Customize > Connectors.
Haz clic en Add o + y elige Add custom connector.
Pega https://app.zadojo.com/mcp.
Inicia sesión en zaDojo y aprueba el acceso.

Los conectores personalizados funcionan en Claude Free, Pro, Max, Team y Enterprise. El plan Free permite un conector personalizado.

Cursor

Abre Customize y ve a los servidores MCP, o edita directamente ~/.cursor/mcp.json.
Añade la entrada de zaDojo:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

Guarda el archivo y aprueba el inicio de sesión en zaDojo cuando Cursor te lo pida.

La guía de Cursor incluye un enlace de instalación con un clic y la instalación de las skills.

Codex CLI

El plugin de Codex añade la conexión y las skills a la vez. Si solo quieres la conexión:

codex mcp add zadojo --url https://app.zadojo.com/mcp

Aprueba el inicio de sesión en zaDojo cuando se abra. Si no se abre, ejecuta codex mcp login zadojo.

Codex en la app de escritorio de ChatGPT

El plugin de Codex incluye también las skills. Si solo quieres la conexión:

Abre Codex y ve a Settings > MCP servers > Add server.
Escribe el nombre zadojo, elige Streamable HTTP y pega https://app.zadojo.com/mcp.
Guarda y haz clic en Restart cuando Codex te lo pida.
Haz clic en Authenticate junto a zaDojo y aprueba el inicio de sesión.
Abre un chat nuevo de Codex y haz la comprobación de la conexión.

Esta conexión solo cubre Codex. ChatGPT en la web necesita la suya propia. La referencia de OpenAI es la documentación de MCP de Codex.

ChatGPT

Añade zaDojo como conexión MCP personalizada con OAuth. Funciona en ChatGPT Free y en los planes de pago, aunque los administradores de un espacio de trabajo pueden bloquear las conexiones personalizadas. La guía de ChatGPT recorre cada pantalla.

VS Code, Windsurf y Gemini CLI

Cada uno tiene su propia página con la configuración exacta, la configuración con clave de API y la instalación de las skills:

Otros clientes MCP

Cualquier cliente que pueda llegar a un servidor MCP remoto por streamable HTTP y admita el inicio de sesión con OAuth puede usar la dirección de arriba. Si el cliente no admite OAuth, envía una clave de API en una cabecera como se explica a continuación.

Cliente	Dónde añadirlo	Configuración
Zed	Settings > AI > MCP Servers > Add Remote Server	`"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Cline	MCP Servers > Remote Servers, o `cline mcp add zadojo https://app.zadojo.com/mcp --transport http`	`"type": "streamableHttp", "url": "https://app.zadojo.com/mcp"`
opencode	`opencode.json`	`"mcp": { "zadojo": { "type": "remote", "url": "https://app.zadojo.com/mcp" } }`
Goose	`goose configure` > Add Extension > Remote Extension (Streamable HTTP)	`type: streamable_http`, `uri: https://app.zadojo.com/mcp`
Kiro	`~/.kiro/settings/mcp.json`	`"mcpServers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Warp	Settings > Agents > MCP servers > Add > Streamable HTTP or SSE Server (URL)	`{ "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
JetBrains Junie	`~/.junie/mcp/mcp.json`, y luego `/mcp` > Authorize	`"zadojo": { "url": "https://app.zadojo.com/mcp" }`

Todos ellos abren el inicio de sesión de zaDojo en tu navegador la primera vez que se conectan.

Conectar con una clave de API

Una clave de API sustituye al inicio de sesión en el navegador. Úsala en pipelines de CI, servidores remotos, agentes como Hermes en los que el inicio de sesión no funciona, o cualquier cliente sin soporte para OAuth.

Una clave es personal. Todo lo que un agente haga con ella se ejecuta como tu cuenta en tu espacio de trabajo, así que guárdala como secreto y nunca la subas a un repositorio.

Para crear una, abre Settings en la app de zaDojo, busca API keys y haz clic en Create API key. Copia la clave en ese momento, porque zaDojo solo la muestra una vez. Las claves empiezan por zadojo_.

Claude Code:

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp --header "Authorization: Bearer zadojo_YOUR_KEY"

Cursor: añade un bloque headers a la entrada de zaDojo en mcp.json:

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp",
      "headers": {
        "Authorization": "Bearer zadojo_YOUR_KEY"
      }
    }
  }
}

Codex CLI: guarda la clave en una variable de entorno y apunta Codex a ella:

export ZADOJO_API_KEY=zadojo_YOUR_KEY
codex mcp add zadojo --url https://app.zadojo.com/mcp --bearer-token-env-var ZADOJO_API_KEY

Cualquier otro cliente: envía Authorization: Bearer zadojo_YOUR_KEY o x-api-key: zadojo_YOUR_KEY en cada petición.

Para revocar una clave, abre la misma sección API keys y elimínala.

Comprobar la conexión

Abre un chat o una sesión nueva y envía:

Use zaDojo to check my connection and list my projects.

El agente debería llamar a whoami y list_projects. Recibirás tu cuenta, tu saldo de créditos restante y tus proyectos, o una lista vacía si aún no tienes ninguno. Las dos herramientas son gratis. Si el agente te explica qué es MCP en lugar de llamar a una herramienta, el servidor no está cargado en esta sesión: recarga el cliente o empieza un chat nuevo.

Herramientas disponibles

El servidor tiene más de 80 herramientas. La tabla las agrupa por tarea. Los nombres de las herramientas son los que ve tu agente.

Área	Herramientas principales	Créditos
Cuenta y proyectos	`whoami`, `list_projects`, `create_project`, `get_project_context`, `update_project_context`	Gratis
Investigación de palabras clave	`research_keywords` (ideas a partir de 1 a 5 semillas), `get_keyword_metrics` (volumen, dificultad, intención, CPC y tendencias de hasta 700 palabras clave), `search_serp_locations`	De pago, salvo la búsqueda de ubicaciones
Resultados de Google	`get_serp_results` (resultados orgánicos en directo para 1 a 10 palabras clave), `find_serp_competitors`	De pago
Investigación de dominios	`get_domain_overview`, `get_ranked_keywords`, `get_domain_keyword_suggestions`	De pago
Backlinks	`get_backlinks_overview`, `get_backlinks_profile`	De pago
Palabras clave guardadas	`list_saved_keywords`, `save_keywords`, `remove_saved_keywords`	Gratis
Seguimiento de posiciones	`create_rank_tracker`, `add_rank_tracking_keywords`, `estimate_rank_tracker_cost`, `run_rank_tracker`, `get_rank_tracker`, `pin_rank_tracking_keywords`, `remove_rank_tracking_keywords`	Las comprobaciones son de pago; la configuración y las lecturas, gratis
Auditoría del sitio	`run_site_audit`, `get_audit_status`, `get_audit_issues`, `get_audit_pages`, `list_site_audits`, `delete_site_audit`	Gratis sin Lighthouse ni renderizado de JavaScript
SEO local	`search_local_businesses`, `get_local_serp_results` (Maps o Local Finder), `get_local_rank_grid`, `get_business_profile`, `get_business_reviews`, `get_business_updates`, `get_google_business_questions`, `list_business_categories`	De pago, salvo la búsqueda de categorías
Google Search Console	`get_search_console_performance`, `get_search_console_insights` (páginas con CTR bajo, consultas canibalizadas, subidas y caídas de clics), `get_search_console_hourly` (las últimas 48 horas), `get_search_console_sitemaps`, `inspect_urls` (hasta 10 URL por llamada)	Gratis
Google Analytics	`get_google_analytics_organic_overview`, `get_google_analytics_organic_landing_pages`, `get_google_analytics_page_performance`, `get_google_analytics_traffic_acquisition`, `get_google_analytics_key_events`, `get_google_analytics_ecommerce_performance`, `get_google_analytics_site_search`, `get_google_analytics_audience_breakdown`, `get_google_analytics_measurement_health`, `get_google_analytics_traffic_overview`, `get_google_analytics_breakdown`, `get_google_analytics_realtime_users`, `get_search_opportunities`	Gratis
Visibilidad en IA	`research_ai_visibility_prompts`, `explore_prompt`, `generate_ai_visibility_prompts`, `save_ai_visibility_tracker`, `estimate_ai_visibility_cost`, `set_ai_visibility_schedule`, `run_ai_visibility_check`	De pago
Resultados de visibilidad en IA	`get_ai_visibility_tracker`, `get_ai_visibility_run`, `get_ai_visibility_results`, `get_ai_visibility_answer`, `get_ai_visibility_sources`, `get_ai_visibility_trend`, `export_ai_visibility_data`	Gratis
Informes	`save_report`, `list_reports`, `get_report`, `delete_report`, `set_report_sharing`, `list_report_templates`, `save_report_template`, `delete_report_template`	Gratis

Algunos comportamientos que conviene conocer:

El contexto del proyecto es la memoria compartida de un proyecto: resumen del negocio, objetivo actual, posicionamiento, preferencias de redacción, competidores, páginas clave y un registro de investigación. Los agentes lo leen antes de empezar, y la app y los demás agentes ven las mismas entradas.
Los informes que guarda un agente aparecen en el proyecto para que todo tu equipo los lea, los imprima o los exporte. Los informes nuevos son privados. Solo se crea un enlace público cuando le pides al agente que llame a set_report_sharing con public: true, y public: false lo revoca. get_report devuelve report.shareUrl cuando existe un enlace público, o null cuando no.
Las herramientas de Search Console y Google Analytics leen la propiedad que ya está conectada al proyecto. El acceso es de solo lectura.
Primero la estimación en todo lo recurrente. El seguimiento de posiciones y el de IA tienen herramientas de estimación, así que el agente puede enseñarte el coste antes de programar comprobaciones.

Qué gasta créditos

Los créditos salen de tu saldo de zaDojo. 1.000 créditos equivalen a 1 €, y el plan de 10 € al mes incluye 10 € de uso. Precios habituales:

Acción	Coste habitual
Búsqueda de investigación de palabras clave	unos 0,07 €
Resumen de dominio o de backlinks con 12 meses de historial	unos 0,10 €
Comprobación local en Maps o Local Finder	unos 0,006 €
Una comprobación de un prompt de IA en un motor	unos 0,002 €
Prompt Research para una palabra clave	unos 0,25 €
Seguimiento semanal de 100 palabras clave en un dispositivo	entre 1 y 2 € al mes

Gratis: comprobaciones de la cuenta, contexto del proyecto, palabras clave guardadas, informes, Search Console, Google Analytics, auditorías básicas del sitio y la lectura de resultados de seguimiento de posiciones, auditorías o visibilidad en IA que ya hayas recogido. Los agentes conectados a zaDojo tienen instrucciones de preguntarte antes de un lote previsto de más de 2.000 créditos (unos 2 €). Cuando el saldo llega a cero, las herramientas de pago se detienen hasta que recargues. Consulta los precios para usar el estimador.

Después de conectar

La conexión le da datos a tu agente. Las skills le dicen qué hacer con esos datos, paso a paso. Si usaste MCP sin plugin, instala las skills a continuación.

Dale al agente una tarea concreta en lugar de pedirle que "haga SEO":

SEO Project Setup: guarda tu objetivo, posicionamiento, competidores y páginas clave para que cada tarea posterior parta de ahí.
SEO Coach: recibe un siguiente paso recomendado si eres nuevo en SEO.
SEO Audit: encuentra los pocos cambios con más probabilidades de hacer crecer el tráfico.
Keyword Research y Keyword Clustering: encuentra términos de búsqueda que merezca la pena atacar y agrúpalos en páginas.
Competitive Landscape y Competitor Analysis: mapea un mercado o estudia a fondo a un rival.
Link Prospecting: encuentra sitios que podrían enlazar a una página y redacta el outreach.
AI Prompt Research y AI Visibility Audit: descubre qué dicen las herramientas de IA sobre tu mercado y por qué mencionan a la competencia.

La guía de visibilidad en IA explica los motores, la cobertura y los costes del seguimiento de respuestas de IA.

Solución de problemas

El cliente no se conecta. Comprueba que la dirección es exactamente https://app.zadojo.com/mcp, con https:// y sin espacios al final.

Codex muestra Authorization server response missing required issuer: expected https://app.zadojo.com. Las versiones de Codex de la 0.143 a la 0.146 pierden el issuer durante OAuth. Actualiza Codex CLI o la app de escritorio de Codex a la 0.147.0 o posterior, o usa una clave de API.

El inicio de sesión falla o caduca una y otra vez. Quita el servidor de zaDojo de tu cliente, vuelve a añadirlo y repite el inicio de sesión.

El agente no encuentra un proyecto. Pídele que llame primero a list_projects y que reutilice el ID de proyecto devuelto en las llamadas siguientes. Si no tienes proyectos, pídele que cree uno para tu dominio con create_project, que es gratis.

Una herramienta de pago dice que no te quedan créditos. Con el plan de pago, compra una recarga desde la facturación de la app o espera a que se renueven tus créditos mensuales. En la prueba, suscríbete para seguir usando las herramientas de pago.

¿Sigues atascado? Escribe a hello@zadojo.com con el nombre y la versión de tu cliente y el error exacto. No incluyas nunca claves de API.