Visão geral

A CLI do Cursor é compatível com servidores do Model Context Protocol (MCP), permitindo conectar ferramentas externas e fontes de dados ao cursor-agent. O MCP na CLI usa a mesma configuração do editor — quaisquer servidores MCP que tu tiveres configurado vão funcionar perfeitamente em ambos.

Aprender sobre o MCP

Novo no MCP? Lê o guia completo sobre configuração, autenticação e servidores disponíveis

Comandos da CLI

Usa o comando cursor-agent mcp para gerenciar servidores MCP:

Listar servidores configurados

Vê todos os servidores MCP configurados e o status atual de cada um:
cursor-agent mcp list
Isso mostra:
  • Nomes e identificadores dos servidores
  • Status da conexão (conectado/desconectado)
  • Origem da configuração (projeto ou global)
  • Método de transporte (stdio, HTTP, SSE)

Listar ferramentas disponíveis

Vê as ferramentas fornecidas por um servidor MCP específico:
cursor-agent mcp list-tools <identifier>
Isso exibe:
  • Nomes e descrições das ferramentas
  • Parâmetros obrigatórios e opcionais
  • Tipos e restrições dos parâmetros

Fazer login no servidor MCP

Autentica num servidor MCP configurado no teu mcp.json:
cursor-agent mcp login <identifier>

Desabilitar servidor MCP

Remove um servidor MCP da lista local de aprovados:
cursor-agent mcp disable <identifier>

Usando MCP com o Agent

Depois que você configurar servidores MCP (confere o guia principal do MCP para a configuração), o cursor-agent descobre e usa automaticamente as ferramentas disponíveis quando elas forem relevantes pros teus pedidos.
# Ver quais servidores MCP estão disponíveis
cursor-agent mcp list

# Ver quais ferramentas um servidor específico fornece
cursor-agent mcp list-tools playwright

# Usar o cursor-agent — ele usa ferramentas MCP automaticamente quando for útil
cursor-agent --prompt "Navigate to google.com and take a screenshot of the search page"
A CLI segue a mesma precedência de configuração do editor (projeto → global → aninhado), descobrindo automaticamente configurações dos diretórios superiores.