O que o conector expõe

As ferramentas, os prompts e os recursos que o servidor MCP da Trama entrega ao seu assistente — e as regras que decidem quais você recebe.

Uma vez conectado, o seu assistente vê um conjunto de ferramentas (coisas que ele pode fazer), prompts (rotinas prontas que você escolhe no menu do seu cliente) e recursos (contexto que ele pode ler sozinho).

Tudo devolve dados estruturados em vez de prosa, que é o que permite ao seu assistente encadear chamadas em vez de reler o próprio texto.

A sua função decide quais ferramentas você vê. O servidor não oferece as que você não pode usar: um vendedor nunca vê desempenho da equipe, e sem permissão para tirar oportunidades do funil, arquivar e restaurar simplesmente não estão na lista. Isso não é um aviso na hora de chamar — a ferramenta não está lá.

Ferramentas

Busca

search_workspace — uma única chamada sobre oportunidades, clientes, conversas, catálogo e agentes. As conversas são buscadas também por conteúdo, então uma palavra dita dentro de um fio o encontra, e o resultado traz o trecho que casou. Costuma ser a primeira chamada: resolve o id que todas as outras pedem.

Oportunidades

LeituraEscrita
list_opportunities · get_opportunity · get_opportunities_board · query_opportunities · list_dormant_opportunities · list_paused_opportunities · list_archived_opportunitiescreate_opportunity · update_opportunity · move_opportunity · pause_opportunity · resume_opportunity · reactivate_opportunity · archive_opportunity · restore_opportunity · dispute_opportunity

Os follow-ups também moram aqui: add_opportunity_follow_up, update_opportunity_follow_up e delete_opportunity_follow_up — registrar um, corrigi-lo, e desfazer o que foi registrado por engano.

query_opportunities é a analítica: conta e soma valores agrupando por vendedor, dia, origem, coluna ou temperatura, então "quanto cotamos em julho por vendedor" é uma chamada e não uma varredura de lista.

Clientes

list_customers · search_customers · get_customer · get_customer_facts · create_customer · update_customer · update_customer_profile

get_customer_facts é a que vale conhecer: devolve o que a Trama aprendeu sobre aquela pessoa nas conversas dela, fato a fato, que é a diferença entre "aqui está um telefone" e "aqui está como essa pessoa compra".

Conversas

list_conversations · get_conversation · get_conversation_metrics · get_seller_response_gap

As conversas são somente leitura, por design. Você pode ler uma e resumi-la; nunca respondê-la nem assumi-la daqui.

E get_conversation devolve as 50 mensagens mais recentes, não o fio inteiro. Numa conversa longa você está lendo o final. Esse teto existe porque do outro lado desta conexão há um modelo de terceiros, e ler um fio não é a mesma coisa que exportá-lo.

list_catalog_products · get_catalog_product · create_catalog_product · update_catalog_product · publish_catalog_product · delete_catalog_product

As variantes têm o seu próprio conjunto — list_product_variants, create_product_variant, update_product_variant, delete_product_variant, reorder_product_variants — e set_packages_on_link escolhe o que aparece no seu Link de ofertas.

Lembre que publicar é o que torna um produto vendável: um produto criado é um rascunho até publish_catalog_product rodar. É a mesma regra da tela de catálogo.

Campanhas e anúncios

preview_campaign_audience · list_campaign_templates · get_campaign_proposals · draft_campaign_message · get_ad_performance

Daqui você dimensiona uma audiência e redige o texto. Aprovar e enviar continua sendo do painel — escrever para toda a sua base de clientes não é algo que um assistente deva conseguir concluir sozinho.

Os seus pendentes

list_pending_follow_ups · list_reminders · create_reminder · reschedule_reminder · resolve_reminder

É a superfície do "o que eu tenho hoje" — o mesmo material do Meu dia.

Perguntas do agente

list_agent_questions · answer_agent_question

Quando o Agente de Consultas não conseguiu confirmar algo sozinho, ele pergunta à equipe. Estas duas deixam você ver o que ele está esperando e respondê-lo.

answer_agent_question é o único caminho pelo qual algo que você escreve daqui chega a um cliente. A sua resposta volta ao agente e o agente a usa na conversa. Todo o resto desta página fica dentro da Trama.

Equipe e organização

get_organization_overview · get_seller_performance · invite_member · set_member_assignable · set_member_spoken_languages

ask_trama

A curinga: pergunta ao Trama Agent em linguagem natural e traz a resposta. Serve para o que nenhuma ferramenta específica cobre — pedidos compostos, ações encadeadas, ou perguntas sobre como a Trama funciona.

ask_trama é a única ferramenta que consome a cota diária do seu plano, porque roda o Trama Agent. As demais são chamadas diretas e não custam nada. Se você bater no teto, a ferramenta avisa na resposta em vez de falhar.

As que o seu cliente vai reconfirmar

Cinco ferramentas são marcadas como destrutivas no protocolo, que é o que faz um cliente bem-comportado pedir confirmação antes de executá-las:

archive_opportunity · dispute_opportunity · delete_opportunity_follow_up · delete_catalog_product · delete_product_variant

Elas são expostas em vez de escondidas — um assistente que não pode arquivar é um assistente que você para de usar — mas a marca está lá para que nada de grande alcance aconteça em silêncio.

Prompts

O seu cliente os mostra no menu de prompts (no Claude, o + ao lado da caixa de mensagem). São rotinas que nós escrevemos para você não precisar formulá-las:

PromptO que faz
revisar-mi-diaOs seus pendentes, os seus lembretes e as oportunidades novas de ontem, numa única lista priorizada
estado-del-embudoOnde o pipeline trava: qual coluna acumula, qual vendedor está sobrecarregado, qual origem traz volume sem conversão
barrido-de-seguimientoQuem contatar hoje e com que desculpa concreta — mostra a lista antes de escrever qualquer coisa
como-viene-el-equipoOs tempos de resposta do quadro contra os reais, medidos nas conversas, e a diferença entre os dois
huecos-del-catalogoDemanda que aparece repetida e não tem produto que a cubra

Um prompt só aparece se você tiver todas as ferramentas de que ele precisa, então o menu que você vê também se ajusta à sua função.

Recursos

Duas coisas que o seu assistente pode ler sem que você peça:

  • trama://catalog — o catálogo da sua organização.
  • trama://organization — o panorama operacional: integrantes, canais, inbox e métricas.

Existem para que o assistente tenha o formato do seu negócio em mãos antes de você perguntar qualquer coisa, em vez de gastar um turno descobrindo-o.

Nesta página