Páginas do MCP

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

  1. Abre um terminal na pasta do teu projeto.
  2. 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.
  3. 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.

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