Páginas do MCP

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.