MCP e IA · Atualizado em 12/10/2026
Catálogo de ferramentas do MCP do Pipe
Todas as 72 ferramentas do MCP do Pipe, organizadas por área, com o que cada uma faz, o escopo exigido e se ela só lê, altera ou envia.
O MCP do Pipe tem 72 ferramentas. Você não precisa decorar nenhuma: o agente escolhe a certa pelo que você pede. Este catálogo serve para saber o que é possível e qual escopo cada área exige.
O risco de cada ferramenta é um destes:
- leitura: só olha.
- escrita: muda um cadastro, em duas etapas (
propose_*e depoisconfirm_change). - externa: sai da plataforma (mensagem ao cliente, modelo para a Meta, e-mail de convite), em duas etapas e sem volta.
Quando usar
Para conferir se uma tarefa é possível pelo MCP e qual escopo a chave precisa ter. Para os escopos, veja Escopos da chave.
Pré-requisitos
Uma chave de IA conectada ao agente, como em Como conectar um agente de IA ao Pipe.
Passo a passo
- Encontre abaixo a área do que você quer fazer.
- Confira o escopo da ferramenta e se a sua chave o tem.
- Peça ao agente em linguagem natural. Ele escolhe a ferramenta e, se for uma proposta, mostra o plano antes de aplicar.
Guia e propostas
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
get_setup_status | Checklist da conta: o que está pronto, o que falta e a próxima ação | config:ler | leitura |
get_guide | Devolve um dos cinco guias para iniciantes | config:ler | leitura |
confirm_change | Aplica uma proposta já feita, com o identificador dela | o da ferramenta que propôs | escrita ou externa |
Cadastros do atendimento
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_queues | Lista as filas | config:ler | leitura |
list_agents | Lista os atendentes | config:ler | leitura |
list_labels | Lista as etiquetas | config:ler | leitura |
list_attendance_hours | Lista os horários de atendimento | config:ler | leitura |
list_quick_replies | Lista as respostas prontas | config:ler | leitura |
list_distribution_rules | Lista as regras de distribuição | config:ler | leitura |
propose_create_queue | Propõe criar uma fila | config:escrever | escrita |
propose_update_queue | Propõe alterar uma fila | config:escrever | escrita |
propose_create_label | Propõe criar uma etiqueta | config:escrever | escrita |
propose_create_distribution_rule | Propõe criar uma regra de distribuição | config:escrever | escrita |
propose_create_attendance_hours | Propõe criar um horário de atendimento | config:escrever | escrita |
propose_create_quick_reply | Propõe criar uma resposta pronta | config:escrever | escrita |
propose_update_quick_reply | Propõe alterar uma resposta pronta | config:escrever | escrita |
Contatos
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
search_contacts | Busca contatos | config:ler, contatos:ler | leitura |
get_contact | Mostra um contato | contatos:ler | leitura |
get_contact_history | Mostra o histórico de um contato | contatos:ler, mensagens:ler | leitura |
propose_create_contact | Propõe criar um contato | contatos:escrever | escrita |
propose_update_contact | Propõe alterar um contato | contatos:escrever | escrita |
propose_label_contact | Propõe etiquetar um contato | contatos:escrever | escrita |
Conversas
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_open_tickets | Lista os tickets abertos | config:ler, conversas:ler | leitura |
list_conversations | Lista conversas | conversas:ler | leitura |
get_conversation_messages | Lê as mensagens de uma conversa | conversas:ler, mensagens:ler | leitura |
propose_assign_conversation | Propõe atribuir a conversa a um atendente | conversas:escrever | escrita |
propose_transfer_conversation | Propõe transferir a conversa | conversas:escrever | escrita |
propose_close_conversation | Propõe encerrar a conversa | conversas:escrever | escrita |
propose_open_ticket | Propõe abrir um ticket | conversas:escrever | escrita |
propose_internal_note | Propõe uma nota interna | conversas:escrever | escrita |
propose_label_conversation | Propõe etiquetar a conversa | conversas:escrever | escrita |
Envios, campanhas e modelos
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_message_templates | Lista os modelos de mensagem | config:ler | leitura |
list_campaigns | Lista as campanhas | mensagens:ler | leitura |
get_campaign | Mostra uma campanha | mensagens:ler | leitura |
get_number_quality | Mostra a qualidade do número | mensagens:ler | leitura |
propose_send_text | Propõe enviar um texto | mensagens:escrever | externa |
propose_send_template | Propõe enviar um modelo | mensagens:escrever | externa |
propose_send_media | Propõe enviar uma mídia | mensagens:escrever | externa |
propose_send_active_message | Propõe uma mensagem ativa | mensagens:escrever | externa |
propose_create_campaign | Propõe uma campanha, com prévia por destinatário | mensagens:escrever | externa |
propose_cancel_campaign | Propõe cancelar uma campanha | mensagens:escrever | escrita |
propose_create_template | Propõe criar um modelo e submetê-lo à Meta | modelos:escrever | externa |
Fluxos (bot)
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_flows | Lista os fluxos | config:ler | leitura |
get_flow_blocks | Lista os blocos de um fluxo | config:ler | leitura |
get_flow_design | Lê o desenho completo de um fluxo | config:ler | leitura |
validate_flow | Valida um fluxo | config:ler | leitura |
propose_create_flow | Propõe criar um fluxo | fluxos:escrever | escrita |
propose_update_flow | Propõe alterar um fluxo | fluxos:escrever | escrita |
propose_save_flow_design | Propõe gravar o desenho do fluxo como rascunho | fluxos:escrever | escrita |
propose_publish_flow | Propõe publicar o fluxo | fluxos:escrever | escrita |
Equipe, SLA e pausas
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_members | Lista os membros da conta | config:ler (chave da organização) | leitura |
list_roles | Lista os papéis | config:ler (chave da organização) | leitura |
propose_invite_member | Propõe convidar uma pessoa por e-mail | equipe:escrever (chave da organização) | externa |
propose_set_member_role | Propõe trocar o papel de um membro | equipe:escrever (chave da organização) | escrita |
propose_link_agent_to_queue | Propõe colocar um atendente numa fila | config:escrever | escrita |
propose_unlink_agent_from_queue | Propõe tirar um atendente de uma fila | config:escrever | escrita |
propose_set_agent_status | Propõe mudar a presença de um atendente | equipe:escrever | escrita |
list_sla_rules | Lista as regras de SLA | config:ler | leitura |
propose_create_sla_rule | Propõe criar uma regra de SLA | config:escrever | escrita |
list_pause_reasons | Lista os motivos de pausa | config:ler | leitura |
propose_create_pause_reason | Propõe criar um motivo de pausa | config:escrever | escrita |
Canais, webhooks e chaves
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
list_channels | Lista os canais | config:ler | leitura |
get_channel_health | Mostra a saúde de um canal | config:ler | leitura |
list_webhooks | Lista os webhooks | config:ler | leitura |
propose_create_webhook | Propõe criar um webhook | integracoes:escrever | escrita |
list_api_keys | Lista as chaves de API | config:ler | leitura |
propose_create_api_key | Propõe criar uma chave de API | integracoes:escrever | escrita |
Relatórios e plano
| Ferramenta | O que faz | Escopo | Risco |
|---|---|---|---|
get_attendance_report | Relatório de atendimento | relatorios:ler | leitura |
get_effort_report | Relatório de esforço | relatorios:ler | leitura |
get_satisfaction_report | Relatório de satisfação | relatorios:ler | leitura |
get_monitoring_summary | Resumo do monitoramento | relatorios:ler | leitura |
get_plan_and_usage | Plano, faturamento e consumo de IA | cobranca:ler (chave da organização) | leitura |
Resultado esperado
Você sabe quais tarefas o agente consegue fazer e qual chave precisa criar para cada uma.
Boas práticas
- Peça pelo resultado, não pelo nome da ferramenta. O agente escolhe.
- Para mudar algo, peça primeiro a proposta e leia o antes e o depois.
- Para enviar mensagens, confira sempre a prévia de destinatários.
Próximos passos
Perguntas frequentes
Quantas ferramentas o MCP do Pipe tem?
72, contando confirm_change, que aplica as propostas feitas pelas ferramentas propose_*.
O que significa o prefixo propose_?
A ferramenta só propõe a mudança e devolve o plano com um identificador. A mudança só é aplicada depois do confirm_change.
Por que o agente não mostra todas as ferramentas?
Porque a lista depende dos escopos da chave: tools/list mostra só o que ela pode chamar.
Esse artigo foi útil?
Obrigado pelo retorno!