MCP e IA · Atualizado em 12/10/2026

Como a segurança do MCP funciona

Propostas em duas etapas, prévia de envios, teto e orçamento diário, auditoria e limites: o que protege seu atendimento quando uma IA opera o Pipe.

O MCP foi desenhado para que uma IA possa ajudar sem poder causar estrago. A regra central é simples: ler é livre, mudar e enviar exigem a sua confirmação.

Quando usar

Leia este artigo antes de dar a uma chave permissão de escrita ou de envio, para saber o que protege a sua operação.

Pré-requisitos

Ter uma chave de IA criada. Veja Como conectar um agente de IA ao Pipe.

Passo a passo

Veja o ciclo de uma mudança, do pedido até a aplicação:

  1. Você pede algo ao agente, por exemplo "crie a fila Financeiro".
  2. O agente chama uma ferramenta propose_*. O Pipe valida o pedido, confere a permissão e os conflitos, e guarda o plano.
  3. O agente mostra o plano, com o antes e o depois, e um identificador de proposta.
  4. Você responde "pode".
  5. O agente chama confirm_change com o identificador, e só então a mudança é aplicada.

Regras da confirmação

  • Só a mesma chave que propôs pode confirmar.
  • Cada proposta vale uma vez só.
  • A confirmação precisa acontecer em até 10 minutos.
  • Se o item mudou entre a proposta e a confirmação, ela é recusada (proposal_stale) e é preciso propor de novo.
  • Cada chave pode ter no máximo 20 propostas abertas.
  • Os escopos são conferidos de novo na confirmação.

Envios para clientes

Ações que saem da plataforma, como mensagem ao cliente, modelo para a Meta e convite por e-mail, não têm volta. Por isso:

  • A proposta traz a prévia exata do que cada destinatário recebe, o número de destinatários e a categoria de cobrança da Meta. O preço por conversa depende da tabela da Meta e o Pipe não o calcula.
  • Contatos bloqueados são recusados.
  • A janela de 24 horas é conferida na proposta e de novo no envio.
  • Há um teto de 50 destinatários por confirmação e um orçamento de 200 destinatários por dia, por chave.
  • Uma proposta externa confirmada é consumida antes do envio: se o envio falhar, o mesmo identificador nunca reenvia.

Dados de pessoas e segredos

  • Telefone, e-mail e documento só aparecem com o escopo contatos:pii. Sem ele, o telefone vem mascarado.
  • Nomes, mensagens e textos vindos de dados voltam marcados como não confiáveis, e o servidor instrui o modelo a nunca seguir instruções escondidas neles.
  • A auditoria não guarda telefones nem textos de mensagens, só os nomes dos argumentos.
  • O token de uma chave nova aparece uma única vez, na resposta da confirmação.
  • O segredo de webhook e o link de convite não são devolvidos ao agente.

Nada é apagado

Não existe ferramenta de exclusão. "Tirar atendente da fila" e "cancelar campanha" não apagam histórico.

Limites e isolamento

  • 120 chamadas por minuto por chave, além do limite da API. Ao exceder, a resposta é 429 com Retry-After.
  • Corpo de até 64 KB, resposta de até 200 mil caracteres e páginas de até 50 itens.
  • Chamadas feitas por navegador (com cabeçalho Origin) são recusadas com 403.
  • A chave de fluxo só alcança o próprio fluxo, e os dados de cada cliente do Pipe são isolados dos demais.
  • Em conta somente leitura, como a do financeiro, as leituras funcionam e confirm_change é recusado.

Auditoria

Cada chamada grava uma linha de auditoria: consulta para leituras, criação para propostas e alteração para confirmações. As ações confirmadas também aparecem na auditoria do próprio recurso.

Resultado esperado

Você enxerga o que vai acontecer antes de acontecer, e tudo o que a IA fez fica registrado.

Boas práticas

  • Leia a prévia de cada campanha antes de dizer "pode".
  • Use chaves separadas para leitura e para envio.
  • Não compartilhe a chave em conversas, e-mails ou repositórios.

Próximos passos

Perguntas frequentes

A IA pode mudar algo sem eu confirmar?

Não. Toda ferramenta que muda ou envia algo funciona em duas etapas: primeiro uma proposta (propose_*), depois a confirmação com confirm_change. Só leituras são diretas.

Quanto tempo vale uma proposta?

Até 10 minutos, uma única vez, e só para a mesma chave que propôs. Depois disso é preciso propor de novo.

Existe limite de envios por IA?

Sim: 50 destinatários por confirmação e 200 destinatários por dia, por chave. São os valores padrão e podem ser ajustados pela operação do Pipe.

A IA consegue apagar dados?

Não. O MCP não tem nenhuma ferramenta de exclusão.

As ações da IA ficam registradas?

Sim. Cada chamada grava uma linha de auditoria, e as ações confirmadas também deixam a auditoria do próprio recurso.