MCP

Descripción general

La CLI de Cursor es compatible con servidores de Protocolo de contexto del modelo (MCP), lo que te permite conectar herramientas externas y fuentes de datos al agent. MCP en la CLI usa la misma configuración que el Editor; cualquier servidor MCP que hayas configurado funcionará en ambos.

Comandos de la CLI

Usa el comando agent mcp para gestionar los servidores MCP

Listar servidores configurados

Consulta todos los servidores MCP configurados y su estado actual:

agent mcp list

Esto abre un menú interactivo donde puedes explorar, activar y configurar servidores MCP de un vistazo. La lista muestra:

• Nombres e identificadores de los servidores
• Estado de la conexión (conectado/desconectado)
• Origen de la configuración (del proyecto o global)
• Método de transporte (stdio, HTTP, SSE)

También puedes usar el comando con barra /mcp list en modo interactivo para acceder a la misma interfaz.

Listar las herramientas disponibles

Consulta las herramientas proporcionadas por un servidor MCP específico:

agent mcp list-tools <identifier>

Esto muestra:

• Nombres y descripciones de las herramientas
• Parámetros obligatorios y opcionales
• Tipos y restricciones de los parámetros

Iniciar sesión en un servidor MCP

Autentícate con un servidor MCP configurado en tu mcp.json:

agent mcp login <identifier>

La CLI utiliza un flujo de inicio de sesión simplificado con gestión automática del callback. El agente obtiene acceso a los MCP autenticados en cuanto se completa el inicio de sesión.

Activar un servidor MCP

Activa un servidor MCP:

agent mcp enable <identifier>

Esto añade el servidor a la lista local de servidores aprobados.

Desactivar un servidor MCP

Desactiva un servidor MCP:

agent mcp disable <identifier>

Los servidores desactivados no se cargarán ni solicitarán aprobación.

Uso de MCP con Agent

Una vez configurados los servidores MCP (consulta la guía principal de MCP para la configuración), agent detecta y usa automáticamente las herramientas disponibles cuando son relevantes para tus solicitudes.

# Comprueba qué servidores MCP están disponiblesagent mcp list# Consulta qué herramientas ofrece un servidor concretoagent mcp list-tools playwright# Usa agent: utiliza automáticamente las herramientas MCP cuando resultan útilesagent -p "Navigate to google.com and take a screenshot of the search page"# Aprueba automáticamente todos los servidores MCP (omite las solicitudes de aprobación)agent --approve-mcps "query my database for recent errors"

La CLI sigue la misma precedencia de configuración que el Editor (proyecto → global → anidada) y detecta automáticamente configuraciones en directorios superiores.

MCP frente a ACP

Usa MCP cuando quieras que Cursor invoque herramientas y servicios externos. Usa ACP cuando quieras crear un cliente personalizado que se comunique con la propia CLI de Cursor mediante mensajes de protocolo.

Relacionado