MCP pages

Troubleshooting

The assistant says it cannot connect

Check the address: it must be exactly https://mcp.atendia.pt/mcp, with /mcp at the end. Check that the key goes in the x-api-key header, with no spaces before or after. If you pasted a block into a file, check that the file is still valid, with no missing or extra commas. If your assistant has nowhere to put a header, it cannot connect to Atendia MCP yet.

The client shows nothing to use

The MCP offers 22 read-only tools and the same data as resources. If the assistant connects but shows nothing, check that the «atendia» server is on in the assistant's list of MCP servers and that the key goes in the x-api-key header.

By error code

401 Unauthorized

The message is «Invalid Atendia API key.» or «Missing Atendia API key.». The assistant sent no key, or the Atendia API does not accept it (revoked or copied wrong). Send the key in the x-api-key header or in Authorization: Bearer <key>. A console cookie does not work.

403 Insufficient permissions

The key is valid, but the API refused this read. With today's two key types, «Read only» and «Read and calls», every MCP tool and resource works. If you see this error, write to suporte@atendia.pt.

404 Session or record not found

«Session not found» means the session ended: it closes after 30 minutes without requests, or another key opened it. The client opens a new session. «Atendia API answered 404» means the requested id does not exist in your organization.

429 Too many requests

Each key can make 60 requests a minute to the Atendia API, and every MCP read counts, also when a session opens. Wait a minute. Each key has up to 10 open sessions: opening one more closes the oldest. From one IP address, up to 20 sessions can be open in all; past that the answer is 429 until one closes.

502 Atendia could not check the key

The message is «Atendia API could not check the key.». The Atendia API did not answer in time. Try again in a minute.

503 Too many open sessions

The message is «Too many open MCP sessions.». The server is at its session limit. Try again in a few minutes.

Still stuck?

Write to suporte@atendia.pt with the name of your assistant and the error message. Never send the key.