> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin MCP

> Como usar o servidor oficial MCP do Devin para repositórios privados e públicos

O servidor MCP do Devin fornece acesso programático aos recursos da plataforma do Devin, tanto para repositórios privados quanto públicos. Além da documentação e da busca em repositórios, ele oferece a qualquer agente de IA ou IDE compatível com MCP acesso completo ao gerenciamento de sessões, playbooks, Knowledge e agendamentos.

<Info>
  Qualquer sessão do Devin ou cliente compatível com MCP pode criar sessões, gerenciar playbooks e Knowledge, configurar agendamentos e muito mais. Consulte [Recursos Avançados](/pt-BR/work-with-devin/advanced-capabilities) para mais detalhes sobre o que o Devin pode fazer.
</Info>

<div id="what-is-mcp">
  ## O que é MCP?
</div>

O [Model Context Protocol](https://modelcontextprotocol.io/introduction) (MCP) é um padrão aberto que permite que aplicativos de IA se conectem com segurança a fontes de dados e ferramentas compatíveis com MCP. Você pode pensar no MCP como uma porta USB‑C para aplicativos de IA — uma forma padronizada de conectar aplicativos de IA a diferentes serviços.

<div id="devin-mcp-server">
  ## Servidor MCP do Devin
</div>

O servidor MCP do Devin é um serviço autenticado que oferece acesso a repositórios públicos e privados, além de recursos completos de gerenciamento da plataforma.

**URL base do servidor:** `https://mcp.devin.ai/`

<div id="authentication-required">
  ### Autenticação obrigatória
</div>

Para usar o servidor MCP do Devin, você precisa de uma Chave de API do Devin:

1. Crie uma conta em [Devin.ai](https://devin.ai/)
2. Gere uma Chave de API nas [Configurações da sua conta](/pt-BR/api-reference/authentication)
3. Inclua a Chave de API na configuração do seu cliente MCP

O servidor MCP oferece suporte aos mesmos métodos de autenticação da [Devin API](/pt-BR/api-reference/authentication):

| Tipo de token                                     | Prefixo | Resolução da org                                                  |
| ------------------------------------------------- | ------- | ----------------------------------------------------------------- |
| **Chave de usuário de serviço com escopo de org** | `cog_`  | Automática — o org\_id é resolvido com base no usuário de serviço |
| **Chave de usuário de serviço Enterprise**        | `cog_`  | Requer o cabeçalho `X-Org-Id` (veja abaixo)                       |
| **Token de acesso pessoal**                       | `cog_`  | Requer o cabeçalho `X-Org-Id` (veja abaixo)                       |

<Note>
  Chaves de API legadas (prefixo `apk_` / `apk_user_`) **não têm suporte** no servidor MCP do Devin. Use uma [chave de API de usuário de serviço](/pt-BR/api-reference/authentication#service-users-recommended-for-automation).
</Note>

<div id="enterprise-accounts-x-org-id-header">
  #### Contas Enterprise: cabeçalho `X-Org-Id`
</div>

As chaves de usuário de serviço do Enterprise e os PATs têm escopo no nível da conta, não de uma organização específica. Como as ferramentas MCP operam em recursos no nível da organização (sessões, playbooks, Knowledge etc.), você precisa informar ao servidor qual organização deve ser usada como destino, passando o cabeçalho `X-Org-Id`:

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>",
        "X-Org-Id": "<YOUR_ORG_ID>"
      }
    }
  }
}
```

<Tip>
  Encontre o ID da sua organização na página **Configurações > Usuários de serviço** ou faça uma chamada ao endpoint [GET /v3/self](/pt-BR/api-reference/v3/self/self) com sua chave de API.
</Tip>

As chaves de usuário de serviço com escopo de organização não precisam desse cabeçalho — a organização é resolvida automaticamente.

<div id="available-tools">
  ## Ferramentas disponíveis
</div>

<div id="repository-documentation">
  ### Documentação de repositório
</div>

Estas ferramentas permitem explorar e consultar a documentação de qualquer repositório do GitHub (público ou privado, com autenticação):

| Ferramenta                 | Descrição                                                                                                                    |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| **`read_wiki_structure`**  | Obtenha uma lista de tópicos de documentação de um repositório do GitHub                                                     |
| **`read_wiki_contents`**   | Visualize a documentação completa de um repositório do GitHub                                                                |
| **`ask_question`**         | Faça qualquer pergunta sobre um ou mais repositórios (até 10) e obtenha uma resposta gerada por IA, fundamentada no contexto |
| **`list_available_repos`** | Liste todos os repositórios disponíveis para consulta com sua conta do Devin                                                 |

<div id="session-management">
  ### Gerenciamento de sessões
</div>

Crie, pesquise, inspecione e controle sessões do Devin programaticamente:

| Ferramenta                   | Descrição                                                                                                                                                                                  |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`devin_session_create`**   | Crie uma ou mais sessões do Devin. Cada sessão pode ter um `prompt`, título, playbook, tags e limite de ACU                                                                                |
| **`devin_session_search`**   | Pesquise e filtre sessões por tags, playbook, origem, agendamento, usuário ou horário de criação/atualização                                                                               |
| **`devin_session_interact`** | Interaja com uma sessão — get status, envie mensagens, coloque em espera, encerre, arquive, leia mensagens e anexos ou gerencie tags                                                       |
| **`devin_session_events`**   | Inspecione eventos em uma sessão — liste resumos, obtenha detalhes completos de eventos ou pesquise o conteúdo dos eventos por texto                                                       |
| **`devin_session_gather`**   | Aguarde várias sessões atingirem um estado finalizado (concluída, com erro, em espera ou aguardando) antes de retornar. Útil após criar sessões paralelas, em vez de fazer polling em loop |

<div id="playbook-management">
  ### Gerenciamento de playbooks
</div>

Crie e gerencie playbooks que padronizam a forma como o Devin executa tarefas:

| Ferramenta                  | Descrição                                                                                                        |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| **`devin_playbook_manage`** | Lista, get, cria, atualiza ou exclui playbooks. Oferece suporte a macros de automação (por exemplo, `!my_macro`) |

<div id="knowledge-management">
  ### Gerenciamento do Knowledge
</div>

Mantenha a base de conhecimento da sua organização, usada pelo Devin como contexto:

| Ferramenta                   | Descrição                                                                                                                                                                                                                                                                                        |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`devin_knowledge_manage`** | CRUD completo para notas do Knowledge — listar, get, criar, atualizar ou excluir, além de navegar pela estrutura de pastas. Também gerencia sugestões do Knowledge — listar, visualizar e dispensar sugestões pendentes. Pode oferecer suporte à filtragem por repo, pasta e consultas de search |

<div id="schedule-management">
  ### Gerenciamento de agendamentos
</div>

Configure sessões agendadas recorrentes ou pontuais do Devin:

| Ferramenta                  | Descrição                                                                                                                                                                                |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`devin_schedule_manage`** | Lista, get, cria, atualiza ou exclui agendamentos. Oferece suporte a expressões cron para agendamentos recorrentes, agendamento pontual, preferências de notificação e seleção de agente |

<div id="integration-management">
  ### Gerenciamento de integrações
</div>

Visualize e gerencie as integrações nativas da sua organização e os servidores MCP:

| Ferramenta              | Descrição                                                                                                                                                                                        |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`list_integrations`** | Lista todas as integrações nativas (por exemplo, GitHub, Jira e Slack) e os servidores MCP com o status de instalação e as URLs de configurações. Filtre por instalados, não instalados ou todos |

<div id="wire-protocols">
  ## Protocolos de transporte
</div>

O servidor MCP do Devin oferece suporte a HTTP com streaming:

* **URL:** `https://mcp.devin.ai/mcp`
* Funciona com clientes compatíveis com HTTP
* **Recomendado para todas as integrações**

<Note>O endpoint SSE (`/sse`) legado foi descontinuado. Use o endpoint `/mcp` em vez dele.</Note>

<div id="key-differences-from-deepwiki-mcp">
  ## Principais diferenças em relação ao DeepWiki MCP
</div>

| Recurso                         | DeepWiki MCP                 | Devin MCP                                                |
| ------------------------------- | ---------------------------- | -------------------------------------------------------- |
| **Autenticação**                | Nenhuma necessária           | Chave de API necessária                                  |
| **Acesso a repositórios**       | Apenas repositórios públicos | Repositórios públicos e privados                         |
| **Gerenciamento da plataforma** | Não disponível               | Sessões, playbooks, Knowledge, agendamentos, integrações |
| **URL base**                    | `https://mcp.deepwiki.com/`  | `https://mcp.devin.ai/`                                  |
| **Custo**                       | Gratuito                     | Requer conta Devin                                       |

<div id="setup-instructions">
  ## Instruções de configuração
</div>

O nome do campo da URL do servidor depende do cliente: o Devin Desktop usa `serverUrl`, enquanto a maioria dos outros clientes usa o campo padrão `url`. Usar o nome de campo errado faz com que o servidor MCP seja ignorado sem aviso.

<div id="for-devin-desktop">
  ### Para o Devin Desktop:
</div>

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "serverUrl": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

<div id="for-most-other-clients-eg-cursor">
  ### Para a maioria dos outros clientes (como o Cursor):
</div>

```json theme={null}
{
  "mcpServers": {
    "devin": {
      "url": "https://mcp.devin.ai/mcp",
      "headers": {
        "Authorization": "Bearer <API_KEY>"
      }
    }
  }
}
```

<div id="for-claude-code">
  ### Para o Claude Code:
</div>

```bash theme={null}
claude mcp add -s user -t http devin https://mcp.devin.ai/mcp -H "Authorization: Bearer <API_KEY>"
```

<div id="related-resources">
  ## Recursos relacionados
</div>

* **[Recursos avançados](/pt-BR/work-with-devin/advanced-capabilities)** — Visão geral dos recursos avançados do Devin
* **[Marketplace MCP do Devin](/pt-BR/work-with-devin/mcp)**
* **[Conectando servidores MCP remotos ao Claude](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp)**
* **[Documentação da OpenAI para uso de servidores MCP](https://platform.openai.com/docs/guides/tools-remote-mcp)**
* **[DeepWiki MCP](/pt-BR/work-with-devin/deepwiki-mcp)** — Apenas para repositórios públicos
* **[DeepWiki](/pt-BR/work-with-devin/deepwiki)**
* **[Ask Devin](/pt-BR/work-with-devin/ask-devin)**