Modelo de segurança
O MCP só lê. O que nenhuma chave pode fazer, ou não deve fazer pelo MCP, fica de fora e aparece abaixo com o motivo. Assim, o teu assistente de IA não tem ações perigosas para aprovar.
O que cada chave faz pelo MCP
- «Só leitura»: consulta agentes, chamadas, campanhas, números, ferramentas, base de conhecimento e widgets. Chega para o MCP.
- «Leitura e chamadas»: lê o mesmo e, pela API, também pede e cancela chamadas de saída. Pelo MCP, faz o mesmo que a «Só leitura»: o MCP não faz chamadas.
O que fica de fora
Em resumo, pelo MCP o teu assistente de IA não consegue: criar, alterar ou apagar agentes, ferramentas, widgets ou a base de conhecimento; fazer, terminar, cancelar ou repetir chamadas; comprar, associar ou apagar números; ler os segredos da organização. Tudo isto faz-se na consola.
Ver a lista técnica (45 ações)
GET /ready
O estado de prontidão mostra os serviços internos da Atendia. A entrada pública nunca o publica, e o MCP também não.
POST /agents
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /agents/:agentId/preview-session
Uma conversa de teste com um agente gasta saldo ou minutos de teste grátis. Uma chave API nunca a pode abrir; testa o agente na consola.
PATCH /agents/:id
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /agents/:agentId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /agents/:agentId/config
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /calls/live/end
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /calls/:callId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /kb
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
GET /kb/upload-url
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
PATCH /kb/:kbId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /kb/:kbId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
GET /numbers/search
A pesquisa de números faz parte de associar um número, que só se faz na consola. Nenhuma chave API pode pesquisar: a API responde 403 aos dois tipos de chave.
POST /numbers
Operação que move dinheiro, só para sessões iniciadas na consola. As chaves API da organização e os clientes MCP não podem comprar números de telefone.
PATCH /numbers/:phId
A gestão de números é só para proprietários ou administradores com sessão iniciada na consola; não fica disponível a clientes MCP com chave API.
DELETE /numbers/:phId
Operação destrutiva de faturação, só para sessões iniciadas na consola. Os clientes MCP com chave API não podem libertar números de telefone.
POST /outbound-calls
Faz uma chamada real, com custo. As chamadas de saída não estão disponíveis pelo MCP.
POST /outbound-calls/quick
Faz uma chamada real, com custo. As chamadas de saída não estão disponíveis pelo MCP.
GET /outbound-calls/batch-upload-url
Serve só para carregar a lista de uma campanha. As campanhas não estão disponíveis pelo MCP.
POST /outbound-calls/batches
Inicia uma campanha de chamadas reais, com custo. As campanhas não estão disponíveis pelo MCP.
POST /outbound-calls/batches/list
Inicia uma campanha de chamadas reais, com custo. As campanhas não estão disponíveis pelo MCP.
GET /outbound-calls/batches/:campaignId/results.csv
Responde com um ficheiro CSV de qualquer tamanho, não com JSON. Pelo MCP, lê as chamadas da campanha uma página de cada vez, com get_batch_campaign.
POST /outbound-calls/batches/:campaignId/cancel
Altera uma campanha em curso. As ações de campanha não estão disponíveis pelo MCP.
POST /outbound-calls/:outboundId/cancel
Altera uma chamada agendada ou em curso. As ações de chamada não estão disponíveis pelo MCP.
POST /outbound-calls/:outboundId/retry
Faz uma nova chamada real, com custo. As ações de chamada não estão disponíveis pelo MCP.
POST /tools
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
PATCH /tools/:toolId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /tools/:toolId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /tools/:toolId/attach/:agentId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /tools/:toolId/detach/:agentId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
GET /secrets
As chaves API nunca leem os segredos da organização: a API responde 403 aos dois tipos de chave.
POST /secrets
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /secrets/:secretId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /agents/:agentId/widgets
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
PATCH /widgets/:widgetId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
DELETE /widgets/:widgetId
Nenhuma chave API pode alterar isto: as chaves «Só leitura» e «Leitura e chamadas» só leem estes dados, e a API responde 403 às duas. Faz a alteração na consola.
POST /calls
Serviço interno da Atendia que guarda as chamadas: não fica disponível pelo MCP.
GET /agents/internal-config/:agentId
Serviço interno da Atendia, protegido por uma chave interna: não fica disponível pelo MCP.
GET /agents/number-config/:phoneNumber
Serviço interno da Atendia, protegido por uma chave interna: não fica disponível pelo MCP.
GET /public/widgets/:widgetId/config
Serve o widget no site, no browser de quem o visita. Não faz parte do MCP.
POST /public/widgets/:widgetId/sessions
Ponto de entrada de chamadas do browser público; o MCP deve usar as APIs administrativas do widget, sem representar visitantes do website.
POST /public/widgets/:widgetId/sessions/:sessionId/end
Está ligada ao endToken da sessão do browser; não é uma API geral do MCP.
POST /auth/*
Rotas de autenticação geradas pela biblioteca de login; não ficam disponíveis como ferramenta nem como recurso do MCP.
GET /docs /docs.json
Páginas de documentação ou da interface estática; não são uma ferramenta nem um recurso do MCP.
POST AI app /health, /agents/{id}/config, /voice/*, /kb/*
Serviços internos da Atendia, usados só pela API da Atendia: não ficam disponíveis pelo MCP.