Integrações MCP
O MCP (Model Context Protocol) conecta o Cherri Code a ferramentas externas e fontes de dados. Integre bancos de dados, APIs e serviços como GitHub, Linear ou Notion para que o agente possa usá-los durante as conversas.
O que é um servidor MCP?
Um servidor MCP disponibiliza ferramentas e fontes de dados ao Cherri Code por meio do Model Context Protocol. O agente pode usar essas ferramentas diretamente durante uma conversa no chat.
O Cherri Code oferece suporte a Apps do MCP?
Sim. O Cherri Code oferece suporte à extensão Apps do MCP, permitindo que as ferramentas MCP retornem uma interface interativa no chat.
Se a interface do app não estiver disponível, a mesma ferramenta continuará funcionando por meio de respostas MCP convencionais.
Como faço para instalar um servidor MCP (com um clique)?
- Abra Personalizar na barra lateral
- Clique em MCPs
- Navegue pelos servidores disponíveis ou procure o que deseja
- Clique em Adicionar ao Cherri Code ao lado do servidor
- Siga as instruções de autenticação, se necessário
O servidor está conectado. O agente usa as ferramentas dele quando relevante para suas solicitações.
Como faço para instalar manualmente um servidor MCP?
Crie um arquivo chamado mcp.json em um destes locais:
- Específico do projeto (compartilhado com sua equipe):
.cursor/mcp.jsonna pasta do projeto. Faça commit desse arquivo no Git para que os membros da equipe tenham as mesmas ferramentas. - Global (pessoal, para todos os projetos):
~/.cursor/mcp.jsonno seu diretório home
Os dois arquivos são combinados. Se o mesmo nome de servidor aparecer em ambos, a configuração específica do projeto terá prioridade.
Para servidores locais, adicione a configuração do servidor com um command:
{ "mcpServers": { "server-name": { "command": "npx", "args": ["-y", "mcp-server"], "env": { "API_KEY": "your-key-here" } } }}Alguns servidores MCP (como bancos de dados hospedados ou APIs personalizadas) fornecem uma URL em vez de um comando local. Adicione-os usando o campo url:
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse" } }}Se o servidor exigir cabeçalhos de autenticação, adicione-os em headers:
{ "mcpServers": { "my-service": { "url": "https://mcp.example.com/sse", "headers": { "Authorization": "Bearer your-token-here" } } }}Salve o arquivo e reinicie o Cherri Code.
Como uso ferramentas MCP no chat?
O agente detecta automaticamente as ferramentas MCP e as usa quando necessário. Ative ou desative ferramentas clicando no nome delas na lista de ferramentas na parte superior do painel de chat.
Por padrão, o agente solicita sua aprovação antes de usar uma ferramenta MCP. No Cherri Code 3.6 e versões posteriores, o modo Auto-review padrão em Cherri Code Settings > Agents > Approvals & Execution permite que ferramentas MCP incluídas na lista de permissão sejam executadas imediatamente e encaminha as demais a um classificador de segurança; Allowlist mantém o comportamento antigo, baseado apenas na lista de permissão. Para pré-configurar quais ferramentas podem ser executadas sem aprovação ou orientar o classificador Auto-review fora da interface, consulte permissions.json.
Como soluciono problemas com servidores MCP?
- Ver logs: Abra o painel Saída (CmdCtrl + Shift + U no Mac, Ctrl + Shift + U no Windows/Linux) e selecione MCP Logs
- Ativar/desativar servidores: Abra Personalizar > MCPs. Clique no controle ao lado de qualquer servidor.
- Reiniciar: Remova o servidor em Personalizar > MCPs e adicione-o novamente
- Variáveis de ambiente: Se o servidor depende de variáveis de ambiente definidas no perfil do shell, verifique se elas estão disponíveis no Cherri Code. Reinicie o Cherri Code após atualizar o perfil do shell.
Os servidores MCP funcionam com agentes na nuvem?
Sim. Os agentes na nuvem oferecem suporte a servidores MCP configurados no dashboard dos agentes na nuvem. No plano Team, os admins podem configurar servidores compartilhados em Dashboard -> Plugins & MCPs.
Os admins podem selecionar Add to Team Marketplace em Team MCP Servers para disponibilizar os mesmos servidores na Agent Window, na IDE e na CLI. Assim, eles também ficam disponíveis para os agentes na nuvem. Consulte ferramentas MCP do Cloud Agent e Migrar MCPs de equipe existentes para mais detalhes.
Onde encontrar servidores MCP para instalar?
Navegue pelo Cherri Code Marketplace para encontrar plugins oficiais e instalá-los com um clique. Para plugins da comunidade e servidores MCP, navegue pelo cursor.directory.