Resolução de problemas
O assistente de IA diz que não se consegue ligar
Confirma o endereço: tem de ser exatamente https://mcp.atendia.pt/mcp, com /mcp no fim. Confirma que a chave vai no cabeçalho x-api-key, sem espaços antes ou depois. Se colaste um bloco num ficheiro, confirma que o ficheiro continua válido, sem vírgulas a mais ou a menos. Se o teu assistente não tem onde pôr um cabeçalho, ainda não se consegue ligar ao Atendia MCP.
O assistente de IA não mostra nada para usar
O MCP oferece 22 ferramentas só de leitura e os mesmos dados como recursos. Se o assistente se liga mas não mostra nada, confirma que o servidor «atendia» está ativo na lista de servidores MCP do assistente e que a chave vai no cabeçalho x-api-key.
Pelo código de erro
401 Não autorizado
A mensagem é «Invalid Atendia API key.» ou «Missing Atendia API key.». O assistente não enviou a chave, ou a API da Atendia não a aceita (revogada ou mal copiada). Envia a chave no cabeçalho x-api-key ou em Authorization: Bearer <chave>. Um cookie da consola não serve.
403 Permissões insuficientes
A chave é válida, mas a API recusou esta leitura. Com os dois tipos de chave de hoje, «Só leitura» e «Leitura e chamadas», todas as ferramentas e recursos do MCP funcionam. Se vires este erro, escreve para suporte@atendia.pt.
404 Sessão ou registo não encontrado
«Session not found» quer dizer que a sessão acabou: fecha ao fim de 30 minutos sem pedidos, ou foi aberta com outra chave. O assistente de IA abre uma sessão nova. «Atendia API answered 404» quer dizer que o id pedido não existe na tua organização.
429 Demasiados pedidos
Cada chave pode fazer 60 pedidos por minuto à API da Atendia, e cada leitura do MCP conta, também ao abrir uma sessão. Espera um minuto. Cada chave tem até 10 sessões abertas: ao abrir mais uma, a mais antiga fecha. De um só endereço IP, podem estar abertas até 20 sessões ao todo; acima disso a resposta é 429 até uma fechar.
502 A Atendia não confirmou a chave
A mensagem é «Atendia API could not check the key.». A API da Atendia não respondeu a tempo. Tenta outra vez daqui a um minuto.
503 Demasiadas sessões abertas
A mensagem é «Too many open MCP sessions.». O servidor está no máximo de sessões. Tenta outra vez daqui a uns minutos.
Não resolveu?
Escreve para suporte@atendia.pt com o nome do teu assistente de IA e a mensagem de erro. Nunca envies a chave.