MCP pages

Quickstart

Connect your AI assistant to Atendia MCP in three steps.

Your assistant can then read your organization's agents, calls and transcripts. It changes nothing.

What you need

  • Be an Owner or Administrator of the organization in Atendia, to create the key.
  • An AI assistant that accepts MCP servers with an API key. Step 2 has the list.

1. Create an API key

In the console, go to Settings → API keys and create a «Read only» key. Copy it: you only see it once.

The MCP has no key of its own. It uses your organization's API key, and the Atendia API applies that key's permissions. More about API keys

2. Add Atendia to your AI assistant

Each assistant asks for the address and the key in a different place. You need two things: the server address, below, and the «Read only» key you copied in step 1.

MCP server (Streamable HTTP)
https://mcp.atendia.pt/mcp

Pick your assistant and follow the steps. If it asks for a configuration file, copy the block and replace YOUR_API_KEY with your key, or type it in the field below.

Fill in your key (optional)

Paste your key here and the blocks below include it. You can also leave it empty and replace YOUR_API_KEY later.

Add with one command

  1. Open a terminal in your project folder.
  2. Run the command, with your key in place of YOUR_API_KEY. The key is saved in Claude Code's configuration and in your terminal history.
  3. Run claude mcp list and check that «atendia» shows as connected. In a session, /mcp shows the same.

bash

claude mcp add --transport http atendia https://mcp.atendia.pt/mcp --header "x-api-key: YOUR_API_KEY"

To check, ask your assistant

List my Atendia agents.

3. Check the connection

In your assistant, ask: «List my Atendia agents». The assistant uses the list_agents tool of the «atendia» server and shows your organization's agents.

The assistant may ask for permission before it uses Atendia: allow it. If your agents do not show up, see: Troubleshooting

For developers: the request underneath

Underneath, the assistant sends a request like this one. Tools that read one record ask for its id (for example, get_call_log takes the callId). Filters such as status and limit are optional. The answer is the Atendia API's JSON.

json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_call_logs",
    "arguments": { "status": "COMPLETED", "limit": 5 }
  }
}