OptimoCMSDocs
MCP

Setup in Cursor

Configureer OptimoCMS MCP in Cursor IDE — van API key tot eerste tool call in 2 minuten.

Setup in Cursor

Koppel OptimoCMS aan Cursor zodat je vanuit de AI chat sites kunt beheren, pagina's aanmaken en content genereren.

Vereisten

  • Cursor v1.0+ geïnstalleerd
  • Een OptimoCMS API key met minimaal read permissie (maak er een aan)

Stap 1 — MCP configuratie toevoegen

Open (of maak) het bestand .cursor/mcp.json in je project root en voeg het optimocms blok toe:

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

Vervang YOUR_API_KEY door je eigen API key.

Wil je de key niet in het bestand opslaan? Gebruik een omgevingsvariabele:

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

Stel OPTIMOCMS_API_KEY in als systeemvariabele of in een .env bestand.

Stap 2 — Herstart Cursor

Na het opslaan van mcp.json, herstart Cursor (of open het Command Palette → Developer: Reload Window). Je ziet nu optimocms in de MCP servers lijst.

Stap 3 — Test de verbinding

Open de Cursor AI chat en typ:

Gebruik de list_sites tool om al mijn sites te tonen.

Je krijgt een JSON response met al je sites:

{
  "sites": [
    {
      "id": "site_abc123",
      "name": "Mijn Restaurant",
      "domain": "mijnrestaurant.nl",
      "status": "active",
      "language": "nl"
    }
  ],
  "total": 1
}

Stap 4 — Je eerste actie

Probeer een pagina aan te maken:

Maak een nieuwe "Over Ons" pagina aan op site site_abc123 met een hero sectie en een team sectie.

Cursor gebruikt automatisch create_page met de juiste parameters.

Veelvoorkomende problemen

ProbleemOplossing
"MCP server niet gevonden"Controleer dat .cursor/mcp.json in de project root staat en herstart Cursor
"401 Unauthorized"Controleer je API key — is deze actief en niet verlopen?
"403 Forbidden"Je API key mist de benodigde permissie (bijv. write voor pagina's aanmaken)
Tool reageert traagEerste call kan 2-3s duren (cold start). Daarna sub-seconde.

Volgende stappen

On this page