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
readpermissie (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
| Probleem | Oplossing |
|---|---|
| "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 traag | Eerste call kan 2-3s duren (cold start). Daarna sub-seconde. |
Volgende stappen
- Alle beschikbare MCP tools — overzicht van alle tools en parameters
- AI Workflows — veelvoorkomende AI workflows met voorbeeld-prompts