¿Qué es MCP?

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

¿Por qué usar MCP?

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

Cómo funciona

Los servidores MCP exponen capacidades a través del protocolo, conectando Cursor a herramientas externas o fuentes de datos. Cursor soporta tres métodos de transporte:
TransporteEntorno de ejecuciónDespliegueUsuariosEntradaAutenticación
stdioLocalCursor gestionaUsuario únicoComando de shellManual
SSELocal/RemotoDesplegar como servidorMúltiples usuariosURL a un endpoint SSEOAuth
Streamable HTTPLocal/RemotoDesplegar como servidorMúltiples usuariosURL a un endpoint HTTPOAuth

Instalación de servidores MCP

Instalación con un clic

Instala servidores MCP de nuestra colección y autentica 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"
      }
    }
  }
}

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 home para herramientas disponibles en todas partes.

Autenticación

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

Usando MCP en el chat

El Composer Agent utiliza automáticamente las herramientas MCP listadas bajo Available Tools cuando es relevante. Solicita una herramienta específica por nombre o describe lo que necesitas. Habilita o deshabilita herramientas desde la configuración.

Alternar herramientas

Habilita o deshabilita herramientas MCP directamente desde la interfaz de chat. Haz clic en el nombre de una herramienta en la lista de herramientas para alternarla. Las herramientas deshabilitadas no se cargarán en el contexto ni estarán disponibles para el Agent.

Aprobación de herramientas

El Agent solicita aprobación antes de usar herramientas MCP por defecto. Haz clic en la flecha junto al nombre de la herramienta para ver los argumentos.

Ejecución automática

Habilita la ejecución automática para que el Agent use herramientas MCP sin preguntar. Funciona como los comandos de terminal. Lee más sobre el modo Yolo aquí.

Respuesta de herramientas

Cursor muestra la respuesta en el chat con vistas expandibles de argumentos y 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",
      },
    ],
  };
});
Ve este servidor de ejemplo para detalles de implementación. Cursor adjunta las imágenes devueltas al chat. Si el modelo soporta imágenes, las analiza.

Consideraciones de seguridad

Al instalar servidores MCP, considera estas prácticas de seguridad:
  • Verifica la fuente: Solo instala servidores MCP de desarrolladores y repositorios confiables
  • Revisa los permisos: Verifica qué datos y APIs accederá el servidor
  • Limita las claves API: Usa claves API restringidas con los permisos mínimos requeridos
  • 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. Siempre entiende lo que hace un servidor antes de instalarlo.

Ejemplos del mundo real

Para ejemplos prácticos de MCP en acción, consulta nuestra guía de Desarrollo Web que demuestra la integración de herramientas de Linear, Figma y navegador en tu flujo de trabajo de desarrollo.

Preguntas Frecuentes