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

# Servidores MCP de plugins no Devin

> Declare servidores MCP em um plugin do Devin e defina quem detém a Credencial: cada membro, uma conta de serviço da organização ou a empresa.

Um plugin pode incluir servidores MCP (por exemplo, um rastreador de issues), para que todos que o instalarem recebam a mesma configuração de servidor sem precisar configurá-la do zero. Depois de instalar o plugin, você fornece as Credenciais de que o servidor precisa, como uma chave de API ou um login via OAuth. Uma conexão pode ser pessoal ou compartilhada, dependendo de onde o plugin está instalado e da configuração de **Acesso** da instalação.

## A declaração

Declare os servidores em um `.mcp.json` na raiz, como um mapa `mcpServers`. O campo inline `mcpServers` do manifesto aceita o mesmo mapa, sem o objeto envolvente.

```json theme={null}
{
  "mcpServers": {
    "example-mcp": {
      "url": "https://mcp.example.com/mcp",
      "tokenScope": "user"
    },
    "example-mcp-service-account": {
      "url": "https://mcp.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}"
      }
    }
  }
}
```

| Campo | Tipo | O que faz |
| - | - | - |
| `url` | string | O endpoint do servidor. Obrigatório. |
| `transport` | string | Defina `"sse"` para um endpoint SSE legado. Omita para usar Streamable HTTP. |
| `headers` | object | Cabeçalhos HTTP enviados em cada requisição. Os valores podem conter placeholders. |
| `oauthClientId` | string | Um cliente OAuth pré-registrado, para provedores sem registro dinâmico de clientes. Quando definido, o servidor passa a usar OAuth, independentemente dos cabeçalhos. |
| `oauthClientSecret` | string | Não é aceito em um plugin: a declaração é rejeitada. O administrador que faz a instalação informa o segredo nas configurações do servidor. |
| `oauthScopes` | string\[] | Escopos a serem solicitados. Requer `oauthClientId`. |
| `oauthResource` | string | Substitui o parâmetro `resource` da RFC 8707 (padrão: a URL do servidor). `""` o omite; qualquer outro valor deve identificar este servidor. |
| `tokenScope` | string | **Acesso** padrão para uma instalação de organização ou empresa de um servidor OAuth: `"user"` (cada membro faz login) ou `"org"` (uma conexão compartilhada). Se não for definido, aplica-se o escopo da entrada do marketplace ou, na ausência dele, uma conexão compartilhada. Um valor declarado é reaplicado sempre que o plugin é reconciliado. Uma instalação pessoal é sempre do próprio membro. |
| `disabled` | boolean | `true` ignora o servidor. |
| `disabledTools` | string\[] | Nomes de ferramentas deste servidor ocultas do Devin. |
| `description` | string | Exibida junto ao servidor em Customize. |

**Placeholders.** `${NAME}` em `url` ou `headers` é preenchido por quem instala, na folha Connect do servidor. `${NAME:-default}` fornece um fallback quando nenhum valor foi salvo. Um servidor de plugin lê apenas os valores salvos na própria instalação, e não [segredos de sessão](https://docs.devin.ai/pt-BR/product-guides/secrets.md) com o mesmo nome. Nunca escreva um token real em uma declaração: ele é armazenado exatamente como foi escrito.

Como alternativa, um servidor pode executar um comando local (`command`, `args`, `env`); nesse caso, ele não aceita nenhum dos campos de Credencial HTTP acima.

> [!NOTE]
>
> A página [servidores MCP](https://docs.devin.ai/pt-BR/work-with-devin/mcp.md#configuration-format) documenta o formulário do Customize para um servidor independente. O servidor de um plugin usa os nomes de campo acima, e a URL, o transporte e os cabeçalhos dele aparecem como somente leitura na linha da instalação.

## Quem detém a Credencial

| Instalado por | A Credencial pertence a | Quem faz a conexão |
| - | - | - |
| Um membro (escopo pessoal) | Esse membro | O próprio membro, em Customize → MCPs |
| Uma organização | A organização (`Access: Organization`) ou cada membro (`Access: Personal`) | Um administrador da organização ou cada membro |
| A empresa | A empresa (`Access: Enterprise`) ou cada membro de todas as organizações (`Access: Personal`) | Um administrador do Enterprise ou cada membro |

## Configurações

Cada configuração combina uma entrada da declaração acima com o local de instalação do plugin e a forma como ele é distribuído: **Obrigatório** instala o plugin para todos no escopo, e **Oferecido** permite que cada organização ou membro o instale. Ambas as opções são definidas no próprio plugin, em [Customize](https://docs.devin.ai/pt-BR/product-guides/plugins.md#mcps).

### OAuth por usuário para todos

Para um servidor que oferece suporte a OAuth, use a entrada `example-mcp` e instale o plugin como **Obrigatório** na empresa ou na organização.

Com `tokenScope: "user"`, o Acesso fica definido como **Personal** por padrão, então cada membro faz login apenas uma vez, em Customize → MCPs ou na primeira sessão que precisar dele.

### Uma conta de serviço da organização

Use a entrada `example-mcp-service-account` e instale o plugin na organização.

* O cabeçalho `Authorization` contém um placeholder, por isso a linha exibe **Connect**. Um administrador da organização insere o token; os membros nunca têm acesso a ele.
* Se o servidor rejeitar o token (401), a linha exibe **Check the Credencial**. Se o servidor também oferecer suporte a OAuth, a linha exibe ainda **Sign in with OAuth instead**.
* Para uma conta de serviço que faz login com OAuth, remova o cabeçalho, defina `tokenScope: "org"` e conecte o login dessa conta.

### Uma chave por organização

Coloque a entrada `example-mcp-service-account` em um plugin da empresa e defina-o como **Oferecido às organizações**.

* Cada organização que instalar o plugin é dona da própria instalação, então o administrador dela preenche `${EXAMPLE_MCP_SERVICE_ACCOUNT_TOKEN}` com a chave dessa organização.
* Nada é conectado no nível da empresa, e nenhuma organização vê a chave de outra.
* Já um plugin da empresa definido como **Obrigatório** cria uma única instalação pertencente à empresa: uma chave para todas as organizações.

### Ambos em um único plugin

Inclua as duas entradas, como na declaração acima, e disponibilize o plugin. Cada organização que o instalar recebe duas linhas: uma em que os membros fazem login e outra que o administrador da organização conecta. Com nomes de servidor distintos, as habilidades do plugin podem indicar qual servidor usar.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.