Português · English

MCP: conecte sua IA ao Atendlly

O servidor MCP do Atendlly fica em https://atende.suporteja.com.br/mcp (Streamable HTTP, sem sessão). Ele atende clientes das versões 2026-07-28 e 2025-11-25 do protocolo. Autenticação: cabeçalho Authorization: Bearer <sua chave>.

Antes de tudo, crie uma chave em Configurações → Integrações → Chaves de API e MCP com o modelo "Assistente de IA". Prefira uma chave pessoal por pessoa: ela age como você e nunca pode mais do que você.

Claude (claude.ai e Claude Desktop)

1. Em Configurações → Conectores, clique em Adicionar conector personalizado.
2. Nome: Atendlly. URL: https://atende.suporteja.com.br/mcp.
3. Autenticação: Sem login (No sign in). Em Cabeçalhos da requisição, adicione Authorization com o valor Bearer atl_live_….
4. Teste: "Quais conversas estão esperando há mais de 30 minutos?"

Em planos Team/Enterprise do Claude, só os proprietários adicionam conectores e uma chave compartilhada dá a todos o acesso daquela chave: prefira uma chave pessoal por pessoa. Se a opção de cabeçalhos não aparecer na sua conta do Claude, use o Claude Code ou aguarde a conexão por OAuth.

Claude Code

export ATENDLLY_API_KEY=atl_live_…
claude mcp add --transport http atendlly https://atende.suporteja.com.br/mcp --header "Authorization: Bearer $ATENDLLY_API_KEY"

Ou, no .mcp.json do projeto (a chave fica numa variável de ambiente, nunca no repositório):

{ "mcpServers": { "atendlly": { "type": "http", "url": "https://atende.suporteja.com.br/mcp",
  "headers": { "Authorization": "Bearer ${ATENDLLY_API_KEY}" } } } }

Cursor

Em ~/.cursor/mcp.json:

{ "mcpServers": { "atendlly": { "url": "https://atende.suporteja.com.br/mcp",
  "headers": { "Authorization": "Bearer ${env:ATENDLLY_API_KEY}" } } } }

Se a sua versão do Cursor não expandir variáveis de ambiente nos cabeçalhos, coloque a chave diretamente (e não compartilhe esse arquivo).

VS Code

Em .vscode/mcp.json (o VS Code pede a chave uma vez e a guarda com segurança):

{
  "inputs": [{ "type": "promptString", "id": "atendlly-key", "description": "Chave do Atendlly", "password": true }],
  "servers": { "atendlly": { "type": "http", "url": "https://atende.suporteja.com.br/mcp",
    "headers": { "Authorization": "Bearer ${input:atendlly-key}" } } }
}

ChatGPT (em breve)

O ChatGPT só aceita conexões com OAuth, que chega em breve ao Atendlly. Por enquanto use Claude, Claude Code, Cursor ou VS Code.

Qualquer cliente MCP

• URL: https://atende.suporteja.com.br/mcp, só POST (GET e DELETE respondem 405).
• Cabeçalho: Authorization: Bearer atl_live_….
• Versões: 2026-07-28 (sem initialize; cada requisição leva _meta e os cabeçalhos MCP-Protocol-Version, Mcp-Method e Mcp-Name) e 2025-11-25 (com initialize, sem Mcp-Session-Id).

curl -s https://atende.suporteja.com.br/mcp -H "Authorization: Bearer $ATENDLLY_API_KEY" \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2026-07-28" -H "Mcp-Method: tools/list" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

Com o MCP Inspector oficial:

npx @modelcontextprotocol/inspector --cli https://atende.suporteja.com.br/mcp --transport http \
  --header "Authorization: Bearer $ATENDLLY_API_KEY" --method tools/list

Ferramentas

tools/list mostra só as ferramentas que a chave pode usar. Leitura: get_account_overview, search_contacts, get_contact, list_conversations, get_conversation, get_queue_overview, get_report_summary, search_knowledge, list_pipelines, list_deals, get_deal, list_tasks, get_action_status. Ações: create_contact, update_contact, add_contact_note, update_conversation, add_private_note, send_message, create_deal, update_deal, close_deal, create_task, complete_task, suggest_faq.

send_message espera a aprovação de uma pessoa no Atendlly (a não ser que um administrador tenha liberado o envio automático para uma chave de serviço). Quando o resultado diz pending_approval, nada foi enviado ainda: consulte get_action_status.

Problemas comuns