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              # 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

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
`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.

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 client secret, 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 client secret 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/config.local.json (incluído no .gitignore). 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/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

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.

​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

​Clientes OAuth pré-registrados

​Override do recurso OAuth

​Ativando e desativando servidores

​Gerenciando segredos

​Permissões do MCP

​Restrições da organização

​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

Clientes OAuth pré-registrados

Override do recurso OAuth

Ativando e desativando servidores

Gerenciando segredos

Permissões do MCP

Restrições da organização

Solução de problemas