MCP en Cursor: mcp.json, OAuth y claves

En corto: Cursor lee los servidores MCP de ~/.cursor/mcp.json (para todos los proyectos) y de .cursor/mcp.json (para uno solo). A un servidor remoto le basta con el campo url, y Cursor te ofrecerá entrar por OAuth. Si el acceso desde el navegador resulta incómodo, la clave se pasa en headers mediante una variable de entorno.

Dos archivos, dos ámbitos

La lista de servidores se abre en los ajustes de Cursor, en la sección MCP: ahí se ve qué servidores hay conectados, cuántas herramientas tiene cada uno y hay un interruptor para desactivar uno temporalmente. Si todavía estás conociendo el protocolo, pásate antes por el repaso de los servidores MCP.

Camino 1. La URL y el acceso por OAuth

El camino más corto es anotar sólo las direcciones. Marca las herramientas de abajo y el mcp.json se arma solo.

{
  "mcpServers": {
    "twelver-image-generation": {
      "url": "https://twelver.ru/api/mcp/v1/image-generation"
    },
    "twelver-web-search": {
      "url": "https://twelver.ru/api/mcp/v1/web-search"
    }
  }
}

Guarda el archivo y, junto al servidor, aparecerá en los ajustes un botón de acceso. Púlsalo, entra en tu cuenta de Twelver desde el navegador y el servidor pasará a estar activo. Para OAuth hace falta una cuenta registrada.

Camino 2. La clave en la cabecera

Para máquinas compartidas, contenedores y los casos en que el acceso por navegador no sale, es más práctica la clave. Consíguela con el botón de abajo, sin registro:

export TWELVER_API_KEY="sk-<tu-clave>"

Y luego referencia la variable desde mcp.json: Cursor la sustituye al arrancar y la clave no acaba en el repositorio:

{
  "mcpServers": {
    "twelver-web-search": {
      "url": "https://twelver.app/api/mcp/v1/web-search",
      "headers": {
        "Authorization": "Bearer ${env:TWELVER_API_KEY}"
      }
    },
    "twelver-image": {
      "url": "https://twelver.app/api/mcp/v1/image-generation",
      "headers": {
        "Authorization": "Bearer ${env:TWELVER_API_KEY}"
      }
    }
  }
}

Cursor en macOS, arrancado desde el Dock, puede no ver las variables de ~/.zshrc. Si el servidor responde 401, abre Cursor desde la terminal con cursor .: así hereda el entorno de la shell.

Confirmación de las llamadas

Por defecto Cursor pide permiso antes de cada llamada a una herramienta MCP y muestra los parámetros. Es razonable para herramientas que cambian algo o gastan saldo. Para la búsqueda y la lectura de páginas puedes quitar la confirmación añadiendo la herramienta a la lista de ejecución automática, y el agente trabajará sin pausas.

Qué pedirle al agente

• «Lee la documentación actual sobre migrar a la nueva versión de la librería y prepara un plan de cambios»: web-search y web-crawl en lugar de una respuesta salida de la memoria caducada del modelo.
• «Genera tres versiones de la imagen hero para la landing en 16:9 y mete la primera en el marcado»: text-to-image devuelve enlaces a los archivos. Más sobre la generación, en el capítulo generación de imágenes y vídeo por MCP.

Si no funciona

¿Estás montando lo mismo en otros clientes? Instrucciones para Claude y LM Studio. La página que arma los servidores para Cursor es servidores MCP de Twelver para Cursor.