Configuração do MCP

Como adicionar servidores MCP

Pela linha de comando

A maneira mais rápida de adicionar um servidor MCP:

# servidor stdio — apenas passe o comando após --
devin mcp add <name> -- <command> [args...]

# servidor HTTP — passe a URL como argumento posicional
devin mcp add <name> <URL>

# servidor HTTP — ou use a flag --url
devin mcp add <name> --url <URL>

O tipo de transporte é inferido automaticamente: uma URL implica HTTP (Streamable HTTP), e argumentos no final (ou --command) implicam stdio.

Servidores MCP remotos usam Streamable HTTP por padrão. Se o servidor responder com um erro HTTP 4xx, a CLI recorre a SSE na mesma URL. Defina "transport": "sse" explicitamente, se necessário — veja fallback legado para SSE abaixo.

Por padrão, os servidores são salvos no escopo local (.devin/config.local.json, ignorado pelo git). Use -s/--scope para alterar:

devin mcp add -s project <name> <URL>   # compartilhado via .devin/config.json
devin mcp add -s user <name> <URL>      # global (~/.config/devin/config.json; %APPDATA%\devin\config.json no Windows)

Você também pode gerenciar servidores pela linha de comando:

devin mcp list              # Listar todos os servidores configurados
devin mcp get <name>        # Exibir detalhes de um servidor específico
devin mcp remove <name>     # Remover um servidor configurado
devin mcp login <name>      # Autenticar com um servidor via OAuth
devin mcp logout <name>     # Remover credenciais OAuth armazenadas

Via arquivo de configuração

Adicione servidores diretamente à seção mcpServers do seu arquivo de configuração:

Configuração do projeto
Configuração do usuário
Override local

// .devin/config.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "your-key"
      }
    }
  }
}

Os servidores no nível do projeto são compartilhados com sua equipe por meio do controle de versão.

// ~/.config/devin/config.json
{
  "mcpServers": {
    "my-server": {
      "command": "node",
      "args": ["/path/to/my-server.js"],
      "env": {}
    }
  }
}

Os servidores no nível do usuário se aplicam a todos os seus projetos.

// .devin/config.local.json
{
  "mcpServers": {
    "server-name": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "env": {
        "API_KEY": "my-personal-key"
      }
    }
  }
}

As configurações locais não são rastreadas pelo Git — use-as para chaves de API pessoais.

Opções de configuração de servidor

Os servidores MCP podem ser configurados de duas formas: como um comando local (transporte stdio) ou como um servidor remoto (transporte HTTP).

Comando local (stdio)

Campo	Tipo	Obrigatório	Descrição
`command`	string	Sim	O executável que será executado
`args`	string[]	Não	Argumentos de linha de comando
`env`	object	Não	Variáveis de ambiente a definir

Servidor remoto (Streamable HTTP)

Campo	Tipo	Obrigatório	Descrição
`url`	string	Sim	A URL do endpoint do servidor MCP
`transport`	string	Não	`"http"` (Streamable HTTP, padrão para servidores baseados em URL) ou `"sse"` (SSE legado). Quando definido como `"http"` ou omitido, a CLI tenta primeiro Streamable HTTP e recorre ao SSE em caso de erros 4xx (conforme a especificação). Defina `"sse"` explicitamente se o endpoint SSE do servidor estiver em um caminho diferente.
`headers`	object	Não	Cabeçalhos HTTP personalizados para incluir nas requisições

Exemplos

GitHub (stdio)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_..."
      }
    }
  }
}

Notion (HTTP com OAuth)

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp",
      "transport": "http"
    }
  }
}

Depois de adicionar um servidor com OAuth, execute devin mcp login notion para se autenticar. Consulte Authentication abaixo.

Linear (HTTP com OAuth)

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/mcp",
      "transport": "http"
    }
  }
}

Atlassian / Jira (HTTP com OAuth)

{
  "mcpServers": {
    "atlassian": {
      "url": "https://mcp.atlassian.com/v1/mcp",
      "transport": "http"
    }
  }
}

Depois de adicionar, execute devin mcp login atlassian para se autenticar. Cada cliente MCP (Windsurf, Claude Code, Devin CLI) mantém sua própria sessão OAuth, então você precisa fazer login separadamente, mesmo que já tenha se autenticado em outra ferramenta.

Servidor personalizado (stdio)

{
  "mcpServers": {
    "my-tools": {
      "command": "python",
      "args": ["./scripts/mcp-server.py"],
      "env": {
        "DB_URL": "postgres://localhost/mydb"
      }
    }
  }
}

Autenticação

Alguns servidores MCP remotos exigem autenticação OAuth. Depois de adicionar um servidor com autenticação OAuth à sua configuração, autentique-se usando o comando login:

devin mcp login <server-name>

Por exemplo:

devin mcp login notion    # Autenticar com o Notion
devin mcp login linear    # Autenticar com o Linear

Isso abre uma janela do navegador na qual você pode autorizar o acesso. Os tokens OAuth são armazenados localmente e atualizados automaticamente. Se quiser, você pode solicitar escopos específicos do OAuth:

devin mcp login notion --scopes read,write

Para remover credenciais OAuth armazenadas para um servidor:

devin mcp logout <server-name>

Se o servidor oferecer suporte a OAuth, você também receberá automaticamente uma solicitação para se autenticar quando o servidor for usado pela primeira vez.

Gerenciando segredos

Nunca faça commit de Chaves de API ou segredos no controle de versão. Use .devin/config.local.json para armazenar valores sensíveis.

Para projetos em equipe, o padrão recomendado é:

Defina o servidor em .devin/config.json com marcadores de posição ou sem variáveis de ambiente
Cada membro da equipe adiciona suas chaves pessoais em .devin/config.local.json

O arquivo de configuração local é automaticamente excluído do Git.

Permissões do MCP

Você pode aprovar previamente, negar ou exigir confirmação para ferramentas específicas do MCP na sua configuração de permissões:

{
  "permissions": {
    "allow": [
      "mcp__github__list_issues",
      "mcp__github__create_issue"
    ],
    "deny": [
      "mcp__github__delete_repo"
    ],
    "ask": [
      "mcp__linear__*"
    ]
  }
}

Padrões de correspondência de permissão:

Padrão	Corresponde a
`mcp__server__tool`	Uma ferramenta específica em um servidor específico
`mcp__server__*`	Todas as ferramentas em um servidor específico
`mcp__*`	Todas as ferramentas MCP em todos os servidores

Solução de problemas

Autenticação necessária / erros de OAuth com servidores remotos

Se você vir erros como Auth required ou AuthRequired ao se conectar a um servidor MCP remoto, isso significa que o servidor exige autenticação OAuth.Execute:

devin mcp login <server-name>

Cada cliente MCP se autentica de forma independente. Mesmo que você já tenha se autenticado no Windsurf ou no Claude Code, é preciso executar devin mcp login separadamente no Devin CLI.Para verificar seu status de autenticação, tente remover e adicionar as credenciais novamente:

devin mcp logout <server-name>
devin mcp login <server-name>

O servidor não inicia

Verifique se o comando funciona fora do Devin CLI:

npx -y @modelcontextprotocol/server-github

Confira se todas as variáveis de ambiente obrigatórias estão definidas.

Ferramentas não aparecem

Peça ao agente para listar os servidores MCP e as ferramentas. O servidor pode precisar de alguns instantes para inicializar.

Permissão negada

Verifique a configuração das suas permissões. Por padrão, as ferramentas MCP pedem aprovação. Adicione-as a permissions.allow para aprová-las automaticamente.

fallback legado para SSE

Ao se conectar a um servidor HTTP, o Devin CLI tenta primeiro Streamable HTTP. Se o servidor responder com um erro HTTP 4xx (por exemplo, 404 ou 405), ele recorre automaticamente a SSE legado na mesma URL configurada. Isso segue a orientação de retrocompatibilidade da spec do MCP.O fallback só é acionado em respostas 4xx — erros de conexão, timeouts e respostas 5xx são reportados diretamente, sem tentativa de SSE.Se o endpoint de SSE do seu servidor estiver em um caminho diferente (por exemplo, /sse em vez de /mcp), defina "transport": "sse" com a URL de SSE para se conectar diretamente, sem tentar Streamable HTTP antes.Se ambos os transportes falharem, a mensagem de erro incluirá detalhes das duas tentativas para ajudar na solução de problemas.

Documentation Index

​Como adicionar servidores MCP

​Pela linha de comando

​Via arquivo de configuração

​Opções de configuração de servidor

​Comando local (stdio)

​Servidor remoto (Streamable HTTP)

​Exemplos

​Autenticação

​Gerenciando segredos

​Permissões do MCP

​Solução de problemas

Como adicionar servidores MCP

Pela linha de comando

Via arquivo de configuração

Opções de configuração de servidor

Comando local (stdio)

Servidor remoto (Streamable HTTP)

Exemplos

Autenticação

Gerenciando segredos

Permissões do MCP

Solução de problemas