MCP

Visão geral

A CLI do Cherri Code oferece suporte a servidores Model Context Protocol (MCP), permitindo conectar ferramentas externas e fontes de dados ao agente. O MCP na CLI usa a mesma configuração do Editor — todos os servidores MCP configurados funcionarão em ambos.

Comandos da CLI

Use o comando agent mcp para gerenciar servidores MCP

Listar servidores configurados

Veja todos os servidores MCP configurados e o status atual deles:

agent mcp list

Isso abre um menu interativo onde você pode visualizar, ativar e configurar servidores MCP de uma só vez. A lista 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)

Você também pode usar o comando slash /mcp list no modo interativo para acessar a mesma interface.

Listar ferramentas disponíveis

Veja as ferramentas disponibilizadas por um servidor MCP específico:

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 em um servidor MCP

Autentique-se em um servidor MCP configurado no seu mcp.json:

agent mcp login <identifier>

A CLI usa um fluxo de login simplificado com tratamento automático de callback. O agente tem acesso aos MCPs autenticados assim que o login é concluído.

Habilitar servidor MCP

Habilite um servidor MCP:

agent mcp enable <identifier>

Isso adiciona o servidor à lista local de servidores aprovados.

Desativar servidor MCP

Desative um servidor MCP:

agent mcp disable <identifier>

Servidores desativados não serão carregados nem solicitarão aprovação.

Usando MCP com o agente

Depois de configurar os servidores MCP (consulte o guia principal do MCP para a configuração), o agent detecta e usa automaticamente as ferramentas disponíveis quando forem relevantes para suas solicitações.

# Verifique quais servidores MCP estão disponíveisagent mcp list# Veja quais ferramentas um servidor específico ofereceagent mcp list-tools playwright# Use o agente — ele usa ferramentas MCP automaticamente quando necessárioagent -p "Navigate to google.com and take a screenshot of the search page"# Aprove automaticamente todos os servidores MCP (ignore os prompts de aprovação)agent --approve-mcps "query my database for recent errors"

A CLI segue a mesma ordem de prioridade de configuração do Editor (projeto → global → aninhada), descobrindo automaticamente configurações em diretórios pai.

MCP vs. ACP

Use o MCP quando quiser que o Cherri Code chame ferramentas e serviços externos. Use o ACP quando quiser criar um cliente personalizado que se comunique com a própria CLI do Cherri Code por meio de mensagens de protocolo.

Relacionados