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/mcp_config.local.json, ignorado pelo git). Use -s/--scope para alterar:

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

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

devin mcp list              # List all configured servers
devin mcp get <name>        # Show details for a specific server
devin mcp remove <name>     # Remove a configured server
devin mcp login <name>      # Authenticate with a server via OAuth
devin mcp logout <name>     # Remove stored OAuth credentials
devin mcp enable <name>     # Ativar um servidor desativado
devin mcp disable <name>    # Desativar um servidor sem removê-lo

Por arquivo de configuração

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

A localização do arquivo de configuração MCP mudou na v3000.3 (versão Local 3.6). As versões mais antigas (anteriores à v3000.3) armazenam servidores MCP na chave mcpServers dos arquivos de configuração principais (~/.config/devin/config.json, .devin/config.json, .devin/config.local.json). As versões mais recentes os armazenam em arquivos específicos nos mesmos locais: ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json no Windows), .devin/mcp_config.json e .devin/mcp_config.local.json. Todas as entradas de mcpServers encontradas nos arquivos de configuração principais são migradas automaticamente para os arquivos específicos durante a inicialização.

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

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

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

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

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

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

As configurações locais são ignoradas 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
`disabled`	boolean	Não	Defina como `true` para pular este servidor (consulte Ativando e desativando servidores)

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
`oauthClientId`	string	Não	ID do cliente OAuth pré-registrado, para servidores que não oferecem suporte ao registro dinâmico de clientes (DCR), por exemplo, GitHub. Consulte a seção “Clientes OAuth pré-registrados” abaixo.
`oauthClientSecret`	string	Não	Segredo do cliente OAuth, para clientes confidenciais. Use em conjunto com `oauthClientId`.
`oauthResource`	string	Não	Override do parâmetro `resource` da RFC 8707 enviado em requisições OAuth (padrão: a URL do servidor MCP). Defina como uma string vazia (`""`) para omitir o parâmetro por completo, para provedores que o rejeitam. Consulte override do recurso OAuth.
`disabled`	boolean	Não	Defina como `true` para pular este servidor (consulte Ativando e desativando servidores)

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 Autenticação 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.

Autenticação novamente

As credenciais OAuth armazenadas não duram para sempre: elas expiram, e um administrador pode revogá-las no provedor. Quando isso acontece, o servidor informa o estado auth-required em vez de se conectar, e suas ferramentas (e os prompts) deixam de ficar disponíveis até que você faça login novamente. Para autenticar-se novamente, limpe as credenciais armazenadas e execute o fluxo no navegador outra vez:

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

logout exclui os tokens persistidos desse servidor; login executa novamente o fluxo do OAuth e armazena tokens novos. Faça o mesmo após alterar oauthClientId, oauthClientSecret ou oauthResource — as credenciais emitidas com as configurações anteriores não são reutilizadas.

As integrações com o Editor que controlam o Devin CLI via ACP exibem o mesmo estado de autenticação necessária, com uma ação para autenticar-se novamente que limpa as credenciais armazenadas e reabre o fluxo no navegador — equivalente à combinação logout + login acima.

Clientes OAuth pré-registrados

A maioria dos servidores MCP baseados em OAuth oferece suporte ao registro dinâmico de clientes (DCR), então o Devin CLI se registra automaticamente e você não precisa fornecer nenhuma credencial de cliente. Alguns provedores (por exemplo, GitHub) não oferecem suporte a DCR e, em vez disso, exigem um cliente OAuth pré-registrado. Nesses casos, informe o ID do cliente — e o segredo do cliente OAuth, se for um cliente confidencial — por meio de oauthClientId / oauthClientSecret:

{
  "mcpServers": {
    "my-server": {
      "url": "https://mcp.example.com/mcp",
      "transport": "http",
      "oauthClientId": "Iv1.abc123def456",
      "oauthClientSecret": "${env:MY_MCP_CLIENT_SECRET}"
    }
  }
}

Quando oauthClientId é definido, o Devin CLI não faz o registro dinâmico do cliente e usa o cliente pré-registrado por você durante o fluxo do OAuth. Execute devin mcp login <name> (ou acione o primeiro uso) para se autenticar normalmente. Você também pode defini-los pela linha de comando ao adicionar um servidor ou fazer login nele:

devin mcp add my-server <URL> --oauth-client-id <ID> --oauth-client-secret <SECRET>
devin mcp login my-server --oauth-client-id <ID> --oauth-client-secret <SECRET>

oauthClientId / oauthClientSecret são credenciais de cliente OAuth usadas durante o fluxo de autorização. Não são credenciais genéricas para cada requisição — se um servidor espera um token estático, use headers (HTTP) ou env (stdio).

Não faça commit de um segredo do cliente OAuth em uma configuração compartilhada. Referencie-o a partir de uma variável de ambiente (${env:VAR}), leia-o de um arquivo (${file:/path}) ou coloque-o em .devin/mcp_config.local.json (ignorado pelo Git). Consulte a seção “Gerenciando segredos” abaixo.

Override do recurso OAuth

Durante a autorização OAuth e a troca de tokens, o Devin CLI envia um parâmetro resource da RFC 8707 para que o servidor de autorização possa emitir tokens restritos à audiência. Por padrão, o valor é a URL do servidor MCP. Para substituí-lo, use oauthResource:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "transport": "http",
      "oauthResource": ""
    }
  }
}

O campo tem três comportamentos:

Não definido (padrão): envia resource com a URL do servidor MCP.
Valor não vazio: substitui o padrão pelo valor especificado (por exemplo, um URI de ID de app específico).
String vazia (""): omite totalmente o parâmetro resource tanto da URL de autorização quanto da troca de token.

Você também pode defini-lo pela linha de comando ao adicionar ou fazer login em um servidor:

devin mcp add my-server <URL> --oauth-resource ""
devin mcp login my-server --oauth-resource ""

Assim como outros campos do OAuth, oauthResource oferece suporte à expansão de ${env:VAR} e ${file:/path}.

Ativando e desativando servidores

Você pode desativar temporariamente um servidor MCP sem remover sua configuração. Um servidor desativado é ignorado durante a descoberta de ferramentas — suas ferramentas não aparecerão, e o processo do servidor não será iniciado.

devin mcp disable <name>    # Desativar um servidor
devin mcp enable <name>     # Reativá-lo

Isso define a flag "disabled": true na entrada do servidor no arquivo de configuração. Use -s/--scope para selecionar um escopo específico:

devin mcp disable -s project my-server
devin mcp enable -s user my-server

Também é possível definir a flag diretamente no arquivo de configuração:

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": ["-y", "@company/mcp-server"],
      "disabled": true
    }
  }
}

Desabilitar é útil quando você quer manter a configuração de um servidor (incluindo variáveis de ambiente e credenciais OAuth), mas deixar de usá-lo temporariamente — por exemplo, para reduzir o tempo de inicialização ou isolar um problema.

Gerenciando segredos

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

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

Defina o servidor em .devin/mcp_config.json com marcadores de posição ou sem variáveis de ambiente
Cada membro da equipe adiciona suas chaves pessoais em .devin/mcp_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

Prompts

Os prompts não exigem configuração própria: qualquer servidor conectado que declare o recurso MCP prompts adiciona automaticamente comandos de barra /mcp__<server>__<prompt>. Como o nome do comando inclui o nome do servidor, renomear um servidor em mcpServers também renomeia seus comandos de prompt. Consulte Visão geral do MCP — Prompts como comandos de barra.

Restrições da organização

Se você faz parte de uma equipe Enterprise, seu administrador pode restringir a quais servidores MCP você pode se conectar. Um servidor que você configurou pode ser bloqueado se o MCP estiver desativado para a sua equipe ou se ele não estiver na lista de permissões da equipe nem em um registro de MCP aplicado — nesse caso, ele não se conectará e suas ferramentas não ficarão disponíveis. Consulte Configurações da equipe — registro de MCP para mais detalhes.

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.

Erros de OAuth devido ao parâmetro resource

Alguns servidores de autorização rejeitam requisições OAuth que incluem o parâmetro resource da RFC 8707. Defina oauthResource como uma string vazia para omitir o parâmetro:

{
  "mcpServers": {
    "my-server": {
      "url": "https://my-server.example.com/mcp",
      "oauthResource": ""
    }
  }
}

Em seguida, autentique-se novamente:

devin mcp logout my-server
devin mcp login my-server

Consulte override do recurso OAuth para ver o conjunto completo de comportamentos de oauthResource.

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.

Primeiros passos

Integrações do Editor

Extensibilidade

Enterprise

Referência

Changelog

Configuração do MCP

Como adicionar servidores MCP

Pela linha de comando

Por arquivo de configuração

Opções de configuração de servidor

Comando local (stdio)

Servidor remoto (Streamable HTTP)

Exemplos

Autenticação

Autenticação novamente

Clientes OAuth pré-registrados

Override do recurso OAuth

Ativando e desativando servidores

Gerenciando segredos

Permissões do MCP

Prompts

Restrições da organização

Solução de problemas

​Como adicionar servidores MCP

​Pela linha de comando

​Por arquivo de configuração

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

​Comando local (stdio)

​Servidor remoto (Streamable HTTP)

​Exemplos

​Autenticação

​Autenticação novamente

​Clientes OAuth pré-registrados

​Override do recurso OAuth

​Ativando e desativando servidores

​Gerenciando segredos

​Permissões do MCP

​Prompts

​Restrições da organização

​Solução de problemas

Como adicionar servidores MCP

Pela linha de comando

Por arquivo de configuração

Opções de configuração de servidor

Comando local (stdio)

Servidor remoto (Streamable HTTP)

Exemplos

Autenticação

Autenticação novamente

Clientes OAuth pré-registrados

Override do recurso OAuth

Ativando e desativando servidores

Gerenciando segredos

Permissões do MCP

Prompts

Restrições da organização

Solução de problemas