Saltar al contenido
← Todos los artículos

Cómo añadir un servidor MCP a Cursor

Añade un servidor MCP a Cursor con mcp.json: archivo global y de proyecto, url y headers, variables de entorno, comprobaciones y un ejemplo con Clautia.

John Guerrero, con barba y gafas redondasPor John GuerreroActualizado el 9 de noviembre de 2026
Ilustración abstracta: un editor con su panel lateral en el que una herramienta nueva se acopla junto al agente

Preguntas frecuentes

¿Dónde guarda Cursor la configuración de MCP?

En un archivo mcp.json. Según la documentación de Cursor, .cursor/mcp.json dentro de un proyecto da las herramientas solo a ese proyecto, y ~/.cursor/mcp.json en tu carpeta personal las deja disponibles en todas partes.

¿Cómo añado un servidor MCP remoto con una clave de API?

Añade una entrada bajo mcpServers con un url y un objeto headers. Los servidores remotos usan HTTP o SSE, así que llevan url en lugar de command. Pon la clave en la cabecera Authorization y léela de una variable de entorno.

¿Puedo usar variables de entorno en mcp.json?

Sí. Cursor documenta la interpolación en los campos command, args, env, url y headers, con la sintaxis ${env:NOMBRE}. Si la variable no se expande y el servidor responde con un 401, pega la clave en su lugar y mantén ese archivo fuera de git.

¿Cómo activo o desactivo un servidor?

Abre Customize en la barra lateral de Cursor, busca el servidor y usa su interruptor. Cursor indica que puedes activar y desactivar servidores sin quitarlos.

¿Cursor pregunta antes de usar una herramienta MCP?

Por defecto, sí. La documentación dice que Cursor pide aprobación antes de usar herramientas MCP, y que al pulsar la flecha junto al nombre ves los argumentos. Lee los argumentos antes de aprobar algo que publique.

¿Dónde veo los registros de MCP si el servidor falla?

Abre el panel Output con Cmd+Shift+U (Ctrl+Shift+U en Windows y Linux) y elige MCP Logs en el desplegable. Si los registros muestran un 401, revisa la clave. Si muestran un 403, a la clave le falta un permiso para esa acción.

¿Puede Cursor usar hoy el servidor MCP de Clautia?

Sí. Clautia documenta una entrada de mcp.json para Cursor. Creas una clave de API en Clautia, la defines como CLAUTIA_API_KEY y añades la entrada de abajo. Cursor ve entonces las mismas diez acciones que Claude Code y Codex.