Configure seu agente de IA com o zaDojo

Um agente de IA precisa de duas peças do zaDojo. A conexão MCP permite chamar as ferramentas do zaDojo para dados de SEO ao vivo em https://app.zadojo.com/mcp. As skills são arquivos SKILL.md que dizem como fazer uma tarefa, como uma auditoria ou uma pesquisa de palavras-chave, do começo ao fim. O jeito mais rápido de ter as duas é colar o prompt de configuração abaixo no seu agente e deixar ele fazer a instalação.

Usa o ChatGPT? Vá para o guia do ChatGPT. Um chat comum do ChatGPT não consegue instalar nada, então o prompt só faz ele mostrar os passos manuais. A conexão personalizada funciona no ChatGPT Free e nos planos pagos.

O que você precisa

• Uma conta no zaDojo. Cadastre-se para ganhar 0,10 € em créditos de teste, sem cartão, ou crie a conta quando o fluxo de configuração abrir a página de login.
• Um agente que se conecte a um servidor MCP remoto: Claude Code, Claude Cowork, Codex (CLI ou o app desktop do ChatGPT), Hermes, Grok Bot, Cursor e clientes parecidos.
• Um navegador onde você possa aprovar o login no zaDojo. Para um agente sem interface e sem navegador, use uma chave de API.

Configure seu agente

1. Copie o prompt abaixo. Você também pode copiar em Agent setup dentro do app do zaDojo, ou apontar o agente para a versão em texto simples em https://zadojo.com/agent-setup.txt.
2. Cole em um novo chat ou sessão do seu agente.
3. O agente descobre qual cliente ele é, verifica se já existe uma conexão com o zaDojo e instala o plugin onde houver um. Onde não houver plugin, ele adiciona o servidor MCP e as skills públicas separadamente.
4. Quando o navegador abrir o login do zaDojo, entre e aprove o acesso.
5. Se o agente pedir para recarregar, reiniciar ou clicar em algo que ele não alcança, faça esse passo. Ele diz exatamente o que fazer.

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.

O agente termina com uma mensagem curta de status e algumas sugestões de primeiras tarefas. Ele não cria projetos nem roda pesquisas pagas durante a configuração.

Configuração manual por agente

Pule esta seção se o prompt já concluiu a instalação. Cada bloco abaixo faz o mesmo trabalho à mão.

Claude Code

Dentro de uma sessão do Claude Code, adicione o marketplace e instale o plugin:

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

Rode /reload-plugins se o Claude Code pedir para ativar o plugin. Aprove o login no zaDojo e digite /zadojo:seo-coach para confirmar que as skills carregaram. O guia do plugin do Claude Code cobre escopos, atualizações e correções.

Claude Cowork

No Cowork, os plugins são adicionados por menus, então um agente não consegue fazer essa parte por você. Vá em Customize > Plugins > Add marketplace > Add from a repository, informe https://github.com/zadojo/seo-geo-mcp e instale o zaDojo. Isso exige um plano pago do Claude. Os passos do Cowork explicam a alternativa para o plano Free.

Codex no app desktop do ChatGPT

1. Abra o Codex e comece um novo chat.
2. Cole o prompt de configuração desta página.
3. Aprove o login no zaDojo quando ele aparecer.
4. Se o Codex disser que as ferramentas ainda não carregaram, comece outro chat novo.

Para instalar à mão, siga os passos do Codex desktop. Quais planos do ChatGPT incluem o Codex é decisão da OpenAI, então confira a página de planos da OpenAI. A conexão do Codex é separada do chatgpt.com: um chat comum do ChatGPT não vai enxergá-la.

Codex CLI

Em um terminal:

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

Se o plugin não aparecer, recarregue ou reinicie o Codex. Depois faça login:

codex mcp login zadojo

Peça ao Codex para usar o SEO Coach e checar se tudo funciona. O guia do plugin do Codex lista as mensagens de erro que você pode ver. Se instalou por um diretório de plugins do desktop, gerencie o plugin por esse diretório.

Hermes

Cole o prompt de configuração para conectar o servidor MCP. As skills vêm do hub de skills do Hermes. Para adicionar o SEO Coach:

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

Rode o mesmo comando com outro nome de pasta para cada skill do zaDojo extra que quiser, por exemplo seo-audit ou keyword-research. O Hermes registra de onde veio cada skill para poder checar atualizações depois. A documentação dele está em Hermes skill management.

Grok Bot

Cole o prompt de configuração no seu Bot e faça os passos que ele devolver para você. Skills e conectores empacotados ficam em Marketplace na barra lateral. Skills privadas ficam em Your plugins > Manage plugins and skills > Private skills, e todo Bot da sua conta pode usá-las. Veja Grok Bot skills para a referência da xAI.

Claude web e outros agentes

Conecte o servidor com o guia de configuração do MCP. Depois adicione as skills com o gerenciador de skills que o seu agente suportar. No Claude, skills personalizadas ficam em Customize > Skills. Em um plano pago do Claude, o plugin do zaDojo adiciona a conexão e as skills juntas.

Agentes que funcionam com o CLI skills podem escolher as skills do zaDojo em uma lista:

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

Escolha seu agente atual e o escopo de instalação que preferir. Não rode isto por cima do plugin, porque o plugin já traz as skills. Outros caminhos estão em configuração manual de skills.

Confira se funcionou

Comece um novo chat e envie:

Use o zaDojo para verificar minha conexão e listar meus projetos.

Uma configuração funcionando chama as ferramentas do zaDojo e retorna sua conta e a lista de projetos. Uma lista vazia também passa: significa que você ainda não criou um projeto. Essa verificação só lê dados e não usa créditos.

Depois confira as skills. No Claude Code, digite /zadojo: e procure os doze nomes de skill. No Codex, digite $. Em outros agentes, pergunte "Quais skills do zaDojo você consegue ver?". Uma conexão que funciona sem nenhuma skill está só pela metade.

Se as duas verificações passarem, peça ao agente para rodar o SEO Coach. Ele vê em que ponto está seu projeto e recomenda um próximo passo.

Atualize suas skills

As skills melhoram com o tempo, e as cópias dentro do seu agente não se atualizam sozinhas. Atualizar a conexão MCP atualiza a lista de ferramentas, não os arquivos das skills.

Quem usa o ChatGPT deve seguir os passos de atualização do ChatGPT. Uma conexão personalizada do ChatGPT não tem arquivos de skill para atualizar.

O caminho mais fácil é colar este prompt no agente onde você usa o zaDojo. Ele descobre como as skills foram instaladas, atualiza no mesmo lugar e mantém seu login e qualquer edição que você tenha feito nos arquivos das 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 seguir estão os passos manuais de atualização para cada método de instalação.

Atualize o plugin do Claude Code

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

Para parar de fazer isso à mão, abra /plugin, vá em Marketplaces, selecione zadojo e escolha Enable auto-update. A atualização automática vem desligada para marketplaces que não são da Anthropic. Quando o Claude Code avisar que há uma atualização esperando, rode /reload-plugins. A Anthropic documenta a opção em configure auto-updates.

Atualize o plugin do Codex CLI

codex plugin marketplace upgrade zadojo

Reinicie ou recarregue o Codex se as novas versões das skills não aparecerem. Os comandos de plugin do Codex mudaram entre versões, então se este for rejeitado, rode codex plugin --help para ver o que a sua versão aceita. A OpenAI descreve os marketplaces na documentação de plugins.

Atualize skills do hub do Hermes

Pergunte ao Hermes quais skills têm atualizações e atualize as do zaDojo pelo nome:

hermes skills check
hermes skills update seo-coach

Repita a linha de atualização para cada skill do zaDojo que você instalou. Se você editou uma skill localmente, o Hermes não mexe nela por padrão. Revise suas edições primeiro. Use --force só quando não se importar em perdê-las. Detalhes em Hermes update lifecycle.

Atualize skills instaladas com o CLI de skills

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

Troque pelos nomes das skills que você realmente instalou. Use o mesmo escopo da instalação: -g para skills globais ou -p para skills de projeto. Salve uma cópia de qualquer edição pessoal antes de atualizar. Skills novas adicionadas depois da sua instalação não entram pelo update, então rode o comando de instalação de novo para selecioná-las. A documentação do CLI de skills tem a lista completa de opções.

Atualize o Grok Bot ou skills copiadas à mão

No Grok Bot, cole o prompt de atualização, ou abra Marketplace > Your plugins > Manage plugins and skills e atualize a entrada do zaDojo por lá. A xAI não publica um comando de atualização separado para skills, então use os controles que a sua versão mostra.

Se você copiou as pastas das skills à mão, compare com as pastas atuais das skills. Substitua cada pasta inteira, incluindo os arquivos ao lado do SKILL.md, e leve junto suas próprias edições. Skills enviadas pelo Customize > Skills do Claude são substituídas no mesmo lugar.

Ao terminar, recarregue as skills ou abra uma nova sessão e peça ao agente para confirmar que ele vê as skills atualizadas do zaDojo.

Solução de problemas

Para qualquer outra coisa, mande um e-mail para hello@zadojo.com com o nome e a versão do seu agente, o passo que falhou e o texto exato do erro. Nunca envie senhas, chaves de API ou códigos de login.

O que usa créditos

Configuração, login, verificação da conexão e atualização das skills não custam nada. O SEO Coach também é grátis, a menos que você peça para ele rodar uma pesquisa. Os créditos só são gastos quando o agente busca dados pagos, e 1.000 créditos equivalem a 1 €. Alguns preços típicos:

• Uma busca de palavras-chave: cerca de 0,07 €.
• Uma visão geral de domínio ou de backlinks com um ano de histórico: cerca de 0,10 €.
• Prompt Research para uma palavra-chave: cerca de 0,25 €.

Leituras do Search Console e do Google Analytics, contexto do projeto, palavras-chave salvas, relatórios e auditorias de site simples são grátis. O plano custa 10 € por mês e inclui 10 € de uso todo mês. Veja a lista completa e um estimador de custos em preços.