OptimoCMSDocs
MCP

Setup in Cursor

OptimoCMS MCP in Cursor IDE konfigurieren — vom API-Key bis zum ersten Tool-Aufruf in 2 Minuten.

Setup in Cursor

Verbinde OptimoCMS mit Cursor, um Websites direkt aus dem AI-Chat zu verwalten, Seiten zu erstellen und Inhalte zu generieren.

Voraussetzungen

  • Cursor v1.0+ installiert
  • Ein OptimoCMS API-Key mit mindestens read-Berechtigung (hier erstellen)

Schritt 1 — MCP-Konfiguration hinzufügen

Öffne (oder erstelle) die Datei .cursor/mcp.json im Projekt-Root und füge den optimocms-Block hinzu:

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

Ersetze YOUR_API_KEY durch deinen API-Key.

Key nicht in der Datei speichern? Verwende eine Umgebungsvariable:

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

Setze OPTIMOCMS_API_KEY als Systemvariable oder in einer .env-Datei.

Schritt 2 — Cursor neu starten

Nach dem Speichern von mcp.json starte Cursor neu (oder öffne die Befehlspalette → Developer: Reload Window). Du siehst jetzt optimocms in der MCP-Serverliste.

Schritt 3 — Verbindung testen

Öffne den Cursor AI-Chat und tippe:

Verwende das list_sites Tool, um alle meine Websites anzuzeigen.

Du erhältst eine JSON-Antwort mit all deinen Websites:

{
  "sites": [
    {
      "id": "site_abc123",
      "name": "Mein Restaurant",
      "domain": "meinrestaurant.de",
      "status": "active",
      "language": "de"
    }
  ],
  "total": 1
}

Schritt 4 — Deine erste Aktion

Erstelle eine Seite:

Erstelle eine neue "Über uns"-Seite auf Website site_abc123 mit einem Hero-Bereich und einem Team-Bereich.

Cursor verwendet automatisch create_page mit den richtigen Parametern.

Häufige Probleme

ProblemLösung
"MCP-Server nicht gefunden"Stelle sicher, dass .cursor/mcp.json im Projekt-Root liegt und starte Cursor neu
"401 Unauthorized"Überprüfe deinen API-Key — ist er aktiv und nicht abgelaufen?
"403 Forbidden"Deinem API-Key fehlt die benötigte Berechtigung (z.B. write zum Erstellen von Seiten)
Tool reagiert langsamDer erste Aufruf kann 2-3s dauern (Cold Start). Danach unter einer Sekunde.

Nächste Schritte

On this page