¿Qué es MCP?

Model Context Protocol (MCP) le permite a Cursor conectarse a herramientas y fuentes de datos externas.

¿Por qué usar MCP?

MCP conecta Cursor con sistemas y datos externos. En lugar de explicar tu estructura de 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 o fuentes de datos externas. Cursor admite tres métodos de transporte:
TransporteEntorno de ejecuciónDespliegueUsuariosEntradaAuth
stdioLocalCursor lo gestionaUn solo usuarioComando de shellManual
SSELocal/RemotoDespliegalo como servidorMúltiples usuariosURL a un endpoint SSEOAuth
Streamable HTTPLocal/RemotoDespliegalo como servidorMúltiples usuariosURL a un endpoint HTTPOAuth

Compatibilidad del 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 usuarios
RootsCompatibleConsultas iniciadas por el servidor sobre límites de URI o del sistema de archivos en los que operar
ElicitationCompatibleSolicitudes iniciadas por el servidor para información adicional de los usuarios

Instalación de servidores MCP

Instalación con un clic

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

Usando mcp.json

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

Usando la Extension API

Para el registro programático de servidores MCP, Cursor proporciona una Extension API que permite la configuración dinámica sin modificar archivos mcp.json. Esto es especialmente útil para entornos empresariales y flujos de configuración automatizados.

MCP Extension API Reference

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

Ubicaciones de configuración

Project Configuration

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

Global Configuration

Crea ~/.cursor/mcp.json en tu directorio de inicio para herramientas disponibles en todo el sistema.

Autenticación

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

Usar MCP en el chat

El Composer Agent usa automáticamente las herramientas MCP listadas en Available Tools cuando corresponde. Pide una herramienta específica por nombre o describe lo que necesitas. Activa o desactiva herramientas desde los ajustes.

Activar y 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 alternarla. Las herramientas desactivadas no se cargarán en el contexto ni estarán disponibles para el Agent.

Aprobación de herramientas

De forma predeterminada, Agent pide 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 el auto-run para que Agent use herramientas MCP sin preguntar. Funciona como comandos de terminal. Lee más sobre el modo Yolo aquí.

Respuesta de la herramienta

Cursor muestra la respuesta en el chat con vistas expandibles 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 recortado para 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 detalles de implementación. Cursor adjunta las imágenes devueltas al chat. Si el modelo admite imágenes, las analiza.

Consideraciones de seguridad

Cuando instales 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 API 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 desarrollo.

Preguntas frecuentes