Configura tu agente de IA con zaDojo

Un agente de IA necesita dos piezas de zaDojo. La conexión MCP le permite llamar a las herramientas de zaDojo para obtener datos de SEO en directo en https://app.zadojo.com/mcp. Las skills son archivos SKILL.md que le explican cómo hacer una tarea de principio a fin, como una auditoría o una investigación de palabras clave. La forma más rápida de tener las dos es pegar el prompt de configuración de abajo en tu agente y dejar que haga la instalación.

¿Usas ChatGPT? Ve a la guía de ChatGPT. Un chat normal de ChatGPT no puede instalar nada, así que el prompt solo le haría mostrar los pasos manuales. La conexión personalizada funciona tanto en ChatGPT Free como en los planes de pago.

Qué necesitas

• Una cuenta de zaDojo. Regístrate y recibe 0,10 € de créditos de prueba sin tarjeta, o crea la cuenta cuando el proceso de configuración abra la página de inicio de sesión.
• Un agente que pueda conectarse a un servidor MCP remoto: Claude Code, Claude Cowork, Codex (CLI o la app de escritorio de ChatGPT), Hermes, Grok Bot, Cursor y clientes similares.
• Un navegador en el que puedas aprobar el inicio de sesión en zaDojo. Para un agente sin interfaz ni navegador, usa una clave de API.

Configurar tu agente

1. Copia el prompt de abajo. También puedes copiarlo desde Agent setup dentro de la app de zaDojo, o indicar a tu agente la versión en texto plano en https://zadojo.com/agent-setup.txt.
2. Pégalo en un chat o una sesión nueva de tu agente.
3. El agente averigua qué cliente es, comprueba si ya existe una conexión con zaDojo e instala el plugin donde lo hay. Donde no hay plugin, añade el servidor MCP y las skills públicas por separado.
4. Cuando tu navegador abra el inicio de sesión de zaDojo, entra y aprueba el acceso.
5. Si el agente te pide recargar, reiniciar o hacer clic en algo a lo que no llega, haz ese paso. Te dice exactamente qué hacer.

Set up zaDojo in this agent. Do what you can; guide me through anything that needs my input.

## 1. Check this agent

- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing zaDojo connection. Preserve other integrations and avoid duplicates.
- Check for zaDojo skills separately. A connection without skills is incomplete.

## 2. If this is ChatGPT

If I pasted this into a regular ChatGPT conversation (web or desktop app, not Codex), you cannot install zaDojo from here. Don't run commands or edit files. Instead, give me these steps and stop:

1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. This works on Free and paid plans; no upgrade is needed.
2. Open **Settings → Plugins → Developer mode** (or **Plugins → + → Create MCP App**). Name it zaDojo, enter the server URL `https://app.zadojo.com/mcp` in full, including `https://` (otherwise ChatGPT reports "Unsafe URL"), and keep **OAuth** selected.
3. Create it, sign in to zaDojo, and approve the connection.
4. Start a new chat, select zaDojo from the **+** menu, and send: "Use zaDojo to check my connection and list my projects."

Link the [ChatGPT setup guide](https://zadojo.com/docs/chatgpt) for screenshots and troubleshooting. If I'm in Codex, continue below.

## 3. Install the plugin first

The official plugin bundles MCP + SEO skills, with zaDojo namespacing and shared updates.

- **Codex:** follow the [plugin guide](https://zadojo.com/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://zadojo.com/docs/claude-code-plugin).
- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/zadojo/seo-geo-mcp`, and install **zaDojo**. Then I start a new task and type `/` to check that zaDojo skills appear. If I already have a custom zaDojo connector, have me remove it once the plugin signs in. Plugins need a paid Claude plan. If I'm on Claude Free, have me add `https://app.zadojo.com/mcp` under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://zadojo.com/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.

## 4. Fall back to MCP + skills

If the plugin is unsupported:

- Add `https://app.zadojo.com/mcp` using the [MCP guide](https://zadojo.com/docs/mcp).
- Install the [public SEO skills](https://zadojo.com/docs/skills/setup) for this agent only.
- Do not copy internal repository skills or duplicate bundled skills.
- If skills are unsupported, use MCP alone and link to the workflow guides.

## 5. Sign in

- Prefer OAuth and let me approve login in my browser. If this client cannot use OAuth, send me to `https://app.zadojo.com/settings` → API keys. Have me enter the key in the client's secret settings or environment, never chat or a repository.
- **Manual setup needed?** Use this agent’s current documentation and give only the steps I need to do myself.

## 6. Reload and verify

- Use the current agent’s native reload flow, checking its installed version, help, or official documentation. Prefer automatic discovery or an in-place reload; restart only if required to load the new tools and skills.
- Once tools load in this session, run whoami and list_projects (free reads). Check skill discovery too. If a reload needs my action, give the instructions rather than repeatedly retrying unavailable tools.
- Track installation, sign-in, and verification separately. A connected server is not proof that this session can use its tools. Never claim verification before the free reads succeed.
- Do not create projects or run paid research during installation.

## 7. Finish with a short handoff

Keep progress updates brief. The final reply must be **140 words or fewer** and follow this template:

**Status**
[Briefly say what succeeded or what blocked setup.]

**Next**

1. `[Give the native reload command or UI action for this agent, only if needed.]` Then say “Check that zaDojo is connected.” Approve sign-in if prompted.
2. Try one of these:
   - `[SEO Audit invocation]` **(recommended)**: find your website's biggest SEO issues.
   - `[SEO Project Setup invocation]`: interview you about your website and set up its project context.
   - `[Keyword Research invocation]`: find keywords worth targeting.
   - `[Local SEO invocation]`: review your Google Business Profile and local competitors.

Want to know what was set up? Just ask.

Adapt the template to the actual result:

- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.

El agente termina con un breve mensaje de estado y algunas primeras tareas sugeridas. No crea proyectos ni lanza investigaciones de pago durante la configuración.

Configuración manual por agente

Sáltate esta sección si el prompt ya terminó la instalación. Cada bloque de abajo hace lo mismo a mano.

Claude Code

Dentro de una sesión de Claude Code, añade el marketplace e instala el plugin:

/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojo

Ejecuta /reload-plugins si Claude Code te pide activar el plugin. Aprueba el inicio de sesión en zaDojo y escribe /zadojo:seo-coach para confirmar que se cargaron las skills. La guía del plugin de Claude Code explica los ámbitos, las actualizaciones y las soluciones.

Claude Cowork

En Cowork los plugins se añaden desde menús, así que un agente no puede hacer esta parte por ti. Ve a Customize > Plugins > Add marketplace > Add from a repository, introduce https://github.com/zadojo/seo-geo-mcp e instala zaDojo. Necesitas un plan de pago de Claude. Los pasos para Cowork explican la alternativa para el plan Free.

Codex en la app de escritorio de ChatGPT

1. Abre Codex y empieza un chat nuevo.
2. Pega el prompt de configuración de esta página.
3. Aprueba el inicio de sesión en zaDojo cuando aparezca.
4. Si Codex dice que las herramientas aún no están cargadas, empieza otro chat nuevo.

Para instalarlo a mano, sigue los pasos para Codex de escritorio. Qué planes de ChatGPT incluyen Codex lo decide OpenAI, así que consulta la página de planes de OpenAI. Una conexión de Codex es independiente de chatgpt.com: un chat normal de ChatGPT no la verá.

Codex CLI

Desde una terminal:

codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojo

Si el plugin no aparece, recarga o reinicia Codex. Después inicia sesión:

codex mcp login zadojo

Pide a Codex que use SEO Coach para comprobar que todo funciona. La guía del plugin de Codex muestra los mensajes de error que podrías ver. Si lo instalaste desde un directorio de plugins de escritorio, gestiona el plugin desde ese directorio.

Hermes

Pega el prompt de configuración para conectar el servidor MCP. Las skills vienen del hub de skills de Hermes. Para añadir SEO Coach:

hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coach

Ejecuta el mismo comando con otro nombre de carpeta para cada skill de zaDojo adicional que quieras, por ejemplo seo-audit o keyword-research. Hermes registra de dónde viene cada skill para poder buscar actualizaciones más adelante. Su propia documentación está en Hermes skill management.

Grok Bot

Pega el prompt de configuración en tu Bot y haz los pasos que te devuelva. Las skills empaquetadas y los conectores están en Marketplace, en la barra lateral. Las skills privadas están en Your plugins > Manage plugins and skills > Private skills, y todos los Bots de tu cuenta pueden usarlas. Consulta Grok Bot skills para ver la referencia de xAI.

Claude web y otros agentes

Conecta el servidor con la guía de configuración de MCP. Después añade las skills con el gestor de skills que admita tu agente. En Claude, las skills personalizadas se gestionan en Customize > Skills. Con un plan de pago de Claude, el plugin de zaDojo añade la conexión y las skills a la vez.

Los agentes que funcionan con la CLI skills pueden elegir las skills de zaDojo de una lista:

npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills

Elige tu agente actual y el ámbito de instalación que prefieras. No lo ejecutes encima del plugin, porque el plugin ya incluye las skills. Las demás vías se explican en la configuración manual de skills.

Comprobar que ha funcionado

Empieza un chat nuevo y envía:

Use zaDojo to check my connection and list my projects.

Una configuración que funciona llama a las herramientas de zaDojo y devuelve tu cuenta y tu lista de proyectos. Una lista vacía también es un aprobado: significa que aún no has creado ningún proyecto. Esta comprobación solo lee datos y no gasta créditos.

Después comprueba las skills. En Claude Code, escribe /zadojo: y busca los doce nombres de skills. En Codex, escribe $. En otros agentes, pregunta "Which zaDojo skills can you see?". Una conexión que funciona sin ninguna skill está configurada solo a medias.

Si pasan las dos comprobaciones, pide a tu agente que ejecute SEO Coach. Revisa en qué punto está tu proyecto y recomienda un siguiente paso.

Actualizar tus skills

Las skills mejoran con el tiempo, y las copias que tiene tu agente no se actualizan solas. Refrescar la conexión MCP actualiza la lista de herramientas, no los archivos de las skills.

Si usas ChatGPT, sigue los pasos de actualización de ChatGPT. Una conexión personalizada de ChatGPT no tiene archivos de skills que actualizar.

La vía más sencilla es pegar este prompt en el agente donde usas zaDojo. Averigua cómo se instalaron las skills, las actualiza en el mismo sitio y conserva tu inicio de sesión y los cambios que hayas hecho en los archivos de las skills.

Update my installed zaDojo skills using https://zadojo.com/docs/agent-setup#update-your-skills.

If this is ChatGPT on the web or a regular desktop chat, use https://zadojo.com/docs/chatgpt#update-zadojo. For a public directory plugin, start a new chat to load the available tools and skills; reconnect only if sign-in needs attention. For a custom MCP connection, select Refresh in its details, then start a new chat. Refreshing a custom connection updates tools, not skill files. Do not run local Codex commands to update ChatGPT web.

Identify this agent and how zaDojo was installed. Use the matching plugin or skills installer, checking the installed client's help before running commands. Update only zaDojo in its existing scope. Preserve my MCP endpoint, sign-in, and personal skill edits; ask before replacing conflicting edits. Avoid duplicate skills and do not install internal repository skills.

If the skills were copied manually, compare them with https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills and update the installed public skill folders, including their supporting files. For Grok Bot or another agent without a verified update command, use its supported skill management flow or give me the exact manual steps available in this version.

Reload skills if supported. If I need to reload or start a new session, tell me what to do. Verify the updated skill files and that this agent can discover them; an active MCP connection alone does not prove the skills updated. Briefly tell me what changed and anything left to do. Do not run SEO research during the update.

A continuación tienes los pasos de actualización manual para cada método de instalación.

Actualizar el plugin de Claude Code

/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-plugins

Para dejar de hacerlo a mano, abre /plugin, ve a Marketplaces, selecciona zadojo y elige Enable auto-update. La actualización automática viene desactivada en los marketplaces que no gestiona Anthropic. Cuando Claude Code te avise de que hay una actualización pendiente, ejecuta /reload-plugins. Anthropic documenta este ajuste en configure auto-updates.

Actualizar el plugin de Codex CLI

codex plugin marketplace upgrade zadojo

Reinicia o recarga Codex si no aparecen las nuevas versiones de las skills. Los comandos de plugins de Codex han cambiado entre versiones, así que si este se rechaza, ejecuta codex plugin --help para ver qué acepta tu versión. OpenAI describe los marketplaces en su documentación de plugins.

Actualizar skills del hub de Hermes

Pregunta a Hermes qué skills tienen actualizaciones y actualiza las de zaDojo por su nombre:

hermes skills check
hermes skills update seo-coach

Repite la línea de actualización para cada skill de zaDojo que instalaste. Si editaste una skill en local, Hermes no la toca por defecto. Revisa antes tus cambios. Añade --force solo si no te importa perderlos. Tienes los detalles en el ciclo de actualización de Hermes.

Actualizar skills instaladas con la CLI de skills

npx skills list
npx skills update seo-coach seo-audit

Pon los nombres de las skills que instalaste de verdad. Usa el mismo ámbito en el que las instalaste: -g para skills globales o -p para skills de proyecto. Guarda una copia de tus cambios personales antes de actualizar. update no recoge las skills nuevas añadidas desde tu instalación, así que vuelve a ejecutar el comando de instalación para seleccionarlas. La documentación de la CLI de skills tiene la lista completa de opciones.

Actualizar Grok Bot o skills copiadas a mano

En Grok Bot, pega el prompt de actualización, o abre Marketplace > Your plugins > Manage plugins and skills y actualiza ahí la entrada de zaDojo. xAI no publica un comando de actualización aparte para las skills, así que usa los controles que muestre tu versión.

Si copiaste las carpetas de las skills a mano, compáralas con las carpetas actuales de las skills. Sustituye cada carpeta completa, incluidos los archivos que acompañan a SKILL.md, y trasládales tus propios cambios. Las skills subidas en Customize > Skills de Claude se sustituyen en el mismo sitio.

Cuando termines, recarga las skills o abre una sesión nueva y pide al agente que confirme que ve las skills de zaDojo actualizadas.

Solución de problemas

Para cualquier otra cosa, escribe a hello@zadojo.com con el nombre y la versión de tu agente, el paso que falló y el texto exacto del error. No envíes nunca contraseñas, claves de API ni códigos de inicio de sesión.

Qué gasta créditos

La configuración, el inicio de sesión, la comprobación de la conexión y las actualizaciones de skills no cuestan nada. SEO Coach también es gratis, salvo que le pidas que investigue. Los créditos solo se gastan cuando tu agente consulta datos de pago, y 1.000 créditos equivalen a 1 €. Algunos precios habituales:

• Una búsqueda de investigación de palabras clave: unos 0,07 €.
• Un resumen de dominio o de backlinks con un año de historial: unos 0,10 €.
• Prompt Research para una palabra clave: unos 0,25 €.

Las lecturas de Search Console y Google Analytics, el contexto del proyecto, las palabras clave guardadas, los informes y las auditorías básicas del sitio son gratis. El plan cuesta 10 € al mes e incluye 10 € de uso cada mes. Consulta los precios para ver la lista completa y un estimador de costes.