¿Qué es MCP?

Model Context Protocol (MCP) permite que Cursor se conecte con herramientas externas y fuentes de datos.

¿Por qué usar MCP?

MCP conecta Cursor con sistemas y datos externos. En lugar de explicar la estructura de tu proyecto una y otra vez, intégrate directamente con tus herramientas. Escribe servidores MCP en cualquier lenguaje que pueda imprimir en stdout o exponer un endpoint HTTP: Python, JavaScript, Go, etc.

Cómo funciona

Los servidores MCP exponen capacidades a través del protocolo, conectando Cursor con herramientas externas y fuentes de datos. Cursor admite tres métodos de transporte:
TransporteEntorno de ejecuciónImplementaciónUsuariosEntradaAutenticación
stdioLocalGestionado por CursorUn solo usuarioComando de shellManual
SSELocal/RemotoImplementar como servidorVarios usuariosURL a un endpoint SSEOAuth
Streamable HTTPLocal/RemotoImplementar como servidorVarios usuariosURL a un endpoint HTTPOAuth

Compatibilidad con el protocolo

Cursor admite estas capacidades del protocolo MCP:
FunciónCompatibilidadDescripción
ToolsCompatibleFunciones que el modelo de IA puede ejecutar
PromptsCompatibleMensajes y flujos de trabajo con plantillas para usuaries
ResourcesCompatibleFuentes de datos estructuradas que se pueden leer y consultar
RootsCompatibleConsultas iniciadas por el servidor sobre los límites de URI o del sistema de archivos en los que operar
ElicitationCompatibleSolicitudes iniciadas por el servidor para obtener información adicional de les usuaries

Instalación de servidores MCP

Instalación con un clic

Instala servidores MCP de nuestra colección y autentícate con OAuth.

Uso de mcp.json

Configura servidores MCP personalizados con un archivo JSON:
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "mcp-server"],
      "env": {
        "API_KEY": "value"
      }
    }
  }
}

Configuración del servidor STDIO

Para servidores STDIO (servidores locales de línea de comandos), configura estos campos en tu mcp.json:
CampoRequeridoDescripciónEjemplos
typeTipo de conexión del servidor"stdio"
commandComando para iniciar el ejecutable del servidor. Debe estar disponible en la variable PATH de tu sistema o incluir su ruta completa."npx", "node", "python", "docker"
argsNoLista de argumentos pasados al comando["server.py", "--port", "3000"]
envNoVariables de entorno para el servidor{"API_KEY": "${input:api-key}"}
envFileNoRuta a un archivo de entorno para cargar más variables".env", "${workspaceFolder}/.env"

Uso de la API de extensión

Para registrar servidores MCP de forma programática, Cursor ofrece una API de extensión que permite una configuración dinámica sin modificar archivos mcp.json. Esto es especialmente útil en entornos empresariales y en flujos de configuración automatizados.

Referencia de la API de extensión de MCP

Aprende a registrar servidores MCP de forma programática usando vscode.cursor.mcp.registerServer()

Ubicaciones de configuración

Configuración del proyecto

Crea .cursor/mcp.json en tu proyecto para herramientas específicas del proyecto.

Configuración global

Crea ~/.cursor/mcp.json en tu directorio personal para tener las herramientas disponibles en cualquier lugar.

Interpolación de configuración

Usa variables en los valores de mcp.json. Cursor resuelve variables en estos campos: command, args, env, url y headers. Sintaxis admitida:
  • ${env:NAME} variables de entorno
  • ${userHome} ruta a tu carpeta personal
  • ${workspaceFolder} raíz del proyecto (la carpeta que contiene .cursor/mcp.json)
  • ${workspaceFolderBasename} nombre de la carpeta raíz del proyecto
  • ${pathSeparator} y ${/} separador de rutas del sistema operativo
Ejemplos
{
  "mcpServers": {
    "local-server": {
      "command": "python",
      "args": ["${workspaceFolder}/tools/mcp_server.py"],
      "env": {
        "API_KEY": "${env:API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "remote-server": {
      "url": "https://api.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MY_SERVICE_TOKEN}"
      }
    }
  }
}

Autenticación

Los servidores MCP usan variables de entorno para la autenticación. Pasa las claves de API y los tokens a través de la configuración. Cursor admite OAuth para los servidores que lo requieran.

Usar MCP en el chat

El Composer Agent utiliza automáticamente las herramientas MCP que aparecen en Available Tools cuando corresponde. Pide una herramienta específica por su nombre o describe lo que necesitas. Activa o desactiva herramientas desde Settings.

Activar o desactivar herramientas

Activa o desactiva herramientas MCP directamente desde la interfaz del chat. Haz clic en el nombre de una herramienta en la lista para activarla o desactivarla. Las herramientas desactivadas no se cargarán en el contexto ni estarán disponibles para Agent.

Aprobación de herramientas

De forma predeterminada, el agente solicita aprobación antes de usar herramientas MCP. Haz clic en la flecha junto al nombre de la herramienta para ver los argumentos.

Auto-run

Activa Auto-run para que Agent use las herramientas MCP sin pedir confirmación. Funciona como comandos de terminal. Lee más sobre la configuración de Auto-run aquí.

Respuesta de la herramienta

Cursor muestra la respuesta en el chat con vistas desplegables de los argumentos y las respuestas:

Imágenes como contexto

Los servidores MCP pueden devolver imágenes —capturas de pantalla, diagramas, etc.—. Devuélvelas como cadenas codificadas en base64:
const RED_CIRCLE_BASE64 = "/9j/4AAQSkZJRgABAgEASABIAAD/2w...";
// ^ base64 completo omitido para mejorar la legibilidad

server.tool("generate_image", async (params) => {
  return {
    content: [
      {
        type: "image",
        data: RED_CIRCLE_BASE64,
        mimeType: "image/jpeg",
      },
    ],
  };
});
Consulta este servidor de ejemplo para ver los detalles de implementación. Cursor adjunta las imágenes devueltas al chat. Si el modelo admite imágenes, las analiza.

Consideraciones de seguridad

Al instalar servidores MCP, ten en cuenta estas prácticas de seguridad:
  • Verifica el origen: Instala servidores MCP solo de desarrolladores y repositorios de confianza
  • Revisa los permisos: Comprueba a qué datos y APIs tendrá acceso el servidor
  • Limita las claves de API: Usa claves de API restringidas con los permisos mínimos necesarios
  • Audita el código: Para integraciones críticas, revisa el código fuente del servidor
Recuerda que los servidores MCP pueden acceder a servicios externos y ejecutar código en tu nombre. Asegúrate de entender qué hace un servidor antes de instalarlo.

Ejemplos del mundo real

Para ver ejemplos prácticos de MCP en acción, consulta nuestra guía de desarrollo web, donde mostramos cómo integrar Linear, Figma y herramientas del navegador en tu flujo de trabajo de desarrollo.

Preguntas frecuentes

Los servidores MCP conectan Cursor con herramientas externas como Google Drive, Notion y otros servicios para incorporar documentos y requisitos a tu flujo de trabajo de código.
Revisa los logs de MCP así: 1. Abre el panel Output en Cursor (Ctrl+Shift+U) 2. Selecciona “MCP Logs” en el menú desplegable 3. Busca errores de conexión, problemas de autenticación o caídas del servidor. Los logs muestran la inicialización del servidor, llamadas a herramientas y mensajes de error.
¡Sí! Activa o desactiva servidores sin quitarlos: 1. Abre Settings (Ctrl+Shift+J) 2. Ve a Features → Model Context Protocol 3. Haz clic en el interruptor junto a cualquier servidor para habilitar o deshabilitar. Los servidores deshabilitados no se cargan ni aparecen en el chat. Esto es útil para depurar o reducir el ruido de herramientas.
Si un servidor MCP falla: - Cursor muestra un mensaje de error en el chat - La llamada a la herramienta se marca como fallida - Puedes reintentar la operación o revisar los logs para ver detalles - Otros servidores MCP siguen funcionando con normalidad. Cursor aísla las fallas de servidores para evitar que uno afecte a los demás.
Para servidores basados en npm: 1. Quita el servidor desde Settings 2. Limpia la caché de npm: npm cache clean --force 3. Vuelve a agregar el servidor para obtener la versión más reciente. Para servidores personalizados, actualiza tus archivos locales y reinicia Cursor.
Sí, pero sigue las mejores prácticas de seguridad: - Usa variables de entorno para secretos; nunca los hardcodees - Ejecuta servidores sensibles localmente con transporte stdio - Limita los permisos de las API keys al mínimo necesario - Revisa el código del servidor antes de conectarlo a sistemas sensibles - Considera ejecutar los servidores en entornos aislados