OptimoCMSDocs
MCP

Configuration dans Cursor

Configurez OptimoCMS MCP dans Cursor IDE — de la clé API au premier appel d'outil en 2 minutes.

Configuration dans Cursor

Connectez OptimoCMS à Cursor pour gérer vos sites, créer des pages et générer du contenu directement depuis le chat AI.

Prérequis

  • Cursor v1.0+ installé
  • Une clé API OptimoCMS avec au minimum la permission read (en créer une)

Étape 1 — Ajouter la configuration MCP

Ouvrez (ou créez) le fichier .cursor/mcp.json à la racine de votre projet et ajoutez le bloc optimocms :

{
  "mcpServers": {
    "optimocms": {
      "type": "streamable-http",
      "url": "https://europe-west4-cms-sg.cloudfunctions.net/mcpServer",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Remplacez YOUR_API_KEY par votre clé API.

Vous ne voulez pas stocker la clé dans le fichier ? Utilisez une variable d'environnement :

{
  "mcpServers": {
    "optimocms": {
      "type": "streamable-http",
      "url": "https://europe-west4-cms-sg.cloudfunctions.net/mcpServer",
      "headers": {
        "Authorization": "Bearer ${OPTIMOCMS_API_KEY}"
      }
    }
  }
}

Définissez OPTIMOCMS_API_KEY comme variable système ou dans un fichier .env.

Étape 2 — Redémarrer Cursor

Après avoir sauvegardé mcp.json, redémarrez Cursor (ou ouvrez la Palette de Commandes → Developer: Reload Window). Vous verrez optimocms dans la liste des serveurs MCP.

Étape 3 — Tester la connexion

Ouvrez le chat AI de Cursor et tapez :

Utilise l'outil list_sites pour afficher tous mes sites.

Vous recevrez une réponse JSON avec tous vos sites :

{
  "sites": [
    {
      "id": "site_abc123",
      "name": "Mon Restaurant",
      "domain": "monrestaurant.fr",
      "status": "active",
      "language": "fr"
    }
  ],
  "total": 1
}

Étape 4 — Votre première action

Essayez de créer une page :

Crée une nouvelle page "À propos" sur le site site_abc123 avec une section hero et une section équipe.

Cursor utilise automatiquement create_page avec les bons paramètres.

Problèmes fréquents

ProblèmeSolution
"Serveur MCP non trouvé"Vérifiez que .cursor/mcp.json est à la racine du projet et redémarrez Cursor
"401 Unauthorized"Vérifiez votre clé API — est-elle active et non expirée ?
"403 Forbidden"Votre clé API n'a pas la permission requise (ex. write pour créer des pages)
L'outil répond lentementLe premier appel peut prendre 2-3s (démarrage à froid). Ensuite, moins d'une seconde.

Étapes suivantes

On this page