Cloudflare MCP : piloter votre compte Cloudflare avec l’IA (guide 2026)
Cloudflare publie ses propres serveurs MCP pour que Claude, Cursor ou tout autre client compatible puisse interroger et administrer votre compte : DNS, Workers, analyses, sécurité. Depuis 2026, un serveur unique, Cloudflare API MCP, donne accès à l’ensemble de l’API grâce à l’approche « Code Mode ». Ce guide fait le point sur les serveurs officiels, leur installation dans chaque client et les précautions à prendre.
Cloudflare MCP en bref
- Éditeur : Cloudflare, qui héberge les serveurs et publie le dépôt
cloudflare/mcp-server-cloudflare. - Serveur recommandé :
https://mcp.cloudflare.com/mcp, pour toute l’API (plus de 2 500 points d’accès) et la documentation. - Transport : Streamable HTTP sans état ; toutes les adresses se terminent par
/mcp. - Authentification : OAuth avec choix des permissions, ou jeton d’API pour l’automatisation.
- Fiche annuaire : Cloudflare MCP.
Ce que l’IA peut faire avec les serveurs MCP Cloudflare
Le serveur Cloudflare API MCP (Code Mode)
Plutôt que d’exposer un outil par point d’accès, ce serveur n’en propose que quatre : search, qui exécute du JavaScript sur la spécification OpenAPI pour trouver le bon appel, execute, qui appelle l’API via cloudflare.request(), docs et whoami. Le code écrit par le modèle tourne dans un bac à sable isolé (Dynamic Worker). Selon Cloudflare, cette approche consomme environ 1 000 jetons de contexte, contre environ 1,17 million pour des outils natifs décrivant chaque point d’accès. Les requêtes GraphQL Analytics passent aussi par execute.
Les serveurs MCP spécialisés
https://docs.mcp.cloudflare.com/mcp: documentation de référence à jour.https://containers.mcp.cloudflare.com/mcp: environnement de développement en bac à sable.https://browser.mcp.cloudflare.com/mcp: Browser Run (ex-Browser Rendering) pour récupérer une page, la convertir en Markdown ou en faire une capture.https://dex.mcp.cloudflare.com/mcp: Digital Experience Monitoring.https://casb.mcp.cloudflare.com/mcp: CASB de Cloudflare One, pour repérer les mauvaises configurations de vos applications SaaS.https://agents.cloudflare.com/mcp: documentation de l’Agents SDK.
Les anciens serveurs AI Gateway, Audit Logs, AutoRAG, DNS Analytics, GraphQL, Logpush, Observability, Radar, Bindings et Builds sont désormais marqués obsolètes : Cloudflare demande de migrer vers le serveur API MCP.
Installer Cloudflare MCP dans votre client
Configuration générique
La documentation de Cloudflare donne cette configuration JSON, valable pour la plupart des clients qui acceptent les serveurs distants :
{"mcpServers":{"cloudflare-api":{"url":"https://mcp.cloudflare.com/mcp"}}}
Avant de l’enregistrer, vous pouvez contrôler sa syntaxe avec notre validateur de configuration MCP.
Claude Code
Cloudflare documente la syntaxe claude mcp add --transport http <nom> <url> pour ajouter un serveur distant. Appliquée au serveur API, elle donne :
claude mcp add --transport http cloudflare-api https://mcp.cloudflare.com/mcp
claude mcp list
Cloudflare propose aussi ses « skills » sous forme de plugin pour Claude Code :
/plugin marketplace add cloudflare/skills
Claude Desktop et Claude.ai
Ajoutez l’URL https://mcp.cloudflare.com/mcp comme connecteur personnalisé, puis autorisez l’accès sur la page Cloudflare qui s’ouvre. Notre guide ajouter un serveur MCP à Claude détaille chaque étape.
Cursor et Windsurf
Dans Cursor, placez le bloc JSON ci-dessus dans .cursor/mcp.json (projet) ou ~/.cursor/mcp.json (global). Dans Windsurf, la clé à utiliser dans mcp_config.json est serverUrl.
Créer votre propre serveur MCP sur Cloudflare
Cloudflare est aussi une plateforme pour héberger vos serveurs MCP distants. Le modèle officiel sans authentification se crée et se déploie ainsi :
npm create cloudflare@latest -- remote-mcp-server-authless --template=cloudflare/ai/demos/remote-mcp-authless
cd remote-mcp-server-authless
npm start
npx wrangler@latest deploy
En local, le serveur répond sur http://localhost:8788/mcp. L’API actuelle repose sur createMcpHandler, sans état ; l’ancienne classe McpAgent est dépréciée, ce qui rend obsolètes de nombreux tutoriels publiés avant 2026. Pour protéger votre serveur, Cloudflare fournit la bibliothèque @cloudflare/workers-oauth-provider.
Limites et pièges à connaître
- Les adresses
/sseont été retirées le 22 octobre 2026 et renvoient une erreur 410 Gone. - Chaque résultat de
searchetexecuteest plafonné à environ 6 000 jetons ; le paramètretruncate: falselève ce plafond, au prix d’un contexte plus chargé. - L’option
?codemode=falseenregistre un outil par point d’accès, soit environ 3 000 outils et 244 000 jetons : à réserver aux cas particuliers. - Les jetons de compte doivent avoir la permission « Account Resources : Read », et les jetons filtrés par adresse IP ne sont pas pris en charge.
- Certaines fonctionnalités peuvent nécessiter un forfait Workers payant.
Sécurité
Le serveur API peut modifier votre infrastructure : DNS, règles, Workers. Lors de l’autorisation OAuth, n’accordez que les permissions utiles ; si une permission manque, le serveur renvoie une erreur 403 insufficient_scope et le client vous redemande l’autorisation correspondante. Pour l’intégration continue, préférez un jeton d’API dédié et limité, transmis en en-tête Authorization. Relisez enfin chaque appel execute avant de le valider. Notre checklist de sécurité MCP résume les autres bonnes pratiques.
Questions fréquentes
Quel serveur MCP Cloudflare choisir pour commencer ?
Cloudflare recommande le serveur API MCP, à l’adresse https://mcp.cloudflare.com/mcp. Il couvre toute l’API Cloudflare et la documentation avec seulement quatre outils. Les serveurs spécialisés restent utiles pour des usages précis, comme Browser Run ou le bac à sable Containers.
Faut-il un abonnement Cloudflare payant ?
Il faut un compte Cloudflare. Le dépôt officiel précise seulement que certaines fonctionnalités peuvent nécessiter un forfait Workers payant, sans détailler lesquelles : vérifiez la documentation du produit concerné.
Pourquoi mon ancienne URL en /sse ne fonctionne plus ?
Cloudflare a retiré les points d’accès /sse en octobre 2026. Ils répondent désormais par une erreur 410 Gone qui indique la nouvelle adresse : remplacez simplement /sse par /mcp dans votre configuration.
Peut-on héberger son propre serveur MCP sur Cloudflare ?
Oui. Cloudflare fournit un modèle prêt à déployer sur Workers, une API createMcpHandler et une bibliothèque OAuth (workers-oauth-provider) pour protéger l’accès à votre serveur.
Sources
- Dépôt cloudflare/mcp-server-cloudflare
- Dépôt cloudflare/mcp (serveur API)
- Documentation Cloudflare : serveurs MCP pour Cloudflare
- Documentation Cloudflare : créer un serveur MCP distant
- Blog Cloudflare : Code Mode MCP
Sources consultées le 20 novembre 2026.
