Développeurs

Comment connecter ChatSEO à Claude Code via MCP ?

Configurer le serveur MCP de ChatSEO dans Claude Code, Cursor, Windsurf, VS Code ou Claude Desktop, et résoudre les erreurs courantes.

Le serveur MCP de ChatSEO te permet de piloter tes sites, tes todos et tes projets SEO depuis ton éditeur.

Qui y a accès ?

L'accès MCP et API est inclus dans les plans Pro et Ranker, ainsi que dans les plans sur mesure.

Si tu n'as aucun abonnement, tu peux l'essayer tant qu'il te reste des crédits. Le plan Starter est le seul à ne pas y donner accès : il faut passer sur Pro.

Clients pris en charge : Claude Code, Cursor, Windsurf, VS Code et Claude Desktop.

Où trouver tes paramètres MCP

  1. Clique sur ton profil en bas à gauche, puis sur Paramètres.
  2. Dans le groupe Espace de travail, ouvre Développeur.

Tu y trouves l'URL de ton serveur, les instructions par client, la liste des outils et la documentation. Un onglet séparé couvre l'API REST.

Connecter Claude Code

L'URL du serveur est https://api.chatseo.app/mcp. Dans ton terminal :

claude mcp add --transport http chatseo https://api.chatseo.app/mcp

À la première connexion, tu t'authentifies avec ton compte ChatSEO. Il n'y a pas de clé API à copier-coller.

Pour les autres clients, utilise l'option correspondante dans la section Développeur, ou la configuration manuelle.

Ce que tu peux faire

Le serveur expose une trentaine d'outils pour gérer tes sites, projets, todos, artefacts, intégrations et conversations, ainsi que la publication WordPress. La liste à jour est dans les paramètres Développeur.

L'erreur « No active organization »

Elle apparaît en général à la première requête : ton appel n'est pas encore rattaché à une organisation.

  1. Liste tes organisations via le MCP pour récupérer ton organizationId.
  2. Sélectionne l'organisation avec laquelle travailler.

Les requêtes suivantes fonctionnent normalement. Cet identifiant n'est pas visible dans l'interface, il s'obtient uniquement par le MCP ou l'API.

Coupures de transport ou délais d'attente

Le protocole MCP ne diffuse pas les réponses en continu. Sur un traitement long (analyse de mots-clés, audit complet), le client peut abandonner avant la fin.

  • Dis à ton assistant : « le streaming n'existe pas en MCP, le délai vient de mon côté, patiente puis récupère la conversation une fois terminée » ;
  • réduis la portée de la requête (période plus courte, moins de mots-clés) ;
  • la réponse reste retrouvable dans l'historique de tes conversations sur le tableau de bord.

Un client qui renvoie toujours 401

Certains clients MCP n'implémentent pas le paramètre OAuth resource (RFC 8707), qui indique au serveur à quelle ressource le token est destiné. La connexion aboutit, puis chaque appel repart en 401 invalid_token.

ChatSEO applique désormais https://api.chatseo.app/mcp comme ressource par défaut : ces clients fonctionnent donc avec l'URL HTTP directe. Si le tien échoue encore, passe par mcp-remote, qui gère le flow OAuth complet :

npx -y mcp-remote https://api.chatseo.app/mcp

C'est déjà la configuration utilisée pour Claude Desktop, et l'alternative proposée dans les paramètres Développeur pour Claude Code.

Clients et outils non pris en charge

Les automatisations type N8N ne sont pas officiellement prises en charge. ChatSEO ne propose pas non plus d'intégration directe avec Ahrefs, SEMrush ou Screaming Frog.

Si tu as un cas d'usage particulier, écris-nous dans le chat.