Serveur MCP zaDojo : Claude, Cursor, Codex

zaDojo propose un serveur MCP distant auquel peut se connecter tout client compatible avec le MCP distant. MCP (Model Context Protocol) est la méthode standard qui permet aux applications d'IA d'appeler des outils externes. Grâce à lui, votre agent peut rechercher des mots-clés, lire les résultats Google en direct, consulter les positions et les backlinks de n'importe quel domaine, lancer des audits de site, suivre les positions et les réponses des IA, et lire vos propres données Search Console et Google Analytics.

L'adresse du serveur :

https://app.zadojo.com/mcp

Lors de la première connexion, le client ouvre une page de connexion zaDojo dans votre navigateur et vous demande d'autoriser l'accès. Ensuite, il peut utiliser les outils sur les projets auxquels vous avez accès. Pour les tâches de CI et les serveurs sans navigateur, utilisez une clé API.

Les utilisateurs de Claude Code et de Codex ont intérêt à choisir le plugin, qui ajoute cette connexion et les douze skills zaDojo en une seule installation. Suivez les étapes de cette page si vous voulez seulement la connexion MCP, ou si votre client n'a pas de plugin. Le guide de configuration de l'agent propose un prompt qui choisit la bonne méthode pour vous.

Ce qu'il vous faut

Un compte zaDojo. Inscrivez-vous pour recevoir 0,10 € de crédits d'essai, sans carte bancaire.
Un client compatible avec les serveurs MCP distants en HTTP : Claude Code, Claude Desktop, Cursor, Codex CLI, Codex dans l'application de bureau ChatGPT, ChatGPT avec une connexion personnalisée, VS Code avec Copilot, Windsurf (Devin Desktop), Gemini CLI, Zed ou équivalent.
Un navigateur pour la connexion, ou une clé API pour un usage sans interface.

La page Agent setup de l'application affiche la même adresse avec un bouton de copie. Envie de tester les données zaDojo avant de vous inscrire ? Les outils SEO gratuits ne demandent pas de compte.

Connecter votre client

Claude Code

Le plugin Claude Code est le meilleur choix pour la plupart des gens. Pour la connexion seule, lancez ceci dans un terminal :

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

--scope user rend zaDojo disponible dans tous les projets de votre machine. Utilisez --scope local pour le limiter au dépôt courant. Claude Code vous demande ensuite de vous connecter à zaDojo. Si la demande n'apparaît pas, lancez /mcp, sélectionnez zaDojo et terminez la connexion depuis là.

Claude Desktop

Avec un abonnement Claude payant, le plugin zaDojo ajoute la connexion et les skills en même temps. Avec l'offre Free, ou pour la connexion seule, ajoutez un connecteur personnalisé :

Ouvrez Customize > Connectors.
Cliquez sur Add ou + et choisissez Add custom connector.
Collez https://app.zadojo.com/mcp.
Connectez-vous à zaDojo et autorisez l'accès.

Les connecteurs personnalisés fonctionnent avec Claude Free, Pro, Max, Team et Enterprise. L'offre Free autorise un seul connecteur personnalisé.

Cursor

Ouvrez Customize et allez dans les serveurs MCP, ou modifiez directement ~/.cursor/mcp.json.
Ajoutez l'entrée zaDojo :

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

Enregistrez le fichier et approuvez la connexion à zaDojo quand Cursor le demande.

Le guide Cursor propose un lien d'installation en un clic et l'installation des skills.

Codex CLI

Le plugin Codex ajoute la connexion et les skills en même temps. Pour la connexion seule :

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

Approuvez la connexion à zaDojo quand elle s'ouvre. Si elle ne s'ouvre pas, lancez codex mcp login zadojo.

Codex dans l'application de bureau ChatGPT

Le plugin Codex inclut aussi les skills. Pour la connexion seule :

Ouvrez Codex, puis allez dans Settings > MCP servers > Add server.
Saisissez le nom zadojo, choisissez Streamable HTTP et collez https://app.zadojo.com/mcp.
Enregistrez, puis cliquez sur Restart quand Codex le demande.
Cliquez sur Authenticate à côté de zaDojo et approuvez la connexion.
Ouvrez un nouveau chat Codex et lancez la vérification de la connexion.

Cette connexion ne concerne que Codex. ChatGPT sur le web a besoin de la sienne. La référence d'OpenAI est la documentation MCP de Codex.

ChatGPT

Ajoutez zaDojo comme connexion MCP personnalisée avec OAuth. Cela fonctionne avec ChatGPT Free et les offres payantes, même si les administrateurs d'un espace de travail peuvent bloquer les connexions personnalisées. Le guide ChatGPT détaille chaque écran.

VS Code, Windsurf et Gemini CLI

Chacun a sa propre page avec la configuration exacte, la configuration par clé API et l'installation des skills :

Autres clients MCP

Tout client capable de joindre un serveur MCP distant en streamable HTTP et compatible avec la connexion OAuth peut utiliser l'adresse ci-dessus. Si le client ne gère pas OAuth, envoyez une clé API dans un en-tête, comme expliqué plus bas.

Client	Où l'ajouter	Configuration
Zed	Settings > AI > MCP Servers > Add Remote Server	`"context_servers": { "zadojo": { "url": "https://app.zadojo.com/mcp" } }`
Cline	MCP Servers > Remote Servers, ou `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`, puis `/mcp` > Authorize	`"zadojo": { "url": "https://app.zadojo.com/mcp" }`

Tous ouvrent la page de connexion zaDojo dans votre navigateur lors de la première connexion.

Se connecter avec une clé API

Une clé API remplace la connexion par navigateur. Utilisez-en une pour les pipelines de CI, les serveurs distants, les agents comme Hermes où le processus de connexion ne fonctionne pas, ou tout client sans prise en charge d'OAuth.

Une clé vous appartient personnellement. Tout ce qu'un agent fait avec elle s'exécute sous votre compte, dans votre espace de travail : stockez-la comme un secret et ne la commitez jamais dans un dépôt.

Pour en créer une, ouvrez Settings dans l'application zaDojo, trouvez API keys et cliquez sur Create API key. Copiez la clé immédiatement, car zaDojo ne l'affiche qu'une fois. Les clés commencent par zadojo_.

Claude Code :

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

Cursor : ajoutez un bloc headers à l'entrée zaDojo de mcp.json :

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

Codex CLI : gardez la clé dans une variable d'environnement et indiquez-la à Codex :

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

Tout autre client : envoyez Authorization: Bearer zadojo_YOUR_KEY ou x-api-key: zadojo_YOUR_KEY avec chaque requête.

Pour révoquer une clé, ouvrez la même section API keys et supprimez-la.

Vérifier la connexion

Ouvrez un nouveau chat ou une nouvelle session et envoyez :

Use zaDojo to check my connection and list my projects.

L'agent doit appeler whoami et list_projects. Vous obtenez votre compte, votre solde de crédits restant et vos projets, ou une liste vide si vous n'en avez pas encore. Les deux outils sont gratuits. Si l'agent décrit MCP au lieu d'appeler un outil, le serveur n'est pas chargé dans cette session : rechargez le client ou démarrez un nouveau chat.

Outils disponibles

Le serveur compte plus de 80 outils. Le tableau les regroupe par tâche. Les noms d'outils sont ceux que voit votre agent.

Domaine	Principaux outils	Crédits
Compte et projets	`whoami`, `list_projects`, `create_project`, `get_project_context`, `update_project_context`	Gratuit
Recherche de mots-clés	`research_keywords` (idées à partir de 1 à 5 mots-clés de départ), `get_keyword_metrics` (volume, difficulté, intention, CPC et tendances pour 700 mots-clés au maximum), `search_serp_locations`	Payant, sauf la recherche de lieux
Résultats Google	`get_serp_results` (résultats organiques en direct pour 1 à 10 mots-clés), `find_serp_competitors`	Payant
Recherche de domaines	`get_domain_overview`, `get_ranked_keywords`, `get_domain_keyword_suggestions`	Payant
Backlinks	`get_backlinks_overview`, `get_backlinks_profile`	Payant
Mots-clés enregistrés	`list_saved_keywords`, `save_keywords`, `remove_saved_keywords`	Gratuit
Suivi de positions	`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`	Vérifications payantes, configuration et lecture gratuites
Audit de site	`run_site_audit`, `get_audit_status`, `get_audit_issues`, `get_audit_pages`, `list_site_audits`, `delete_site_audit`	Gratuit sans Lighthouse ni rendu JavaScript
SEO local	`search_local_businesses`, `get_local_serp_results` (Maps ou Local Finder), `get_local_rank_grid`, `get_business_profile`, `get_business_reviews`, `get_business_updates`, `get_google_business_questions`, `list_business_categories`	Payant, sauf la recherche de catégories
Google Search Console	`get_search_console_performance`, `get_search_console_insights` (pages à faible CTR, requêtes cannibalisées, hausses et baisses de clics), `get_search_console_hourly` (les 48 dernières heures), `get_search_console_sitemaps`, `inspect_urls` (10 URL maximum par appel)	Gratuit
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`	Gratuit
Visibilité 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`	Payant
Résultats de visibilité 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`	Gratuit
Rapports	`save_report`, `list_reports`, `get_report`, `delete_report`, `set_report_sharing`, `list_report_templates`, `save_report_template`, `delete_report_template`	Gratuit

Quelques comportements à connaître :

Le contexte du projet est une mémoire partagée par projet : présentation de l'activité, objectif actuel, positionnement, préférences rédactionnelles, concurrents, pages clés et journal de recherche. Les agents le lisent avant de commencer, et l'application comme les autres agents voient les mêmes entrées.
Les rapports enregistrés par un agent apparaissent dans le projet, pour que toute votre équipe puisse les lire, les imprimer ou les exporter. Les nouveaux rapports sont privés. Un lien public n'est créé que si vous demandez à l'agent d'appeler set_report_sharing avec public: true, et public: false le révoque. get_report renvoie report.shareUrl quand un lien public existe, ou null sinon.
Les outils Search Console et Google Analytics lisent la propriété déjà connectée au projet. L'accès est en lecture seule.
L'estimation passe en premier pour tout ce qui est récurrent. Le suivi de positions et le suivi IA ont tous deux des outils d'estimation, pour que l'agent vous montre le coût avant de planifier des vérifications.

Ce qui consomme des crédits

Les crédits sont prélevés sur votre solde zaDojo. 1 000 crédits valent 1 €, et l'abonnement à 10 € par mois inclut 10 € d'utilisation. Prix habituels :

Action	Coût habituel
Recherche de mots-clés	environ 0,07 €
Vue d'ensemble d'un domaine ou de ses backlinks avec 12 mois d'historique	environ 0,10 €
Vérification Local Maps ou Local Finder	environ 0,006 €
Une vérification de prompt IA sur un moteur	environ 0,002 €
Prompt Research pour un mot-clé	environ 0,25 €
Suivi hebdomadaire de 100 mots-clés sur un appareil	environ 1 à 2 € par mois

Gratuit : vérification du compte, contexte du projet, mots-clés enregistrés, rapports, Search Console, Google Analytics, audits de site simples, et lecture des résultats de suivi de positions, d'audit ou de visibilité IA déjà collectés. Les agents connectés à zaDojo ont pour consigne de vous demander votre accord avant un lot prévu de plus de 2 000 crédits (environ 2 €). Quand le solde tombe à zéro, les outils payants s'arrêtent jusqu'à votre prochaine recharge. Consultez les tarifs pour le simulateur.

Après la connexion

La connexion donne des données à votre agent. Les skills lui disent quoi en faire, étape par étape. Si vous avez utilisé MCP sans plugin, installez les skills ensuite.

Confiez à l'agent une tâche précise plutôt que de lui demander de « faire du SEO » :

SEO Project Setup : enregistrer votre objectif, positionnement, concurrents et pages clés pour que chaque tâche suivante en parte.
SEO Coach : obtenir une prochaine étape recommandée si vous débutez en SEO.
SEO Audit : trouver les quelques changements les plus susceptibles d'augmenter le trafic.
Keyword Research et Keyword Clustering : trouver les termes de recherche à cibler et les regrouper en pages.
Competitive Landscape et Competitor Analysis : cartographier un marché ou étudier un concurrent en profondeur.
Link Prospecting : trouver des sites susceptibles de faire un lien vers une page et rédiger les messages d'approche.
AI Prompt Research et AI Visibility Audit : voir ce que les outils d'IA disent de votre marché et pourquoi vos concurrents sont mentionnés.

Le guide de la visibilité IA couvre les moteurs, la couverture et les coûts du suivi des réponses des IA.

Dépannage

Le client n'arrive pas à se connecter. Vérifiez que l'adresse est exactement https://app.zadojo.com/mcp, avec https:// et sans espace à la fin.

Codex affiche Authorization server response missing required issuer: expected https://app.zadojo.com. Les versions 0.143 à 0.146 de Codex perdent l'émetteur pendant OAuth. Mettez à jour Codex CLI ou l'application de bureau Codex vers la version 0.147.0 ou plus récente, ou utilisez une clé API.

La connexion échoue ou expire sans cesse. Supprimez le serveur zaDojo de votre client, ajoutez-le de nouveau et refaites la connexion.

L'agent ne trouve pas de projet. Demandez-lui d'appeler d'abord list_projects et de réutiliser l'identifiant de projet renvoyé dans les appels suivants. Si vous n'avez aucun projet, demandez-lui d'en créer un pour votre domaine avec create_project, ce qui est gratuit.

Un outil payant indique que vous n'avez plus de crédits. Avec l'abonnement payant, achetez une recharge depuis la facturation dans l'application ou attendez la réinitialisation de vos crédits mensuels. Pendant l'essai, abonnez-vous pour continuer à utiliser les outils payants.

Toujours bloqué ? Écrivez à hello@zadojo.com en indiquant le nom et la version de votre client ainsi que l'erreur exacte. N'incluez jamais de clé API.