1
Get an API key
Go to app.atako.ai → Settings → API keys → Create
key. Copy it immediately — it’s shown once. See API keys
for details.
2
Add the server to your client
Pick your client below.
3
Try it
Ask your client something like “list my Atako agents” or “what’s my Atako
credit balance?” — it should call
list_agents / get_credits and answer from
the result. Once that works, try something that writes: “create an agent that
triages my Zendesk tickets” or “send a message to my support agent and wait
for the reply.”- Claude Code
- Claude Desktop
- Cursor
- ChatGPT (developer mode)
claude mcp list, or /mcp inside a Claude Code session.No account, just curious?
https://api.atako.ai/mcp/public needs no API key and exposes 3 tools —
get_pricing, list_use_cases, list_integration_pages — the same content
available on atako.ai without signing in. Configure it the same
way as above, just without the Authorization header.
Troubleshooting
My client says it can't connect
My client says it can't connect
Confirm the URL is exactly
https://api.atako.ai/mcp (no trailing slash issues,
https, no typo in atako) and that your client supports the Streamable HTTP
transport (all four clients above do).I get an authentication / 401 error
I get an authentication / 401 error
Check the header is exactly
Authorization: Bearer aik_... — the full key,
including the aik_ prefix, with no extra whitespace. If the key was revoked
from Settings → API keys, create a new one.A tool call fails or says 'not found'
A tool call fails or says 'not found'
Most tools take an
agentId — get one first from list_agents. A “not found”
error on get_agent/list_messages/etc. usually means the id belongs to an
agent your key’s owner can’t access, or doesn’t exist.A write tool fails with AGENT_LIMIT_REACHED or NO_ACTIVE_SUBSCRIPTION
A write tool fails with AGENT_LIMIT_REACHED or NO_ACTIVE_SUBSCRIPTION
create_agent, resume_agent, and retry_agent_provisioning are subject to the
same seat-limit and subscription checks as the app’s own “Create an agent”
button. The tool error names the next step — e.g. end an agent you no longer
need to free a seat, or subscribe from app.atako.ai → Settings → Billing.My client won't finish connecting an integration
My client won't finish connecting an integration
An OAuth-only provider can’t be connected purely through MCP —
get_connect_url
only gives you the authorization URL; you still have to open it in a browser and
grant consent yourself. For a provider that accepts a pasted API key/token
instead, use create_integration_connection, which needs no browser step.