Configuración en Cursor
Configura OptimoCMS MCP en Cursor IDE — desde la clave API hasta la primera llamada en 2 minutos.
Configuración en Cursor
Conecta OptimoCMS a Cursor para gestionar sitios, crear páginas y generar contenido directamente desde el chat AI.
Requisitos previos
- Cursor v1.0+ instalado
- Una clave API de OptimoCMS con al menos permiso
read(crear una aquí)
Paso 1 — Añadir configuración MCP
Abre (o crea) el archivo .cursor/mcp.json en la raíz de tu proyecto y añade el bloque optimocms:
{
"mcpServers": {
"optimocms": {
"type": "streamable-http",
"url": "https://europe-west4-cms-sg.cloudfunctions.net/mcpServer",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Reemplaza YOUR_API_KEY por tu clave API.
¿No quieres guardar la clave en el archivo? Usa una variable de entorno:
{
"mcpServers": {
"optimocms": {
"type": "streamable-http",
"url": "https://europe-west4-cms-sg.cloudfunctions.net/mcpServer",
"headers": {
"Authorization": "Bearer ${OPTIMOCMS_API_KEY}"
}
}
}
}Define OPTIMOCMS_API_KEY como variable del sistema o en un archivo .env.
Paso 2 — Reiniciar Cursor
Después de guardar mcp.json, reinicia Cursor (o abre la Paleta de Comandos → Developer: Reload Window). Verás optimocms en la lista de servidores MCP.
Paso 3 — Probar la conexión
Abre el chat AI de Cursor y escribe:
Usa la herramienta list_sites para mostrar todos mis sitios.Recibirás una respuesta JSON con todos tus sitios:
{
"sites": [
{
"id": "site_abc123",
"name": "Mi Restaurante",
"domain": "mirestaurante.es",
"status": "active",
"language": "es"
}
],
"total": 1
}Paso 4 — Tu primera acción
Intenta crear una página:
Crea una nueva página "Sobre nosotros" en el sitio site_abc123 con una sección hero y una sección de equipo.Cursor usa automáticamente create_page con los parámetros correctos.
Problemas frecuentes
| Problema | Solución |
|---|---|
| "Servidor MCP no encontrado" | Verifica que .cursor/mcp.json está en la raíz del proyecto y reinicia Cursor |
| "401 Unauthorized" | Verifica tu clave API — ¿está activa y no expirada? |
| "403 Forbidden" | Tu clave API no tiene el permiso necesario (ej. write para crear páginas) |
| La herramienta responde lento | La primera llamada puede tardar 2-3s (arranque en frío). Después, menos de un segundo. |
Siguientes pasos
- Todas las herramientas MCP disponibles — resumen de todas las herramientas y parámetros
- Workflows AI — workflows AI comunes con ejemplos de prompts