Início rápido
Liga o teu assistente de IA ao Atendia MCP em três passos.
O teu assistente passa a ler os agentes, as chamadas e as transcrições da tua organização. Não altera nada.
O que precisas
- Ser Proprietário ou Administrador da organização na Atendia, para criar a chave.
- Um assistente de IA que aceite servidores MCP com uma chave API. O passo 2 tem a lista.
1. Criar uma chave API
Na consola, vai a Definições → Chaves API e cria uma chave «Só leitura». Copia-a: só a vês uma vez.
O MCP não tem uma chave própria. Usa a chave API da tua organização, e a API da Atendia aplica as permissões dessa chave. Mais sobre as chaves API
2. Juntar a Atendia ao teu assistente de IA
Cada assistente pede o endereço e a chave num sítio diferente. Precisas de duas coisas: o endereço do servidor, abaixo, e a chave «Só leitura» que copiaste no passo 1.
- Servidor MCP (Streamable HTTP)
- https://
mcp.atendia.pt/ mcp
Escolhe o teu assistente e segue os passos. Se ele pede um ficheiro de configuração, copia o bloco e troca A_TUA_CHAVE_API pela tua chave, ou escreve-a no campo abaixo.
Preenche a tua chave (opcional)
Cola aqui a tua chave e os blocos abaixo já a levam. Também podes deixar em branco e trocar A_TUA_CHAVE_API depois.
Juntar com um comando
- Abre um terminal na pasta do teu projeto.
- Corre o comando, com a tua chave no lugar de A_TUA_CHAVE_API. A chave fica guardada na configuração do Claude Code e no histórico do terminal.
- Corre claude mcp list e confirma que o «atendia» aparece ligado. Numa sessão, /mcp mostra o mesmo.
bash
claude mcp add --transport http atendia https://mcp.atendia.pt/mcp --header "x-api-key: A_TUA_CHAVE_API"Para confirmar, pede ao assistente
Lista os meus agentes da Atendia.
3. Confirmar a ligação
No teu assistente, pede: «Lista os meus agentes da Atendia». O assistente usa a ferramenta list_agents do servidor «atendia» e mostra os agentes da tua organização.
O assistente pode pedir autorização antes de usar a Atendia: aprova. Se os teus agentes não aparecerem, vê: Resolução de problemas
Para programadores: o pedido por baixo
Por baixo, o assistente envia um pedido como este. As ferramentas que leem um registo pedem o id (por exemplo, get_call_log pede o callId). Os filtros, como status e limit, são opcionais. A resposta é o JSON da API da Atendia.
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "list_call_logs",
"arguments": { "status": "COMPLETED", "limit": 5 }
}
}