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
| Problem | Lö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 langsam | Der erste Aufruf kann 2-3s dauern (Cold Start). Danach unter einer Sekunde. |
Nächste Schritte
- Alle verfügbaren MCP-Tools — Übersicht aller Tools und Parameter
- AI Workflows — Häufige AI-Workflows mit Beispiel-Prompts