--- title: "Surfer MCP" description: "Utilisez les données et les outils de Surfer directement dans Claude, Cursor, ChatGPT et d'autres assistants IA." url: https://docs.surferseo.com/fr/articles/12944186-surfer-mcp collection: "MCP" updated: 2026-10-31 language: fr alternates: [en, de] --- # Surfer MCP Utilisez les données et les outils de Surfer directement dans Claude, Cursor, ChatGPT et d'autres assistants IA. > **Success:** Vous savez déjà tout sur le MCP ? Consultez notre [documentation officielle pour les développeurs](https://devs.surferseo.com/mcp/overview) et commencez à automatiser vos workflows de contenu avec Surfer. ## Qu'est-ce que Surfer MCP ? Surfer MCP vous permet de connecter Surfer directement à votre assistant IA, afin d'utiliser les données et les outils de Surfer directement dans une conversation avec Claude, Cursor, ChatGPT ou tout outil prenant en charge le MCP (Model Context Protocol). Au lieu de basculer constamment entre votre assistant IA et l'application Surfer, vous vous connectez une seule fois et laissez l'assistant créer, optimiser et évaluer le contenu pour vous, à partir de vos données Surfer en direct et de votre configuration de marque. ## Conditions requises Pour utiliser Surfer MCP, vous avez besoin de : - Un compte Surfer avec une offre **Pro, Peace of Mind** ou **Enterprise**. - Un outil IA prenant en charge le MCP, tel que Claude, Cursor, VS Code, Windsurf ou ChatGPT. > **Warning:** La limite de votre offre d'abonnement s'applique à toutes les actions que vous effectuez via MCP. Par exemple, vous ne pouvez pas créer d'Éditeurs de contenu au-delà de la limite de votre offre. > **Success:** Vous testez Surfer ? Parfait ! Le MCP est également disponible sur un compte d'essai. Essayez ! [En savoir plus sur l'essai Surfer »](https://docs.surferseo.com/en/articles/12944181-how-does-the-surfer-trial-work.md) ## Ce que vous pouvez faire avec Surfer MCP Une fois connecté, Surfer MCP permet à votre assistant IA de travailler directement avec votre compte Surfer : récupérer des données, lancer des optimisations et créer du contenu sans que vous ayez à quitter le chat. Voici ce qu'il peut faire aujourd'hui : **Rédigez et optimisez du contenu dans l'Éditeur de contenu** - Créez et récupérez des [Éditeurs de contenu](https://docs.surferseo.com/en/articles/5700347-content-editor-overview.md) (mot-clé, emplacement, appareil, mots-clés secondaires, modèles, Tonalités, instructions personnalisées) - Récupérez les recommandations SEO et vérifiez la couverture des termes, de la structure et des thématiques - Récupérez uniquement les recommandations SEO et AI Search manquantes (termes et faits), et pas seulement l'ensemble complet - Récupérez les [recommandations AI Search (AIO)](https://docs.surferseo.com/en/articles/10717145-facts.md) : des faits sourcés issus de la SERP et des principaux moteurs d'IA (AI Overviews, AI Mode, Gemini, OpenAI, Perplexity) - Gérez les concurrents de la SERP (inclure/exclure, charger plus, recalculer les recommandations) - Récupérez et régénérez des plans - Générez des articles complets avec [Surfer AI](https://docs.surferseo.com/en/articles/7869670-surfer-ai.md), avec une révision manuelle du plan en option - Ajoutez des [liens internes et externes](https://docs.surferseo.com/en/articles/9154320-automated-internal-linking-tool.md) aux articles générés avec Surfer AI - Récupérez et mettez à jour votre contenu en Markdown ou HTML - [Recalculez le score du contenu](https://docs.surferseo.com/en/articles/5700365-content-score-in-the-editor-explained.md) pour le SEO, l'AI Search et le score total - Lancez l'[Auto-optimisation](https://docs.surferseo.com/en/articles/9172781-auto-optimize.md) et suivez son statut - Obtenez des permaliens partageables **Suivez la Visibilité IA avec le Suivi de visibilité IA** - Listez et récupérez vos projets [Suivi de visibilité IA](https://docs.surferseo.com/en/articles/11667466-ai-tracker.md) - Récupérez des résumés de visibilité : taux de mentions, position dans la réponse et score de présence par modèle d'IA - Consultez les tendances de visibilité quotidiennes au fil du temps - Examinez les prompts suivis, regroupés par thématique - Consultez les sources citées (par domaine ou URL, par modèle, avec un indicateur de mention de marque) - Listez les marques mentionnées dans les réponses IA - Récupérez vos opportunités de mentions **Agissez sur les recommandations** - Récupérez des pages d'[Audit de contenu](https://docs.surferseo.com/en/articles/9182497-content-audit.md) à optimiser - Récupérez des idées de [Carte thématique](https://docs.surferseo.com/en/articles/9383782-topical-map.md) à rédiger **Gérez votre Espace de marque et votre marque** - Créez un [Espace de marque](https://docs.surferseo.com/en/articles/12944172-workspaces-in-surfer.md) à partir de l'URL du site web d'une marque, puis listez, récupérez et activez des Espaces de marque - Récupérez et mettez à jour le [Contexte de marque](https://docs.surferseo.com/en/articles/12631203-brand-knowledge.md) - Créez, récupérez, mettez à jour et supprimez des [Tonalités](https://docs.surferseo.com/en/articles/12944177-custom-voice.md) - Créez, récupérez, mettez à jour et supprimez des [modèles de contenu](https://docs.surferseo.com/en/articles/8272654-surfer-ai-templates.md) Vous pouvez également utiliser des skills intégrés, des playbooks prêts à l'emploi qui exécutent un Workflow complet (comme la rédaction ou l'optimisation d'un article) à partir d'une seule demande, en se mettant en pause lorsqu'ils ont besoin de votre intervention. **Liste des skills disponibles** - surfer-content-recommendations — Agit sur les recommandations de Sites de Surfer ; sélectionne les travaux de rédaction ou d'optimisation guidés par les recommandations et délègue au skill approprié ci-dessous. - surfer-create-content-brief — Crée un brief prêt à l'emploi pour le rédacteur, avec des conseils SEO et AI Search, une analyse SERP/concurrents, une structure, des termes et des questions (aucun brouillon n'est rédigé). - surfer-create-outline — Génère un plan d'article basé sur la SERP, sans brouillon complet. - surfer-manage-content-templates — Crée, inspecte, met à jour, choisit ou supprime des modèles de contenu réutilisables. - surfer-optimize-content — Améliore le Score SEO et/ou le Score AI Search d'un article ou d'une page existants. - surfer-write-article — Rédige un tout nouvel article ou article de blog optimisé pour le SEO/l'AI Search à partir d'un mot-clé ou d'une thématique. Et vous trouverez ici une liste des événements bruts : **Événements bruts** - **Content Editor** - content\_editor\_\_create - content\_editor\_\_get - content\_editor\_\_list - content\_editor\_\_update - content\_\_get - content\_\_update - content\_score\_\_get - outline\_\_get - outline\_\_regenerate - permalink\_\_list - **SEO Guidelines** - seo\_guidelines\_\_get - seo\_guidelines\_\_get\_terms\_coverage - seo\_guidelines\_\_update\_terms - seo\_guidelines\_\_update\_structure - seo\_guidelines\_\_update\_competitors - seo\_guidelines\_\_update\_topics\_and\_questions - seo\_guidelines\_\_load\_more\_competitors - **AI Search Guidelines** - ai\_search\_guidelines\_\_get - ai\_search\_guidelines\_\_list\_facts - **AI Article** - ai\_article\_\_generate - ai\_article\_\_get - ai\_article\_\_list - ai\_article\_\_get\_outline - ai\_article\_\_submit\_outline - **Auto-Optimize** - auto\_optimize\_\_run - auto\_optimize\_\_get - **AI Tracker** - ai\_tracker\_\_list - ai\_tracker\_\_get - ai\_tracker\_\_get\_summary - ai\_tracker\_\_get\_time\_series - ai\_tracker\_\_list\_prompts - ai\_tracker\_\_list\_sources - ai\_tracker\_\_list\_brands - ai\_tracker\_\_get\_mention\_gap - **Recommendations** - recommendation\_\_list - recommendation\_\_optimize - **Workspace** - workspace\_\_list - workspace\_\_get - workspace\_\_create - workspace\_\_activate - **Brand** - brand\_\_get - brand\_\_update - **Custom Voices** - custom\_voice\_\_list - custom\_voice\_\_get - custom\_voice\_\_create - custom\_voice\_\_update - custom\_voice\_\_delete - **Content Templates** - content\_template\_\_list - content\_template\_\_get - content\_template\_\_create - content\_template\_\_update - content\_template\_\_delete - surfer\_content\_template\_\_list - **Skills** - skill\_\_list - skill\_\_get ## **Installer le Surfer MCP dans votre LLM** Le Surfer MCP connecte Surfer à votre assistant IA préféré afin qu'il puisse récupérer vos Espaces de marque, votre contenu et vos données directement dans vos conversations. La configuration prend quelques minutes et fonctionne de la même manière avec tous les clients : indiquez-lui le serveur Surfer MCP, connectez-vous avec votre compte Surfer, et c'est prêt. **L'adresse du serveur est :** [https://mcp.surferseo.com/mcp](https://mcp.surferseo.com/mcp) **Les guides de configuration et l'adresse du serveur sont également disponibles dans l'application Surfer → section MCP et API, située dans la barre de menu de gauche :** ![](https://files.gleap.io/pf/gattachments/PeQf17eE2525ZhEu4Knh8WKkYvc6R1klxMNTeZBcWw7SzmOWBraOobozSYnaGbOB8Xq3Q8d32Mq.png?v=1&k=a&s=api&e=1793966400&sig=PxqOC8s1cuvLiMm9sXuy3rfFdVtDbUHSVeOEsVAiqFs) Maintenant, sélectionnez votre client ci-dessous et suivez les étapes : **Claude** 1. Dans [claude.ai](https://claude.ai) ou l'application de bureau Claude, ouvrez Personnaliser → Connecteurs et cliquez sur Ajouter un connecteur personnalisé. 2. Nommez-le Surfer, collez l'URL du serveur et sélectionnez Continuer. 3. Conservez les paramètres d'authentification détectés et cliquez sur Ajouter. 4. Cliquez sur Se connecter à côté de Surfer et connectez-vous. Si vous avez plusieurs organisations, sélectionnez la vôtre et choisissez Autoriser. 5. Dans une nouvelle conversation, activez Surfer sous + → Connecteurs. Remarque : les offres Claude gratuites autorisent un connecteur personnalisé. Sur les offres Team et Enterprise, un propriétaire l'ajoute sous Paramètres de l'organisation → Connecteurs → Ajouter → Personnalisé, puis chaque membre clique sur Se connecter dans Personnaliser → Connecteurs. [En savoir plus dans notre documentation MCP complète »](https://devs.surferseo.com/mcp/connect/claude) **Claude Code** 1. Exécutez ceci dans votre terminal. Supprimez `--scope user` pour ajouter Surfer uniquement au projet actuel : ```javascript claude mcp add --transport http --scope user surfer https://mcp.surferseo.com/mcp ``` 2. Démarrez Claude Code, exécutez `/mcp`, sélectionnez surfer et choisissez Authenticate. Connectez-vous avec votre compte Surfer dans le navigateur. Si le navigateur ne s'ouvre pas, copiez l'URL affichée par Claude Code et ouvrez-la vous-même. [En savoir plus dans notre documentation MCP complète »](https://devs.surferseo.com/mcp/connect/claude-code) ChatGPT 1. Dans ChatGPT, ouvrez Paramètres → Sécurité et connexion et activez le Mode développeur. 2. Accédez à chatgpt.com/plugins et cliquez sur +. Nommez-le Surfer, collez l'URL du serveur dans le champ correspondant, choisissez OAuth, cochez Je comprends et je souhaite continuer, puis cliquez sur Créer. 3. Sur la page du plugin, cliquez sur Se connecter, puis sur Se connecter avec Surfer. Si vous avez plusieurs organisations, sélectionnez la vôtre et choisissez Autoriser. 4. Dans une conversation, ouvrez le menu +, choisissez Mode développeur et sélectionnez Surfer. Remarque : le Mode développeur fonctionne sur ChatGPT sur le web pour les comptes Plus, Pro, Business, Enterprise et Edu. La disponibilité peut dépendre de la politique de votre espace de travail. En savoir plus dans notre documentation MCP complète : - [ChatGPT Web](https://devs.surferseo.com/mcp/connect/chatgpt-web) - [ChatGPT Desktop](https://devs.surferseo.com/mcp/connect/chatgpt-desktop) Codex 1. Exécutez ceci dans votre terminal et connectez-vous avec votre compte Surfer lorsque le navigateur s'ouvre : ```javascript codex mcp add surfer --url https://mcp.surferseo.com/mcp ``` 2. Si le navigateur ne s'ouvre pas, connectez-vous avec : ```javascript codex mcp login surfer ``` Au lieu de la commande de l'étape 1, vous pouvez ajouter ceci vous-même dans `~/.codex/config.toml` : ```javascript [mcp_servers.surfer] url = "https://mcp.surferseo.com/mcp" ``` Remarque : la CLI Codex, l'extension IDE Codex et l'application de bureau ChatGPT partagent ce fichier de configuration. [En savoir plus dans notre documentation MCP complète »](https://devs.surferseo.com/mcp/connect/codex) Cursor 1. Ajoutez ceci à `~/.cursor/mcp.json` (tous les projets) ou `.cursor/mcp.json` (ce projet), puis enregistrez : ```json { "mcpServers": { "surfer": { "url": "https://mcp.surferseo.com/mcp" } } } ``` 2. Ouvrez Customize → MCPs, cliquez sur Authenticate sur la ligne surfer et connectez-vous avec votre compte Surfer. La ligne affiche Ready une fois connectée. [En savoir plus dans notre documentation MCP complète »](https://devs.surferseo.com/mcp/connect/cursor) > **Info:** Vous souhaitez connecter Surfer à un autre client compatible MCP ? Découvrez comment faire [ici »](https://devs.surferseo.com/mcp/connect/other). > **Success:** Une fois la configuration terminée avec n'importe quel modèle, demandez à votre assistant de confirmer que cela fonctionne en saisissant : **Liste mes Espaces de marque Surfer > ** > Si le modèle renvoie une liste, tout est prêt ! ## FAQ **Où puis-je trouver la documentation développeur officielle de Surfer sur le MCP ?** Rendez-vous sur notre [documentation pour développeurs](https://devs.surferseo.com/mcp/overview). Vous la trouverez également dans l'application Surfer → section MCP & API (dans le menu de gauche) → MCP → faites défiler vers le bas jusqu'au bouton correspondant qui vous mènera à la documentation. **Quelles offres d'abonnement peuvent utiliser Surfer MCP ?** Les offres Pro, Peace of Mind et Enterprise. L'essai Surfer inclut également l'accès au MCP. **Avec quels outils IA fonctionne-t-il ?** Tout outil qui prend en charge le MCP, y compris Claude, Cursor, VS Code, Windsurf et ChatGPT. **Dois-je me connecter à chaque fois ?** Non. Vous vous connectez une seule fois, et votre session reste active. Il se peut que vous soyez occasionnellement invité à vous reconnecter lorsque nous publions des mises à jour. **L'utilisation de MCP compte-t-elle dans les limites de mon offre ?** Oui. Tout ce que vous faites via MCP utilise votre abonnement Surfer, comme lorsque vous travaillez dans l'application. Les actions qui créent ou génèrent du contenu, comme la création d'un Éditeur de contenu, comptent dans la limite de votre offre : vous ne pouvez donc pas la dépasser. La simple consultation ou lecture de données n'utilise pas votre limite. **Puis-je partager l'accès avec quelqu'un d'autre ?** Oui. Toute personne disposant d'un compte Surfer et appartenant à une organisation ayant accès au MCP peut se connecter avec son propre compte. **Une demande semble bloquée, y a-t-il un problème ?** Non. Certaines actions (comme la création d'un Éditeur de contenu) s'exécutent en arrière-plan et prennent quelques minutes. Demandez simplement à votre assistant de vérifier si c'est prêt. **La connexion ne fonctionne pas. Que dois-je vérifier ?** Confirmez que : - le MCP auquel vous vous connectez est **le même que celui disponible dans les paramètres de l'application Surfer** ; - vous vous connectez avec le bon compte Surfer et que votre offre inclut l'accès au MCP. Toujours bloqué ? Contactez-nous à [**support@surferseo.com**](mailto:support@surferseo.com).