Servidor MCP ou chave de API: como a tua IA deve ligar-se ao FoxEra Calls.
Ambos os métodos dão ao teu assistente de IA ou ao teu código as mesmas ferramentas e as mesmas regras de segurança. A escolha certa depende de se é uma pessoa a conversar ou código a executar.
Duas formas de ligar, um único conjunto de regras
O FoxEra Calls oferece dois métodos de ligação para assistentes de IA e integrações de programadores:
- Servidor MCP — um endpoint MCP remoto que usa HTTP em streaming e OAuth 2.1. O teu assistente liga-se a ele como a qualquer outro servidor MCP.
- API REST com chave bearer — uma API HTTP padrão descrita em OpenAPI 3.1. O teu código envia pedidos com um token bearer
fxk_....
Ambos os métodos expõem as mesmas capacidades: gestão de contactos, criação e aprovação de campanhas, transcrições, gravações, relatórios, horário de chamadas, seleção de agente e edição de guião. Ambos aplicam as mesmas regras de segurança — número confirmado, aprovação em separado, acesso limitado e registo completo. A diferença está em como a ligação é estabelecida e quem a controla.
Quando usar o servidor MCP
Usa o servidor MCP quando uma pessoa está a interagir com um assistente de IA numa janela de chat e quer que o assistente giria a sua conta FoxEra em seu nome. Isto encaixa em:
- ChatGPT, Claude, Cursor — adiciona o servidor MCP remoto em https://app.foxera.co.uk/mcp, inicia sessão e clica em Permitir. O assistente consegue então adicionar contactos, pré-visualizar campanhas e fazer chamadas depois da tua aprovação, tudo a partir do chat.
- Qualquer assistente que suporte MCP remoto — a ligação é HTTP em streaming padrão com OAuth 2.1, por isso qualquer cliente compatível consegue usá-la.
A via MCP é ideal para fundadores e pequenas equipas que já usam um assistente de IA diariamente e querem gerir as chamadas a frio a partir do mesmo chat que usam para tudo o resto. Sem código para escrever, nada para instalar.
Quando usar uma chave de API
Usa uma chave de API bearer quando o teu próprio código, um script ou uma plataforma de automação precisa de chamar a FoxEra de forma programática. Isto encaixa em:
- Integrações de CRM — envia contactos novos do teu CRM para a FoxEra e recupera os resultados automaticamente.
- Plataformas de automação — ativa uma campanha a partir do n8n, do Make ou de um webhook do Zapier quando chega um contacto novo ao teu processo.
- GPT Actions — importa a especificação OpenAPI 3.1 para um GPT personalizado. O URL da especificação é tudo o que precisas de configurar.
- Agentes personalizados — cria um agente que corre sem supervisão, investiga potenciais clientes, adiciona-os e prepara uma campanha para a tua aprovação de manhã.
Gera uma chave nas tuas definições para programadores. Cada chave está limitada a um espaço de trabalho e pode ser revogada instantaneamente.
Como funciona o modelo de segurança em cada caso
Ambos os métodos de ligação aplicam as mesmas regras de segurança do lado do servidor:
- Número confirmado — a pré-visualização da campanha tem de ser reconhecida antes da aprovação, quer venha de uma chamada a uma ferramenta MCP quer de um pedido à API.
- Aprovação em separado — criar e aprovar uma campanha são dois passos distintos. Nenhum dos métodos permite combiná-los.
- Horário de chamadas — as chamadas só são feitas dentro do teu horário configurado, independentemente de quando a aprovação foi enviada.
- Acesso limitado — uma sessão MCP está vinculada à tua concessão OAuth; uma chave de API está vinculada ao teu espaço de trabalho. Nenhuma consegue aceder aos dados de outro cliente.
- Revogação — mudar a tua palavra-passe desliga todas as sessões MCP. Revogar uma chave de API para todo o acesso a partir dessa chave de imediato.
Lê o detalhe completo das medidas de segurança para agentes de IA em chamadas ativas.
Podes usar os dois ao mesmo tempo?
Sim. Muitas configurações usam os dois métodos para partes diferentes do fluxo de trabalho:
- O teu assistente de IA usa o servidor MCP para o trabalho interativo — adicionar alguns contactos a partir da conversa, pré-visualizar uma campanha, ler resultados.
- O teu backend usa uma chave de API para operações em massa — sincronizar centenas de contactos de um CRM durante a noite, extrair relatórios diários para um painel.
Os dois métodos partilham os mesmos dados de conta subjacentes. Um contacto adicionado através da API aparece na próxima listagem do teu assistente, e uma campanha aprovada através do servidor MCP aparece num relatório da API. Não há conflito nem duplicação.
Se não tiveres a certeza por onde começar, o servidor MCP é mais rápido de configurar (três passos, sem código). Podes adicionar uma chave de API mais tarde quando precisares de acesso programático. Consulta chamadas com IA de pagamento por utilização para ver como o preço funciona com qualquer um dos métodos.
Custos
Ambos os métodos de ligação são grátis de usar. Só pagas pelas chamadas que se ligam, a partir de 12p por minuto ligado, sem subscrição nem taxa de plataforma. As contas novas começam com £7 de crédito grátis para chamadas.
Não há diferença no preço das chamadas entre o servidor MCP e a API. Quer o teu assistente aprove uma campanha via MCP quer o teu código a aprove via API, a tarifa por minuto é a mesma. Usa a calculadora de custos para estimar uma campanha antes de começares.
Perguntas frequentes
O servidor MCP é mais difícil de configurar do que uma chave de API?
Não, é mais fácil. Cola o URL no teu assistente, inicia sessão e clica em Permitir. Uma chave de API exige gerar a chave, guardá-la em segurança e escreveres tu mesmo os pedidos HTTP ou importar a especificação OpenAPI.
As ligações MCP e por chave de API têm regras de segurança diferentes?
Não. Ambas aplicam número confirmado, aprovação em separado, horário de chamadas, acesso limitado e registo completo. As regras são do lado do servidor e aplicam-se a todos os métodos de ligação.
Posso mudar de MCP para chave de API mais tarde?
Sim. Podes adicionar ou remover qualquer um dos métodos de ligação a qualquer momento. Ambos partilham os mesmos dados de conta, por isso nada se perde ao mudares ou usares os dois.
Quanto custa?
Ambos os métodos são grátis para ligar. Só pagas pelos minutos de chamada ligados, a partir de 12p por minuto ligado. As contas novas recebem £7 de crédito grátis para chamadas.