Agent IA : connecter zaDojo et ses skills

Un agent IA a besoin de deux éléments de zaDojo. La connexion MCP lui permet d'appeler les outils zaDojo pour obtenir des données SEO en direct sur https://app.zadojo.com/mcp. Les skills sont des fichiers SKILL.md qui lui expliquent comment mener une tâche, comme un audit ou une recherche de mots-clés, du début à la fin. Le plus rapide pour obtenir les deux est de coller le prompt de configuration ci-dessous dans votre agent et de le laisser faire l'installation.

Vous utilisez ChatGPT ? Consultez plutôt le guide ChatGPT. Une conversation ChatGPT classique ne peut rien installer, donc le prompt lui fait seulement afficher les étapes manuelles. La connexion personnalisée fonctionne avec ChatGPT Free comme avec les offres payantes.

Ce qu'il vous faut

• Un compte zaDojo. Inscrivez-vous pour recevoir 0,10 € de crédits d'essai sans carte bancaire, ou créez le compte quand la configuration ouvre la page de connexion.
• Un agent capable de se connecter à un serveur MCP distant : Claude Code, Claude Cowork, Codex (CLI ou application de bureau ChatGPT), Hermes, Grok Bot, Cursor et clients similaires.
• Un navigateur où approuver la connexion à zaDojo. Pour un agent sans navigateur, utilisez plutôt une clé API.

Configurer votre agent

1. Copiez le prompt ci-dessous. Vous pouvez aussi le copier depuis Agent setup dans l'application zaDojo, ou indiquer à votre agent la version texte sur https://zadojo.com/agent-setup.txt.
2. Collez-le dans une nouvelle conversation ou session de votre agent.
3. L'agent détermine de quel client il s'agit, cherche une connexion zaDojo existante et installe le plugin quand il en existe un. Sinon, il ajoute séparément le serveur MCP et les skills publiques.
4. Quand votre navigateur ouvre la page de connexion zaDojo, connectez-vous et approuvez l'accès.
5. Si l'agent vous demande de recharger, de redémarrer ou de cliquer sur quelque chose qu'il ne peut pas atteindre, faites-le. Il vous dit exactement quoi faire.

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.

L'agent termine par un court message d'état et quelques premières tâches suggérées. Il ne crée pas de projet et ne lance aucune recherche payante pendant la configuration.

Configuration manuelle par agent

Passez cette section si le prompt a déjà terminé l'installation. Chaque bloc ci-dessous fait la même chose à la main.

Claude Code

Dans une session Claude Code, ajoutez la marketplace et installez le plugin :

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

Lancez /reload-plugins si Claude Code vous demande d'activer le plugin. Approuvez la connexion à zaDojo, puis tapez /zadojo:seo-coach pour vérifier que les skills sont chargées. Le guide du plugin Claude Code couvre les portées, les mises à jour et les correctifs.

Claude Cowork

Dans Cowork, les plugins s'ajoutent via les menus, donc un agent ne peut pas faire cette partie à votre place. Allez dans Customize > Plugins > Add marketplace > Add from a repository, saisissez https://github.com/zadojo/seo-geo-mcp et installez zaDojo. Il faut une offre Claude payante. Les étapes Cowork expliquent l'alternative pour l'offre gratuite.

Codex dans l'application de bureau ChatGPT

1. Ouvrez Codex et lancez une nouvelle conversation.
2. Collez le prompt de configuration de cette page.
3. Approuvez la connexion à zaDojo quand elle apparaît.
4. Si Codex indique que les outils ne sont pas encore chargés, ouvrez une autre nouvelle conversation.

Pour installer à la main, suivez les étapes Codex pour ordinateur. Les offres ChatGPT qui incluent Codex sont fixées par OpenAI : consultez la page des offres d'OpenAI. Une connexion Codex est distincte de chatgpt.com : une conversation ChatGPT classique ne la voit pas.

Codex CLI

Depuis un terminal :

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

Si le plugin n'apparaît pas, rechargez ou redémarrez Codex. Connectez-vous ensuite :

codex mcp login zadojo

Demandez à Codex d'utiliser SEO Coach pour vérifier que tout fonctionne. Le guide du plugin Codex liste les messages d'erreur possibles. Si vous avez installé via un annuaire de plugins sur ordinateur, gérez le plugin depuis cet annuaire.

Hermes

Collez le prompt de configuration pour connecter le serveur MCP. Les skills viennent du hub de skills Hermes. Pour ajouter SEO Coach :

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

Lancez la même commande avec un autre nom de dossier pour chaque skill zaDojo supplémentaire, par exemple seo-audit ou keyword-research. Hermes note la provenance de chaque skill pour vérifier plus tard les mises à jour. Sa documentation se trouve dans Hermes skill management.

Grok Bot

Collez le prompt de configuration dans votre Bot et faites les étapes qu'il vous renvoie. Les skills et connecteurs packagés se trouvent sous Marketplace dans la barre latérale. Les skills privées sont sous Your plugins > Manage plugins and skills > Private skills, et tous les Bots de votre compte peuvent les utiliser. Voir Grok Bot skills pour la référence de xAI.

Claude sur le web et autres agents

Connectez le serveur avec le guide de configuration MCP. Ajoutez ensuite les skills avec le gestionnaire de skills de votre agent. Dans Claude, les skills personnalisées se gèrent sous Customize > Skills. Avec une offre Claude payante, le plugin zaDojo ajoute la connexion et les skills en une fois.

Les agents compatibles avec le CLI skills peuvent choisir les skills zaDojo dans une liste :

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

Choisissez votre agent et la portée d'installation que vous préférez. Ne lancez pas cette commande en plus du plugin, car le plugin fournit déjà les skills. Les autres méthodes sont décrites dans la configuration manuelle des skills.

Vérifier que tout fonctionne

Ouvrez une nouvelle conversation et envoyez :

Use zaDojo to check my connection and list my projects.

Une configuration qui marche appelle les outils zaDojo et renvoie votre compte et votre liste de projets. Une liste vide est aussi une réussite : vous n'avez simplement pas encore créé de projet. Cette vérification ne fait que lire des données et ne consomme aucun crédit.

Vérifiez ensuite les skills. Dans Claude Code, tapez /zadojo: et cherchez les douze noms de skills. Dans Codex, tapez $. Dans les autres agents, demandez « Quelles skills zaDojo vois-tu ? ». Une connexion qui marche sans aucune skill n'est configurée qu'à moitié.

Si les deux vérifications passent, demandez à votre agent de lancer SEO Coach. Il regarde où en est votre projet et recommande une prochaine étape.

Mettre à jour vos skills

Les skills s'améliorent avec le temps, et les copies présentes dans votre agent ne se mettent pas à jour toutes seules. Actualiser la connexion MCP met à jour la liste des outils, pas les fichiers de skills.

Les utilisateurs de ChatGPT doivent plutôt suivre les étapes de mise à jour ChatGPT. Une connexion ChatGPT personnalisée n'a pas de fichiers de skills à mettre à jour.

Le plus simple est de coller ce prompt dans l'agent où vous utilisez zaDojo. Il détermine comment les skills ont été installées, les met à jour au même endroit et conserve votre connexion ainsi que vos éventuelles modifications des fichiers de 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.

Voici les étapes de mise à jour manuelle pour chaque méthode d'installation.

Mettre à jour le plugin Claude Code

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

Pour ne plus le faire à la main, ouvrez /plugin, allez dans Marketplaces, sélectionnez zadojo et choisissez Enable auto-update. La mise à jour automatique est désactivée par défaut pour les marketplaces qui ne sont pas gérées par Anthropic. Quand Claude Code vous signale une mise à jour en attente, lancez /reload-plugins. Anthropic documente ce réglage dans configure auto-updates.

Mettre à jour le plugin Codex CLI

codex plugin marketplace upgrade zadojo

Redémarrez ou rechargez Codex si les nouvelles versions des skills n'apparaissent pas. Les commandes de plugin de Codex ont changé d'une version à l'autre : si celle-ci est refusée, lancez codex plugin --help pour voir ce qu'accepte votre version. OpenAI décrit les marketplaces dans sa documentation des plugins.

Mettre à jour les skills du hub Hermes

Demandez à Hermes quelles skills ont des mises à jour, puis mettez à jour celles de zaDojo par leur nom :

hermes skills check
hermes skills update seo-coach

Répétez la ligne de mise à jour pour chaque skill zaDojo installée. Si vous avez modifié une skill en local, Hermes n'y touche pas par défaut. Relisez d'abord vos modifications. N'ajoutez --force que si vous acceptez de les perdre. Les détails sont dans Hermes update lifecycle.

Mettre à jour les skills installées avec le CLI skills

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

Remplacez par les noms des skills que vous avez réellement installées. Utilisez la même portée qu'à l'installation : -g pour les skills globales ou -p pour les skills de projet. Sauvegardez vos modifications personnelles avant la mise à jour. Les nouvelles skills ajoutées depuis votre installation ne sont pas récupérées par update : relancez la commande d'installation pour les sélectionner. La documentation du CLI skills donne la liste complète des options.

Mettre à jour Grok Bot ou des skills copiées à la main

Pour Grok Bot, collez le prompt de mise à jour, ou ouvrez Marketplace > Your plugins > Manage plugins and skills et mettez à jour l'entrée zaDojo. xAI ne publie pas de commande de mise à jour distincte pour les skills, utilisez donc les contrôles de votre version.

Si vous avez copié des dossiers de skills à la main, comparez-les avec les dossiers de skills actuels. Remplacez chaque dossier en entier, y compris les fichiers à côté de SKILL.md, et reportez vos propres modifications. Les skills importées via Customize > Skills dans Claude se remplacent au même endroit.

Une fois terminé, rechargez les skills ou ouvrez une nouvelle session, puis demandez à l'agent de confirmer qu'il voit les skills zaDojo mises à jour.

Dépannage

Pour toute autre question, écrivez à hello@zadojo.com en indiquant le nom et la version de votre agent, l'étape qui a échoué et le texte exact de l'erreur. N'envoyez jamais de mot de passe, de clé API ni de code de connexion.

Ce qui consomme des crédits

La configuration, la connexion, la vérification et les mises à jour des skills ne coûtent rien. SEO Coach est gratuit aussi, sauf si vous lui demandez de lancer des recherches. Les crédits ne sont dépensés que lorsque votre agent récupère des données payantes, et 1 000 crédits valent 1 €. Quelques prix habituels :

• Une recherche de mots-clés : environ 0,07 €.
• Une vue d'ensemble de domaine ou de backlinks avec un an d'historique : environ 0,10 €.
• Prompt Research pour un mot-clé : environ 0,25 €.

Les lectures Search Console et Google Analytics, le contexte de projet, les mots-clés enregistrés, les rapports et les audits de site simples sont gratuits. L'abonnement coûte 10 € par mois et inclut 10 € d'utilisation chaque mois. Consultez les tarifs pour la liste complète et un estimateur de coûts.