EntrarTeste grátis

MCP e IA · Atualizado em 12/10/2026

Solução de problemas do MCP do Pipe

Resolva erros 401, 403, 405 e 429, proposta expirada ou desatualizada, ferramenta que não aparece e telefone mascarado ao usar o MCP.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo
  4. Problemas comuns
  5. Resultado esperado
  6. Boas práticas
  7. Próximos passos
  8. Perguntas frequentes

Use este artigo quando a conexão falhar, uma ferramenta não aparecer ou uma confirmação for recusada.

Quando usar

Quando o agente responde com erro, não encontra uma ferramenta ou não consegue aplicar uma proposta.

Pré-requisitos

Saber qual chave o agente usa e quais escopos ela tem. Veja Escopos da chave.

Passo a passo

  1. Identifique o sintoma na tabela abaixo.
  2. Aplique a correção indicada.
  3. Se a conexão em si for o problema, teste com o curl de Como conectar um agente de IA ao Pipe: uma chamada sem chave deve dar 401, e com uma chave de config:ler, o ping deve dar 200.

Problemas comuns

SintomaCausaO que fazer
401Chave ausente, errada ou removidaEnvie Authorization: Bearer pipe_… em toda requisição e, se preciso, crie uma chave nova
403A chave não tem config:lerCrie uma chave com esse escopo
403 vindo de um navegadorO MCP recusa chamadas com cabeçalho OriginUse um cliente MCP de desktop ou de linha de comando, não uma página web
405 em GET /mcpO MCP só aceita POSTConfigure o cliente para HTTP com POST, sem fluxo de eventos
429Passou de 120 chamadas por minuto na chaveAguarde o tempo indicado no cabeçalho Retry-After
Uma ferramenta não apareceA chave não tem o escopo delaVeja a lista de escopos e crie uma chave com o necessário
Ferramentas de equipe ou de plano ausentesExigem chave da organização, não de fluxoUse uma chave da organização
proposal_expiredPassaram mais de 10 minutosPeça uma nova proposta
proposal_usedA proposta já foi aplicadaNão é preciso fazer nada. Para repetir a ação, peça uma nova proposta
proposal_staleO item mudou entre a proposta e a confirmaçãoPeça uma nova proposta com o estado atual
Confirmação recusadaA pessoa dona da chave perdeu a permissão ou foi desativada, ou a conta é somente leituraRevise a permissão do responsável pela chave
Telefone mascarado (***1234)A chave não tem contatos:piiAdicione o escopo, se for realmente necessário
Envio recusadoContato bloqueado, janela de 24 horas fechada ou teto de destinatáriosUse um modelo aprovado para a janela fechada, ou reduza o público
Envio falhou com erro 131042Falta forma de pagamento na MetaCadastre a forma de pagamento no gerenciador da Meta

Resultado esperado

A conexão volta a funcionar ou o agente consegue refazer a proposta e aplicar a mudança.

Boas práticas

  • Peça ao agente para confirmar a proposta logo depois de você aprovar, para não expirar.
  • Guarde a chave em um lugar seguro. Se suspeitar de vazamento, crie outra e remova a antiga.

Próximos passos

Perguntas frequentes

Recebi 401 ao conectar. O que fazer?

A chave não foi enviada ou está incorreta. Confira se o cabeçalho Authorization: Bearer pipe_… vai em toda requisição e se a chave não foi removida.

Recebi 403. O que significa?

A chave não tem o escopo config:ler, que é obrigatório, ou a chamada partiu de um navegador (cabeçalho Origin), o que o MCP recusa.

Minha proposta expirou. E agora?

Peça ao agente uma nova proposta. Cada proposta vale 10 minutos e uma única confirmação.

Por que o telefone aparece como ***1234?

Porque a chave não tem o escopo contatos:pii. Com ele, o agente vê telefone, e-mail e documento.