Resolução de problemas

O conector do ChatGPT ou Claude não funciona? Faz estas seis verificações.

Se o teu assistente de IA não conseguir aceder ao FoxEra Calls, o problema é quase sempre um destes seis. Percorre esta lista antes de abrires um pedido de suporte.

Verificação 1: estás a usar o URL correto

O URL do conector para o FoxEra Calls é:

https://app.foxera.co.uk/mcp

Os erros comuns incluem esquecer o caminho /mcp, usar http em vez de https, ou copiar um URL antigo de um guia desatualizado. Se vires um erro de ligação recusada ou 404, verifica o URL carácter a carácter.

Este URL funciona com qualquer assistente que suporte servidores MCP remotos, incluindo o ChatGPT, o Claude, o Cursor e outros. O guia para programadores tem capturas de ecrã passo a passo para cada assistente.

Verificação 2: iniciaste sessão e clicaste em Permitir

Quando adicionas o conector, o teu assistente abre uma página de início de sessão do FoxEra Calls. Precisas de:

  • Iniciar sessão com o email e a palavra-passe da tua conta FoxEra.
  • Clicar em Permitir no ecrã de autorização para dar ao assistente acesso ao teu espaço de trabalho.

Se fechaste a janela de início de sessão antes de clicares em Permitir, ou se a página expirou, o conector vai aparecer como adicionado mas sem ferramentas disponíveis. Remove o conector e adiciona-o novamente, garantindo que completas os dois passos.

Verificação 3: o modo de programador está ativado onde é necessário

Alguns assistentes exigem que atives um modo de programador ou avançado antes de mostrarem conectores personalizados. Por exemplo:

  • ChatGPT — os conectores personalizados e os servidores MCP podem exigir um plano ChatGPT Plus ou Team. Verifica as definições do teu plano.
  • Claude — a funcionalidade de MCP remoto pode precisar de ser ativada nas definições da tua conta ou organização.
  • Cursor — os servidores MCP são configurados no ficheiro de definições. Certifica-te de que a entrada é guardada e o editor é reiniciado.

Se o teu assistente mostrar a opção de conector mas listar zero ferramentas depois de ligar, esta é a causa mais provável. Consulta a documentação do próprio assistente sobre os requisitos de MCP ou conectores personalizados.

Verificação 4: mudaste a tua palavra-passe recentemente

Mudar a tua palavra-passe do FoxEra Calls desliga imediatamente todos os assistentes ligados. Esta é uma funcionalidade de segurança — garante que nenhum assistente mantém acesso depois de uma mudança de palavra-passe.

Se o teu conector deixou de funcionar depois de mudares a palavra-passe, remove o conector do teu assistente e adiciona-o novamente usando o mesmo URL. Inicia sessão com a tua nova palavra-passe e clica em Permitir.

O mesmo se aplica se a tua conta foi bloqueada e desbloqueada, ou se repuseste a tua palavra-passe por email. Qualquer evento que invalide a tua sessão também invalida todas as ligações de assistentes.

Verificação 5: a tua chave de API foi revogada

Se te estás a ligar através da API REST em vez do servidor MCP, a tua chave bearer (fxk_...) pode ter sido revogada. Isto acontece quando:

  • Tu ou outro membro do espaço de trabalho a revogou nas definições para programadores.
  • Geraste uma chave nova e a antiga foi substituída automaticamente.

Verifica as tuas definições para programadores para ver as chaves ativas. Se nenhuma chave estiver listada, gera uma nova e atualiza a tua integração. A documentação da API explica como as chaves funcionam.

Se usas o conector MCP (não uma chave bearer), esta verificação não se aplica — o conector usa OAuth, não uma chave estática.

Verificação 6: o teu assistente não suporta MCP remoto

Nem todos os assistentes de IA suportam servidores MCP remotos ainda. Se o teu assistente não tiver opção para adicionar um conector personalizado ou um servidor MCP remoto, não consegue ligar-se ao FoxEra Calls pela via MCP.

As tuas alternativas nesse caso:

  • Usa a API REST com uma chave bearer. Qualquer ferramenta que consiga fazer pedidos HTTP consegue chamar a API. A especificação OpenAPI 3.1 documenta cada endpoint.
  • Usa uma GPT Action se estiveres no ChatGPT — importa o URL da especificação OpenAPI diretamente.
  • Muda de assistente — ChatGPT, Claude e Cursor suportam todos o conector hoje.

A comparação entre MCP e chave de API explica qual método se adapta à tua configuração.

Perguntas frequentes

Porque é que o meu conector mostra zero ferramentas?

Provavelmente fechaste a janela de início de sessão antes de clicares em Permitir, ou o teu assistente exige que o modo de programador esteja ativado. Remove o conector, adiciona-o novamente com o URL https://app.foxera.co.uk/mcp, inicia sessão por completo e clica em Permitir.

Mudar a minha palavra-passe desliga o meu assistente de IA?

Sim. Mudar a tua palavra-passe da FoxEra invalida todas as sessões de assistentes ligados. Volta a ligar removendo e adicionando novamente o conector, depois inicia sessão com a tua nova palavra-passe.

Posso usar a API se o meu assistente não suportar MCP?

Sim. A API REST usa chaves bearer e funciona a partir de qualquer cliente HTTP, plataforma de automação ou GPT Action. A especificação OpenAPI 3.1 está em https://app.foxera.co.uk/api/public/openapi.json.

Começa grátis com £7 de crédito para chamadas