OptimoCMSDocs
MCP

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

ProblemaSolució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 lentoLa primera llamada puede tardar 2-3s (arranque en frío). Después, menos de un segundo.

Siguientes pasos

On this page