Páginas do MCP

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.