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

# Custom MCP

> Conecte seus próprios servidores MCP remotos à Tess para que chats e agentes usem essas ferramentas junto com os conectores nativos.

Custom MCP faz a Tess atuar como **cliente MCP**. Você registra um servidor remoto (Attio, Gleap, Volt, Supabase, uma ferramenta interna ou qualquer endpoint MCP Streamable HTTP), a Tess descobre as ferramentas e elas ficam disponíveis no chat e nos agentes — junto com os [Conectores](/pt/connectors) nativos.

É o sentido inverso do [Servidor MCP da Tess](/pt/api-mcp), que expõe a Tess *para* Claude, Cursor e outros clientes MCP.

<CardGroup cols={2}>
  <Card title="Servidor MCP da Tess" icon="cloud" href="/pt/api-mcp">
    Use agentes, arquivos e memórias da Tess a partir do Claude, Cursor, Codex ou qualquer cliente MCP. Endpoint: `https://mcp.tess.im`.
  </Card>

  <Card title="Custom MCP" icon="plug">
    Traga um servidor MCP *externo* para dentro da Tess. Seus chats e agentes chamam as ferramentas desse servidor com as suas credenciais.
  </Card>
</CardGroup>

<Info>
  Custom MCP fica disponível quando o recurso do workspace está habilitado. Apps nativos (Gmail, Slack, Notion e o restante do catálogo) continuam em [Conectores](/pt/connectors) — use Custom MCP para servidores que não estão nesse catálogo.
</Info>

## Antes de começar

Você precisa de:

* Um **endpoint MCP remoto** com **Streamable HTTP** (não um processo local `npx`/stdio).
* Permissão para **criar servidores MCP pessoais** (ou permissão de governança, se for compartilhar com o workspace).
* As credenciais que o servidor espera: **OAuth** (login interativo) ou **token estático** (Bearer, API key ou cabeçalhos personalizados).

<Warning>
  Mantenha contas pessoais como pessoais. Um MCP de WhatsApp, e-mail ou CRM atrelado à *sua* identidade deve permanecer **pessoal**. Compartilhar com o workspace permite que outros membros ativem e chamem essas ferramentas. Veja [Compartilhamento e permissões](/pt/mcp-sharing-permissions).
</Warning>

## Adicionar um servidor Custom MCP

<Steps>
  <Step title="Abra Conectores">
    No chat, clique em **+** → **Connectors** → **Add connectors** e abra a faixa **Custom MCP**. Você também pode gerenciar servidores em **Configurações → MCP Plugins**.
  </Step>

  <Step title="Informe o endpoint">
    Dê um nome ao servidor e cole a URL remota (por exemplo `https://mcp.attio.com/mcp` ou `https://mcp.voltchat.com/mcp`). A Tess só aceita endpoints HTTP(S) remotos permitidos.
  </Step>

  <Step title="Escolha como autenticar">
    * **OAuth** — a Tess descobre os metadados de auth e abre um popup para você autorizar *a sua* conta. Permita pop-ups para concluir o fluxo.
    * **Bearer / API key / cabeçalho** — cole o token que a Tess deve enviar em cada chamada àquele servidor.
  </Step>

  <Step title="Salve e então conecte">
    Depois de salvar um servidor OAuth, clique em **Connect** e conclua o login do provedor. A Tess então sincroniza a lista de ferramentas. Não habilite o servidor no chat antes da conexão ter sucesso — um servidor OAuth sem token conectado não consegue executar.
  </Step>

  <Step title="Ative as ferramentas que quiser">
    Cada ferramenta pode ser ligada ou desligada **para você**. Desativar uma ferramenta nunca altera a seleção de outro membro. No chat, selecione o MCP em Conectores como qualquer outro app para o agente poder chamá-lo.
  </Step>
</Steps>

Servidores novos são **pessoais** por padrão. Compartilhar com o workspace é uma ação separada e explícita, e exige permissão de governança.

## Modelos de autenticação

| Como o MCP autentica             | O que a Tess armazena             | A quem pertence                                                                         |
| -------------------------------- | --------------------------------- | --------------------------------------------------------------------------------------- |
| **OAuth**                        | Token conectado por usuário       | Sempre **a sua** conta, mesmo se o servidor for compartilhado                           |
| **Bearer / API key / cabeçalho** | Credencial estática criptografada | Pessoais: o criador. Compartilhados: credencial do workspace definida por um governador |

<Tip>
  Prefira OAuth quando o provedor oferecer (Attio, Meta Ads e muitos MCPs hospedados). Cada membro que usa um MCP OAuth compartilhado precisa clicar em **Connect** e entrar com a própria conta. A Tess nunca reutiliza o token OAuth de outra pessoa.
</Tip>

## Uso no chat e nos agentes

Com o servidor conectado e habilitado para você:

* **Chat** — selecione-o em Conectores (o mesmo controle de Gmail ou Slack). Se não estiver selecionado, a Tess não injeta as ferramentas naquele turno.
* **Agent Studio** — adicione-o à política de conectores do agente, ou deixe **User decision** ligado para cada usuário final escolher na hora.
* **Chips de ferramentas** — ligue ou desligue capacidades individuais sem excluir o servidor.

<Note>
  Um MCP compartilhado no qual você não deu opt-in não aparece no seu chat. Ative-o primeiro em MCP Plugins ou no modal de Conectores. Detalhes: [Compartilhamento e permissões](/pt/mcp-sharing-permissions).
</Note>

## O que a Tess faz com o servidor

1. Descobre ferramentas (e recursos, quando o servidor os expõe) via MCP.
2. Converte-as para o mesmo formato das ferramentas nativas da Tess.
3. Injeta só as ferramentas **que você** ativou, e só se o servidor estiver conectável (credencial estática válida ou token OAuth conectado).
4. Chama o servidor remoto com **a sua** credencial. As execuções seguem créditos e permissões do workspace.

Se não houver credencial utilizável para você, a Tess esconde o servidor da descoberta de ferramentas em vez de chamá-lo sem autenticação.

## Relacionado

<CardGroup cols={2}>
  <Card title="Compartilhamento e permissões" icon="shield-check" href="/pt/mcp-sharing-permissions">
    Servidores pessoais vs compartilhados, opt-in e quem pode criar, compartilhar ou excluir.
  </Card>

  <Card title="Boas práticas" icon="list-check" href="/pt/mcp-best-practices">
    Descoberta OAuth, solução de problemas e como evitar que ferramentas pessoais vazem no workspace.
  </Card>
</CardGroup>