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:
- Você pede algo ao agente, por exemplo "crie a fila Financeiro".
- O agente chama uma ferramenta
propose_*. O Pipe valida o pedido, confere a permissão e os conflitos, e guarda o plano. - O agente mostra o plano, com o antes e o depois, e um identificador de proposta.
- Você responde "pode".
- O agente chama
confirm_changecom 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.
Esse artigo foi útil?
Obrigado pelo retorno!