Conectar com Claude, ChatGPT e Gemini (MCP)

A Trama expõe um servidor MCP (Model Context Protocol) que permite consultar o Agente Operacional da sua organização a partir de clientes externos como Claude.ai, ChatGPT e Gemini. As consultas respeitam o seu papel e as permissões que você tem dentro da agência.

O que é MCP

MCP é um padrão aberto que conecta assistentes de IA a ferramentas e dados externos. Quando você adiciona a Trama como conector MCP, seu cliente de IA pode perguntar ao Agente da Trama sobre sua operação (oportunidades, clientes, acompanhamentos) usando linguagem natural, sem precisar copiar e colar entre apps.

O que você pode fazer

O servidor MCP da Trama expõe uma ferramenta chamada `ask_trama`. Você passa uma mensagem em linguagem natural e o Agente Operacional responde respeitando as permissões do seu papel.

Exemplos:

• "Mostra as oportunidades qualificadas desta semana"
• "Quantos clientes novos chegaram pela campanha de Bariloche"
• "Resume os acompanhamentos pendentes da Maria"

Importante: a resposta é limitada pelo seu papel. Se você não tem permissão para ver uma oportunidade ou cliente, o agente não vai mostrá-lo.

URL do servidor

`https://ai.trama.so/mcp`

Essa é a única URL que você vai precisar. A autenticação acontece via OAuth 2.1: quando você adiciona o conector, seu cliente te leva a entrar na Trama e autorizar o acesso à organização ativa.

Antes de começar

• Tenha uma conta ativa na Trama e tenha entrado no painel pelo menos uma vez.
• Tenha selecionada a organização sobre a qual você quer operar (se pertence a várias, o conector usa a ativa no momento da autorização).
• Use um cliente MCP que suporte OAuth com Dynamic Client Registration. Claude.ai, ChatGPT e Gemini já suportam.

Conectar pelo Claude

1. Abra Settings → Connectors no Claude.ai ou no app de desktop.
2. Clique em Add custom connector.
3. Cole a URL `https://ai.trama.so/mcp` e confirme.
4. O Claude redireciona você para a Trama para entrar. Use a mesma conta com a qual você acessa o painel.
5. Autorize o acesso à sua organização ativa.
6. Pronto. Em qualquer conversa você já pode pedir ao Claude para usar a ferramenta da Trama.

Conectar pelo ChatGPT

1. No ChatGPT, vá em Settings → Connectors (disponível nos planos Pro, Team e Enterprise).
2. Escolha Add custom MCP server.
3. Insira a URL `https://ai.trama.so/mcp`.
4. O ChatGPT abre o fluxo OAuth contra a Trama. Entre e autorize.
5. Uma vez conectado, a ferramenta `ask_trama` fica disponível em qualquer chat ou como parte de um GPT personalizado.

Conectar pelo Gemini

O Gemini suporta MCP de duas formas:

• App do Gemini e AI Studio. Se sua conta tem habilitada a opção de Extensions ou Connectors com suporte MCP, adicione a Trama colando a URL `https://ai.trama.so/mcp` e autorize via OAuth, igual ao Claude ou ChatGPT.
• Gemini API. Se você está construindo uma integração programática, pode registrar o servidor MCP da Trama como ferramenta dentro da sua chamada ao modelo. Consulte a documentação oficial da Gemini API sobre `tools` e MCP.

O suporte UI de MCP no Gemini está sendo liberado de forma escalonada conforme região e tipo de conta. Se ainda não vê a opção no seu app, você pode usar a integração via API ou esperar a liberação na sua conta. O servidor da Trama é o mesmo em todos os casos.

Permissões e segurança

• O acesso usa OAuth 2.1: você nunca compartilha sua senha com Claude, ChatGPT ou Gemini.
• O token vive somente no cliente que você conectou e pode ser revogado a qualquer momento nas configurações da Trama.
• Cada resposta é executada com seu papel na organização ativa. Se reduzirem suas permissões, o agente reflete imediatamente.
• Se você for convidado para uma nova organização ou trocar de organização ativa, desconecte e reconecte o MCP para atualizar o contexto.

Limitações atuais

• Por enquanto expomos apenas uma ferramenta (`ask_trama`). Vamos adicionar mais operações (criar oportunidades, mover cards, agendar acompanhamentos) nas próximas versões.
• O servidor MCP não faz streaming: cada resposta chega completa.
• Se seu cliente MCP não suporta OAuth dinâmico (Dynamic Client Registration), você não vai conseguir conectar. Claude.ai, ChatGPT e Gemini já suportam.