Adicionando um novo MCP
Os servidores MCP do Cascade são adicionados editando diretamente o arquivomcp_config.json (veja a seção mcp_config.json abaixo).
Para abrir o arquivo, clique no menu ... (GitHub Actions) no canto superior direito do painel do Cascade e, em seguida, clique no
ícone Open MCP config file na seção MCPs. Adicione uma entrada para cada servidor em mcpServers e salve o arquivo.
stdio, Streamable HTTP e SSE.
O Devin Desktop também oferece suporte a OAuth para cada tipo de transporte.
Para servidores http, a URL deve corresponder à do endpoint e seguir um formato como https://<your-server-url>/mcp.
Configurando ferramentas MCP
Cada MCP tem acesso a um determinado número de ferramentas. O Cascade tem um limite de 100 ferramentas no total às quais pode ter acesso a qualquer momento. A seção MCPs do menu... (GitHub Actions) do painel do Cascade lista os servidores que você configurou e quantas ferramentas cada um tem ativadas.
Use o controle ao lado de um servidor para ativá-lo ou desativá-lo.
Para desativar ferramentas individuais, liste seus nomes no array disabledTools do servidor em mcp_config.json:
mcp_config.json
O arquivomcp_config.json é um arquivo JSON que contém uma lista de servidores aos quais o Cascade pode se conectar. Ele fica em:
- macOS / Linux:
~/.config/devin/mcp_config.json(ou$XDG_CONFIG_HOME/devin/mcp_config.jsonseXDG_CONFIG_HOMEestiver definido) - Windows:
%APPDATA%\devin\mcp_config.json
Exemplos populares de servidores MCP
A seguir, estão alguns exemplos de configuração de servidores MCP usados com frequência. Eles podem ser adicionados ao arquivomcp_config.json.
GitHub
Gerenciamento de repositórios, operações de arquivo e integração com a API do GitHub.
GitHub
Gerenciamento de repositórios, operações de arquivo e integração com a API do GitHub.
Slack
Gerenciamento de canais e recursos de mensagens para workspaces do Slack.
Slack
Gerenciamento de canais e recursos de mensagens para workspaces do Slack.
- Crie um Slack App em api.slack.com/apps
- Adicione os escopos OAuth necessários (por exemplo,
channels:read,chat:write,users:read) - Instale o app no seu workspace e copie o Bot User OAuth Token
PostgreSQL
Acesso somente leitura ao banco de dados com recursos de inspeção de esquema.
PostgreSQL
Acesso somente leitura ao banco de dados com recursos de inspeção de esquema.
Filesystem
Operações seguras com arquivos e controles de acesso configuráveis.
Filesystem
Operações seguras com arquivos e controles de acesso configuráveis.
Brave Search
Pesquisa na web e local usando a Search API do Brave.
Brave Search
Pesquisa na web e local usando a Search API do Brave.
Memory
Sistema de memória persistente baseado em grafo de conhecimento.
Memory
Sistema de memória persistente baseado em grafo de conhecimento.
MCPs HTTP remotos
É importante observar que, para MCPs HTTP remotos, a configuração é um pouco diferente e exige um camposerverUrl ou url.
Aqui está um exemplo de configuração para um servidor HTTP:
Interpolação na configuração
O arquivomcp_config.json oferece suporte à interpolação de variáveis
nos seguintes campos: command, args, env, serverUrl, url e
headers. Isso permite evitar incluir segredos diretamente no arquivo de configuração.
Há suporte a dois padrões de interpolação:
${env:VAR_NAME}— substituído pelo valor da variável de ambienteVAR_NAME. Se a variável não estiver definida, será resolvido como uma string vazia.${file:/path/to/file}— substituído pelo conteúdo do arquivo no caminho especificado, com os espaços em branco no início e no fim removidos. Há suporte a caminhos com til (~) (por exemplo,~/secrets/key.txt). Se não for possível ler o arquivo, o padrão permanecerá inalterado.
headers:
Controles administrativos (Teams & Enterprises)
Os administradores da equipe podem ativar ou desativar o acesso ao MCP para a equipe, bem como adicionar à lista de permissões os servidores MCP aprovados para uso da equipe:Registro de MCP
Equipes Enterprise podem configurar registros de MCP personalizados para substituir o MCP Marketplace padrão do Devin Desktop usado pelo agente local do Devin. As equipes podem vincular as URLs dos próprios registros para controlar quais MCPs ficam disponíveis para seus usuários. O Cascade não tem marketplace, então os registros não alteram o que os usuários do Cascade veem; use a lista de permissões de MCP para restringir os servidores do Cascade.Configurando registros personalizados
- Acesse as configurações da sua equipe
- Encontre a configuração URLs de registro de MCP
- Adicione uma ou mais URLs de registro
Lista de permissões de MCP
Configurações de MCP da equipe
mcp_config.json do usuário.Como funciona a correspondência de servidores
Quando você coloca um servidor MCP na lista de permissões, o sistema usa correspondência por padrão regex com as seguintes regras:- Correspondência da string completa: todos os padrões são ancorados automaticamente (envolvidos por
^(?:pattern)$) para evitar correspondências parciais - Campo Command: deve corresponder exatamente ou de acordo com o seu padrão regex
- Array Arguments: cada argumento é comparado individualmente com seu padrão correspondente
- Comprimento do array: o número de argumentos deve corresponder exatamente entre a lista de permissões e a configuração do usuário
- Caracteres especiais: caracteres como
$,.,[,],(,)têm significado especial em regex e devem ser escapados com\\se você quiser uma correspondência literal
Opções de configuração
Opção 1: Apenas o ID do servidor (recomendado)
Deixe o campo Configuração do servidor (JSON) vazio para permitir qualquer configuração que use esse ID de servidor.
Opção 1: Apenas o ID do servidor (recomendado)
Deixe o campo Configuração do servidor (JSON) vazio para permitir qualquer configuração que use esse ID de servidor.
- ID do servidor:
github-mcp-server - Configuração do servidor (JSON): (deixe em branco)
mcp_config.json):Opção 2: Configuração de correspondência exata
Forneça a configuração exata que os usuários devem usar. Eles devem corresponder exatamente a essa configuração.
Opção 2: Configuração de correspondência exata
Forneça a configuração exata que os usuários devem usar. Eles devem corresponder exatamente a essa configuração.
- ID do servidor:
github-mcp-server - Configuração do servidor (JSON):
mcp_config.json):command ou args será bloqueada. A seção env pode ter valores diferentes.Opção 3: Padrões regex flexíveis
Use padrões regex para permitir variações nas configurações dos usuários, mantendo os controles de segurança.
Opção 3: Padrões regex flexíveis
Use padrões regex para permitir variações nas configurações dos usuários, mantendo os controles de segurança.
- ID do servidor:
python-mcp-server - Configuração do servidor (JSON):
mcp_config.json):- A regex
/.*\\.pycorresponde a qualquer caminho de arquivo Python, como/home/user/my_server.py - A regex
[0-9]+corresponde a qualquer porta numérica, como8080ou3000 - Os usuários podem personalizar caminhos de arquivo e portas, enquanto os admins garantem que apenas scripts Python sejam executados
Padrões comuns de regex
Notas
Diretrizes de configuração do Admin
- Variáveis de ambiente: A seção
envnão é verificada com regex e pode ser configurada livremente pelos usuários - Ferramentas desativadas: O array
disabledToolsé tratado separadamente e não faz parte da correspondência da lista de permissões - Diferenciação entre maiúsculas e minúsculas: Todas as correspondências diferenciam maiúsculas de minúsculas
- Tratamento de erros: Padrões de regex inválidos serão registrados em log e resultarão na negação de acesso
- Testes: Teste seus padrões de regex com cuidado — padrões excessivamente restritivos podem bloquear casos de uso legítimos
Solução de problemas
Se os usuários relatarem que seus servidores MCP não estão funcionando após a inclusão na lista de permissões:- Verifique a Correspondência Exata: Certifique-se de que o padrão da lista de permissões corresponda exatamente à configuração do usuário
- Verifique o Escape de Regex: Caracteres especiais podem precisar de escape (ex.:
\.para pontos literais) - Revise os Logs: Padrões de regex inválidos são registrados nos logs com avisos
- Teste os Padrões: Use um testador de regex para verificar se seus padrões funcionam como esperado
Informações gerais
- Como chamadas de ferramentas do MCP podem invocar código escrito por implementadores de servidores diversos, não nos responsabilizamos por falhas nessas chamadas de ferramentas do MCP. Reforçando:
- No momento, oferecemos suporte às ferramentas, aos recursos e aos prompts de um servidor MCP.

