Connecter Claude à NextBlock CMS via MCP, depuis Cursor ou Claude Code

Ce guide vous montre comment connecter Claude à NextBlock CMS avec un standard ouvert, sans connecteur propriétaire. Cortex AI transforme votre site en serveur Model Context Protocol. Claude Code, Codex, Cursor et VS Code peuvent ensuite lire le schéma de votre base de données, ébaucher des mises en page et mettre à jour la navigation depuis leur propre fenêtre de clavardage. Les applications de clavardage ChatGPT et Gemini ne se connectent qu'aux serveurs qui s'authentifient par OAuth, ce que /api/mcp n'offre pas encore. Codex, inclus dans les forfaits ChatGPT, fonctionne dès aujourd'hui. Vous payez l'abonnement IA que vous avez déjà, sans aucune majoration sur les jetons entre les deux.

Chaque prompt devient un enregistrement structuré en base de données plutôt qu'un tas de code généré. Vos éditeurs gardent un CMS visuel, et vos développeurs gardent une application Next.js 16 propre. Les modifications de l'agent sur les pages, les articles et les produits sont enregistrées comme des révisions que vous pouvez restaurer.

Le problème des constructeurs web IA traditionnels

Les constructeurs par prompt comme Lovable, Bolt et v0 impressionnent le premier jour. Vous décrivez une page et obtenez une application React fonctionnelle en quelques minutes. Les ennuis commencent le deuxième jour.

NextBlock prend le contre-pied des outils de prototype. L'IA devrait ébaucher le site, et les humains devraient en être propriétaires. La connexion MCP est le point de rencontre de ces deux mondes.

Comment Cortex AI utilise le Model Context Protocol (MCP)

Le Model Context Protocol est un standard ouvert qui donne des outils aux agents IA. Un client comme Claude Code liste les outils offerts par un serveur, les appelle avec des arguments typés et lit des résultats typés en retour. Cortex AI embarque ce serveur dans votre installation NextBlock, à l'adresse /api/mcp.

Le point de terminaison parle Streamable HTTP. Votre client envoie des messages JSON-RPC dans une requête HTTPS ordinaire, et le serveur répond dans la même réponse. Aucun flux SSE de longue durée à surveiller, aucun SDK à installer côté serveur. Les mêmes 50 outils typés qui alimentent Cortex AI dans l'éditeur sont exposés sur le réseau, si bien que l'agent de votre IDE et celui de votre CMS ne divergent jamais.

Outils MCP de base de données disponibles

Six noms d'outils forment le contrat MCP public. Chacun renvoie vers un exécuteur Cortex AI testé.

Pas à pas : connecter Claude à NextBlock CMS dans Cursor et Claude Code

Le serveur est désactivé par défaut, parce qu'il constitue une surface d'écriture à distance sur du contenu en ligne. L'activer prend trois étapes, et grâce à l'essai, le premier mois ne coûte rien.

Claude Code exige "type": "http" dans l'entrée, sinon il ignore le serveur sans avertissement. Cursor déduit le transport à partir de l'URL et n'a pas besoin de champ type. VS Code utilise une clé servers de premier niveau et demande le jeton plutôt que de le stocker.

Configuration localhost sans jeton

Pendant le développement, laissez cochée l'option Trust localhost without a token (faire confiance à localhost sans jeton), activée par défaut dans la carte MCP server access. Un serveur de développement sur votre machine accepte alors les appels en boucle locale sans aucun en-tête. Dans un projet créé avec create-nextblock, npm run dev utilise le port 3000. Dans le clone du monorepo, npm run dev (qui lance nx serve nextblock) utilise le port 4200. La pile Docker locale répond aussi sur le port 3000 par défaut. Elle exécute un build de production : la confiance localhost ne s'y applique pas, et chaque client doit fournir un jeton. L'installation par agent en écrit déjà un dans .mcp.json et .cursor/mcp.json.

Ajoutez ce bloc au fichier .mcp.json à la racine de votre projet pour Claude Code.

{
  "mcpServers": {
    "nextblock": {
      "type": "http",
      "url": "http://localhost:3000/api/mcp"
    }
  }
}

La forme CLI fait la même chose en une ligne.

claude mcp add --transport http nextblock http://localhost:3000/api/mcp

Authentification en production par jetons bearer

En production, chaque client envoie un jeton bearer. Les jetons commencent par nbmcp_, ne sont affichés qu'une seule fois à leur création et ne sont stockés que sous forme de hachage SHA-256. Révoquer un jeton se fait en un clic, et la même valeur ne peut jamais être générée de nouveau.

Ajoutez ceci à .cursor/mcp.json pour Cursor, ou placez la même entrée dans .mcp.json avec un champ type pour Claude Code.

{
  "mcpServers": {
    "nextblock": {
      "url": "https://your-site.com/api/mcp",
      "headers": { "Authorization": "Bearer nbmcp_your_token" }
    }
  }
}

Rendu en production sans redéploiement

Si ça fonctionne, c'est grâce à l'endroit où le résultat atterrit. Cortex AI écrit des enregistrements de blocs JSONB stricts dans PostgreSQL, pas des fichiers source. Chaque bloc possède un schéma Zod : un champ invalide est rejeté avant d'être stocké.

À la requête, Next.js 16 rend ces enregistrements avec des Server Components, à partir d'un cache de contenu public vidé à chaque publication. Il n'y a aucune étape de build entre la publication et la mise en ligne, ni de coût de nettoyage HTML à chaque rendu. Les scores Lighthouse de 100/100 d'un site vide sont les mêmes après que l'agent a ébauché cinquante pages.