Por que usar MCP?
- vasculhar logs do Sentry, Datadog e Vercel
- usar o Devin como analista de dados no Slack com MCPs de banco de dados
- investigar problemas no SonarQube, CircleCI e Jam
- criar em massa tickets no Linear, documentos no Notion, Google Docs (via Zapier) e mais
- trazer contexto de e interagir com Airtable, Stripe e Hubspot
- muito mais!
Comece a usar MCPs
Use o Devin para análise de dados no Slack conectando-o a MCPs de banco de dados
Confira nosso guia passo a passo!
Saiba como a equipe da Cognition usa o Devin com MCPs
Saiba como usamos o Devin como analista de dados e com ferramentas como Datadog, Sentry, Linear, Figma e Google Sheets.
Dicas de configuração
Para MCPs que fazem autenticação via OAuth, o Devin solicitará que você acesse uma URL para conectar sua conta. Recomendamos fortemente o uso de uma conta de serviço, e não da sua conta pessoal, já que o acesso será compartilhado com a sua organização.
Não encontra o MCP que está procurando? Configure-o usando a opção “Add Your Own”!Está com problemas? Fale conosco pela nossa página de suporte ou pelo e-mail support@cognition.ai.
Configurando um servidor MCP personalizado
| Transporte | Melhor para | Campos obrigatórios |
|---|---|---|
| STDIO | Servidores locais baseados em CLI (por exemplo, npx, uvx, Docker) | Comando, argumentos, variáveis de ambiente |
| SSE | Servidores remotos usando Server-Sent Events | URL do servidor, cabeçalhos |
| HTTP | Servidores remotos usando Streamable HTTP | URL do servidor, cabeçalhos |
Passo a passo: adicionando um servidor MCP personalizado
- Acesse Settings > MCP Marketplace.
- Clique em Add Your Own no topo da página.
- Preencha os detalhes do servidor:
- Server Name: Um nome descritivo para o servidor (por exemplo, “Internal API Gateway”).
- Icon (opcional): Um emoji ou URL para usar como ícone do servidor.
- Short Description: Um breve resumo do que o servidor faz.
- Selecione o transport type (STDIO, SSE ou HTTP).
- Preencha os campos de configuração específicos do transporte (veja o Configuration format abaixo).
- Clique em Save para criar o servidor.
- Clique em Test listing tools para verificar a conexão. Devin criará um ambiente de teste isolado, vai se conectar ao seu servidor e tentará descobrir as ferramentas disponíveis.
O botão Test listing tools ficará desativado até que você salve sua configuração. Se a validação falhar, verifique a mensagem de erro exibida — ela indicará se o problema está na conectividade, autenticação ou em um timeout.
Formato de configuração
Os exemplos abaixo mostram representações em JSON dos campos de configuração de cada transporte. Na prática, você preenche esses campos por meio do formulário na interface web — não é necessário escrever ou colar JSON. O formato JSON é mostrado aqui para fins de clareza e como referência para configurações baseadas em API ou programáticas.
Transporte STDIO
- Command (obrigatório): O executável a ser iniciado (por exemplo,
npx,uvx,docker). - Arguments: Argumentos de linha de comando passados para o servidor.
- Environment Variables: Pares chave-valor definidos no ambiente de processo do servidor. Use-as para passar chaves de API, tokens ou valores de configuração.
npx:
Transportes SSE e HTTP
- Server URL (obrigatório): A URL do endpoint do servidor MCP.
- Authentication method: Escolha entre
None,Auth HeaderouOAuth.- Para Auth Header: Forneça a chave do cabeçalho (padrão
Authorization) e o valor do cabeçalho (por exemplo,Bearer your-token). - Para OAuth: Devin solicitará que você conclua um fluxo OAuth durante sua primeira sessão.
- Para Auth Header: Forneça a chave do cabeçalho (padrão
Padrões comuns
Conectando a uma API interna
Conectar-se a um banco de dados
Para bancos de dados de produção, use uma string de conexão somente leitura ou um usuário de banco de dados com permissões restritas. Devin executa consultas com base nas instruções do usuário, por isso é importante restringir corretamente o acesso.
Conectando a uma ferramenta ou script personalizados
uvx:
Usando variáveis de ambiente para segredos
Solucionando problemas em servidores MCP personalizados
”Test listing tools” falhou
| Sintoma | Causa provável | Correção |
|---|---|---|
| ”Verify server URL and network connectivity” | A URL do servidor está inacessível | Verifique se a URL está correta e acessível na internet (ou na rede do Devin, se estiver usando VPN) |
| “Check authentication credentials and permissions” | Credenciais de autenticação inválidas ou ausentes | Verifique sua chave de API, token ou configuração de OAuth |
| ”Server took too long to respond - check server status” | O servidor não respondeu dentro do tempo limite | Confirme que o servidor está em execução e responsivo; verifique se há regras de firewall bloqueando a conexão |
| ”MCP server validation failed” (genérico) | Comando não encontrado, dependências ausentes ou falha do servidor | Para servidores STDIO, verifique se o comando existe e é executado localmente; confira se todas as variáveis de ambiente necessárias estão definidas |
O servidor se conecta, mas as ferramentas não estão disponíveis
- Verifique se o servidor implementa corretamente o método
tools/listdo protocolo MCP. - Para servidores STDIO, certifique-se de que o processo escreva mensagens JSON-RPC válidas em stdout e leia de stdin — logs ou saída de depuração em stdout vão interromper o protocolo.
- Confira se as variáveis de ambiente estão configuradas corretamente. Valores ausentes (por exemplo, uma chave de API em branco) podem fazer com que o servidor inicie, mas falhe ao registrar ferramentas.
Problemas de autenticação OAuth
- Quando for solicitado a se autenticar, conclua o fluxo OAuth na janela do navegador que for aberta. Devin aguardará o callback.
- Se a autenticação falhar, verifique se o URI de redirecionamento OAuth está configurado corretamente no provedor.
- Somente administradores da organização podem autenticar servidores MCP baseados em OAuth. Se você receber um erro de permissão, entre em contato com o administrador da sua organização.
Para MCPs baseados em OAuth, use uma conta de serviço em vez da sua conta pessoal. O acesso é compartilhado em toda a sua organização, e todas as sessões dos membros usarão a mesma conexão autenticada.
Dicas gerais de depuração
- Verifique o servidor localmente primeiro. Antes de adicionar um servidor personalizado ao Devin, confirme que ele funciona executando o comando ou acessando a URL a partir da sua própria máquina.
- Revise os logs de sessão do Devin. Se um servidor falhar durante uma sessão, o Devin registrará o erro. Procure mensagens relacionadas a MCP na saída da sessão.
- Simplifique e itere. Comece com a configuração mínima (por exemplo, sem autenticação, configurações padrão) e adicione complexidade depois que a conexão básica estiver funcionando.
- Verifique as variáveis de ambiente. Um problema comum é a ausência de variáveis de ambiente ou nomes incorretos. Confira se cada variável necessária está definida na configuração.
MCPs do Marketplace
Vercel, Atlassian, Notion, Sentry, Neon, Asana, Jam e muito mais
- AlloyDB
- Asana
- Atlassian
- BigQuery
- Cloud SQL (MySQL)
- Cloud SQL (PostgreSQL)
- Cloud SQL (SQL Server)
- Cloudflare
- Cortex
- Dataplex
- Fireflies
- Firestore
- Jam
- Linear
- Looker
- Metabase
- MySQL
- Neon
- Notion
- PostgreSQL
- Prisma
- Sentry
- Spanner
- SQL Server
- Vercel
- Veja mais abaixo!
Linear: Se você tiver a integração com Linear conectada, o Devin já conta com ferramentas nativas do Linear e você não precisará configurar o MCP do Linear separadamente.
Datadog
- DATADOG_API_KEY - chave de API do Datadog, que pode ser encontrada na página /organization-settings/api-keys do Datadog
- DATADOG_APP_KEY - chave de aplicação do Datadog, que pode ser encontrada na página /organization-settings/application-keys do Datadog
Slack
Para começar, acesse api.slack.com/apps e selecione seu app. Em seguida:
- Na barra lateral, vá até OAuth & Permissions
- Procure o Bot User OAuth Token (ele deve começar com “xoxb-”).
- Se você não encontrar o seu Bot User OAuth Token, verifique se configurou tokens em nível de app (em Settings > Basic Information), adicionou pelo menos 1 scope (em Settings > OAuth & Permissions) e instalou seu app no espaço de trabalho.
- Use o comando curl:
curl -H "Authorization: Bearer xoxb-your-token" https://slack.com/api/auth.test, em quexoxb-your-tokendeve ser substituído pelo seu token OAuth
- Use o comando curl:
curl -H "Authorization: Bearer xoxb-your-token" https://slack.com/api/conversations.list, em quexoxb-your-tokendeve ser substituído pelo seu token OAuth - Para que esse comando funcione, você precisará adicionar pelo menos os seguintes scopes: channels:read,groups:read,mpim:read,im:read
Supabase
Figma
- Na página inicial do Figma, clique no ícone de perfil no canto superior esquerdo e selecione Settings no menu suspenso.
- No menu de configurações, selecione a guia Security.
- Role até a seção Personal access tokens e clique em Generate new token.
- Insira um nome para o token e certifique-se de conceder as permissões apropriadas. Recomendamos pelo menos permissões de leitura em File content e Dev resources.
- Clique em Generate token.
Stripe
Bearer <TOKEN>, onde <TOKEN> é sua chave de API do Stripe. Mais informações em: https://docs.stripe.com/mcp#bearer-token
Documentação
Zapier
Bearer <TOKEN>.
Você precisará extrair seu token Bearer da URL do servidor (Server URL) fornecida em https://mcp.zapier.com/mcp/servers > Connect.
Sua URL do servidor terá o seguinte formato: https://mcp.zapier.com/api/mcp/s/*****/mcp
Extraia a parte indicada pelos asteriscos (*****) e use-a no cabeçalho de autorização que você fornecer: Bearer *****

Airtable
Docker Hub
- Nome de usuário do Docker Hub: você pode obtê-lo em My Hub
- Personal Access Token: acesse Account settings > Personal access tokens e crie um token

SonarQube
- SonarQube token: Acesse My Account > Security e gere seu token de API
- SonarQube org: Este é o seu nome de usuário; exemplo mostrado na imagem abaixo

- SonarQube URL:
- Para instâncias self-hosted: o formato é http://localhost:9000 OU https://sonarqube.mycompany.com
- Para SonarCloud: use https://sonarcloud.io
Netlify

Pulumi

Parallel
Heroku

CircleCI
CIRCLECI_TOKEN- Token de API do CircleCI, que pode ser criado em https://app.circleci.com/settings/user/tokens. Certifique-se de copiar o token de API assim que ele for criado. Você não poderá visualizá-lo novamente!

CIRCLECI_BASE_URL[Opcional] - Essa variável é opcional e necessária apenas para clientes on-prem. O valor padrão é"https://circleci.com"
Cortex
- Faça login na sua instância do Cortex.
- No menu à esquerda, vá para Settings → My access tokens.
- Clique em Create new token.
- Insira um nome e uma descrição para o token.
- Clique em Create token e copie o token.
https://api.getcortexapp.com).
Documentação
Square
Bearer <TOKEN>, em que <TOKEN> é o seu token de acesso do Square. Mais informações em: https://developer.squareup.com/docs/build-basics/access-tokens
Documentação
Hubspot
- Crie um aplicativo privado no HubSpot:
- Vá para Settings > Integrations > Private Apps
- Clique em “Create private app”
- Dê um nome ao aplicativo e defina os escopos necessários
- Clique em “Create app”
- Copie o token de acesso gerado na aba “Auth”
Redis
- Host do Redis
- Porta do Redis
- Usuário do Redis
- Senha do Redis
Google Maps



Playwright
Firecrawl
FIRECRAWL_API_KEY), que você pode visualizar e criar em https://www.firecrawl.dev/app/api-keys.
Documentação
ElasticSearch
ES_URL- URL ou endpoint do Elasticsearch, que pode ser encontrado na página/overviewno Elasticsearch.ES_API_KEY- chave de API do Elasticsearch, que pode ser criada na página/indices/index_details/<name>/datano Elasticsearch.

ES_SSL_SKIP_VERIFY é uma variável de ambiente opcional. Quando definida como true, ela ignora a verificação do certificado SSL/TLS ao se conectar ao Elasticsearch.
Documentação
Postgres
Plaid
Replicate
Grafana
- URL do Grafana
- Token de conta de serviço do Grafana: para obter o token, na barra lateral, vá em Administration > Users and access > Service accounts > Add service account (se você ainda não tiver uma) > Add service account token

Pinecone

Snyk
- Primeiro, configure o servidor MCP. A documentação está disponível aqui. Observação: verifique se você adicionou uma variável de ambiente ao final (ela não está listada no guia).

- Instale a CLI do Snyk na máquina do Devin. A documentação está disponível aqui
unmanaged: true (ex.: C++) seja passada. Atualmente você pode definir isso no Knowledge ou durante sua sessão com o Devin — aqui está um exemplo:

