Skip to main content
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 nativos. É o sentido inverso do Servidor MCP da Tess, que expõe a Tess para Claude, Cursor e outros clientes MCP.

Servidor MCP da Tess

Use agentes, arquivos e memórias da Tess a partir do Claude, Cursor, Codex ou qualquer cliente MCP. Endpoint: https://mcp.tess.im.

Custom MCP

Traga um servidor MCP externo para dentro da Tess. Seus chats e agentes chamam as ferramentas desse servidor com as suas credenciais.
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 — use Custom MCP para servidores que não estão nesse catálogo.

​
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).
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.

​
Adicionar um servidor Custom MCP

1

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

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

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

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

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

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.

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

​
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

Compartilhamento e permissões

Servidores pessoais vs compartilhados, opt-in e quem pode criar, compartilhar ou excluir.

Boas práticas

Descoberta OAuth, solução de problemas e como evitar que ferramentas pessoais vazem no workspace.