EntrarTeste grátis

MCP e IA · Atualizado em 12/10/2026

Escopos da chave de IA e o que cada um libera

Veja os escopos de uma chave do MCP, a diferença entre chave de fluxo e chave da organização e como escolher o acesso mínimo.

Neste artigo
  1. Quando usar
  2. Pré-requisitos
  3. Passo a passo
  4. Escopos da chave de fluxo
  5. Escopos da chave da organização
  6. Resultado esperado
  7. Boas práticas
  8. Próximos passos
  9. Perguntas frequentes

Cada ferramenta do MCP exige um ou mais escopos, que são as permissões da chave. O agente só enxerga as ferramentas que a chave permite. Os escopos são conferidos na hora de propor e de novo na hora de confirmar.

Quando usar

Ao criar uma chave por conta própria, quando quiser dar a um agente exatamente o acesso de que ele precisa, nem mais, nem menos.

Pré-requisitos

  • Para chaves de um fluxo: acesso às configurações do fluxo na Gestão.
  • Para chaves da organização: acesso às chaves de API da organização, no console do CRM.

Passo a passo

  1. Defina o que o agente precisa fazer: só olhar, configurar o atendimento ou operar tudo.
  2. Para uma chave de fluxo, escolha um dos três níveis do campo Agente de IA (MCP), descritos em Como conectar um agente de IA ao Pipe.
  3. Para uma chave da organização, abra Configurações e Chaves de API no console do CRM e marque os escopos da tabela abaixo, um a um.
  4. Teste com uma pergunta simples e confira, no cliente, quais ferramentas aparecem.

Escopos da chave de fluxo

NívelEscopos
Só leitura da configuraçãoconfig:ler
Leitura e propostas de mudançaconfig:ler, config:escrever
Completoos anteriores, mais fluxos:escrever, modelos:escrever, conversas:*, mensagens:*, contatos:ler/escrever e relatorios:ler

Escopos da chave da organização

EscopoLibera
config:lerEntrar no MCP e ler cadastros, guias e checklist. Obrigatório
config:escreverPropor filas, horários, regras, respostas prontas, SLA, pausas e vínculo entre atendente e fila
contatos:ler / contatos:escreverVer contato e histórico / criar e editar contato
contatos:piiVer telefone, e-mail e documento do contato
conversas:ler / conversas:escreverListar e ler conversas / atribuir, transferir, encerrar, abrir ticket, nota interna e etiquetar
mensagens:ler / mensagens:escreverVer campanhas e qualidade do número / enviar texto, modelo, mídia, mensagem ativa e campanha
modelos:escreverCriar modelo e submeter à Meta
fluxos:escreverCriar fluxo, gravar rascunho e publicar
equipe:escreverConvidar pessoas, trocar papel e definir presença do atendente
integracoes:escreverCriar webhook e chave de API
relatorios:lerRelatórios de atendimento, esforço, satisfação e monitoramento
cobranca:lerPlano, faturamento e consumo de IA

Resultado esperado

O agente vê somente as ferramentas compatíveis com a chave, e uma ação fora do escopo simplesmente não está disponível.

Boas práticas

  • Dê contatos:pii só quando o agente realmente precisar do telefone, do e-mail ou do documento.
  • Separe chaves de leitura e de escrita. Quem só consulta relatórios não precisa de mensagens:escrever.
  • Revise as chaves de tempos em tempos e remova as que não são mais usadas.

Próximos passos

Perguntas frequentes

Qual escopo é obrigatório?

config:ler. Sem ele, o endpoint do MCP responde 403.

Por que o agente não vê telefone dos contatos?

Telefone, e-mail e documento só aparecem com o escopo contatos:pii. Sem ele, o telefone vem mascarado, como ***1234.

A chave de um fluxo vê a conta inteira?

Não. Ela só enxerga e altera o próprio fluxo (num roteador, também os serviços dele) e não serve para membros, papéis, convites, plano e criação de fluxo.

Como a lista de ferramentas muda conforme a chave?

A chamada tools/list mostra só as ferramentas que a chave pode usar.