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

Ce guide vous montre comment connecter Claude à NextBlock CMS avec un standard ouvert plutôt qu'un plugin propriétaire. Cortex AI transforme votre site en serveur Model Context Protocol. Claude Code, Cursor, ChatGPT et Gemini 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. 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, vos développeurs gardent une application Next.js 16 propre, et rien n'est mis en ligne tant que quelqu'un ne clique pas sur Publier.

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 29 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

Cinq 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, activez Faire confiance à localhost sans jeton dans la même carte de réglages. Un serveur de développement sur votre machine accepte alors les appels en boucle locale sans aucun en-tête. Les installations autonomes tournent sur le port 3000, et le serveur de développement du monorepo sur le port 4200.

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 chaînes HTML ni 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 et met le résultat en cache en périphérie. 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.