Mon premier MCP server — version EN LIGNE (Cloudflare)
Le même tool valider_iban, mais hébergé sur internet pour que de vrais agents
puissent l'appeler. Sans état, donc pas de base « Durable Objects » : un simple Worker.
Ce qu'il te faut
- Node.js 18+
- Un compte Cloudflare gratuit (https://dash.cloudflare.com/sign-up)
L'offre gratuite couvre très largement ce projet. Tu ne paies rien pour démarrer.
Déploiement en 4 commandes
cd mon-mcp-cloud
npm install
npx wrangler login # ouvre le navigateur, tu autorises une fois
npm run deploy # déploie
À la fin, Wrangler t'affiche une URL du type :
https://mon-premier-mcp.<ton-sous-domaine>.workers.dev
Ton endpoint MCP, c'est cette URL + /mcp :
https://mon-premier-mcp.<ton-sous-domaine>.workers.dev/mcp
C'est l'adresse que tu donnes aux agents.
Tester que ça marche (3 options)
Option A — la plus rapide : l'AI Playground de Cloudflare
Va sur le « AI Playground » de Cloudflare, colle ton URL /mcp, clique Connect,
puis « List Tools ». Tu dois voir valider_iban.
Option B — l'inspecteur officiel MCP
npx @modelcontextprotocol/inspector
Ça ouvre un outil local. Mets le transport sur « Streamable HTTP », colle ton URL
/mcp, Connect → List Tools → teste valider_iban avec BE68539007547034.
Option C — depuis Claude Desktop (via un petit proxy)
Dans claude_desktop_config.json :
{
"mcpServers": {
"mon-premier-mcp": {
"command": "npx",
"args": ["mcp-remote", "https://mon-premier-mcp.<ton-sous-domaine>.workers.dev/mcp"]
}
}
}
Redémarre Claude Desktop, puis demande : « Vérifie si l'IBAN BE68539007547034 est valide. »
Voir les transactions (ton « suivi »)
Le code écrit une ligne à chaque appel (date, tool, entrée, statut). Pour les voir en direct :
npm run tail # = wrangler tail, affiche les logs en temps réel
Tu les retrouves aussi dans le dashboard Cloudflare (l'observabilité est activée
dans wrangler.jsonc).
Plus tard : remplace le console.log(...) dans src/index.ts par un insert dans
une table Supabase, et tu auras un vrai historique consultable.
Modifier le serveur
Change le code dans src/index.ts, puis relance npm run deploy. C'est tout.
Pour ajouter un paiement (x402 ou Stripe MPP), c'est ici qu'on viendra greffer la
porte de paiement devant le tool — quand tu seras prêt.
Fichiers
src/index.ts— le serveur + le tool (c'est là que tu travailles)wrangler.jsonc— la config Cloudflarepackage.json— dépendances et scripts (deploy,dev,tail)