🤖 MCP: conecte o Claude ao seu workspace¶

Com o MCP você conecta uma inteligência artificial, como o Claude, direto no seu workspace do Atende Ágil. A partir daí é só conversar com ela em português: ela consulta suas conversas, contatos, funis, agenda e tarefas, e também executa ações, como cadastrar uma lista de contatos, etiquetar, mover no funil, agendar e até enviar mensagens. 🚀

🧩 O que é MCP?

MCP (Model Context Protocol) é o padrão aberto que as IAs usam pra se conectar a sistemas externos. O Atende Ágil fala esse padrão, então qualquer cliente de IA compatível com MCP consegue usar o seu workspace, sem programação.

💡 O que dá pra pedir¶

Alguns exemplos reais do que você pode escrever pra IA:

"Quem está esperando resposta há mais de 1 hora? Agrupa por atendente."
"Me mostra um resumo do dia: contatos novos, mensagens e atendimentos resolvidos."
"Cadastra essa lista como contatos, com a etiqueta Evento Outubro:" (e cole nomes e telefones)
"Coloca esses 5 contatos no funil Leads, etapa Proposta Enviada."
"Cria uma tarefa pra amanhã às 10h: ligar pro João sobre o orçamento."
"Agenda uma mensagem pra Maria na sexta às 9h lembrando da consulta."
"Manda pra 5584999999999: Olá! Seu pedido já saiu pra entrega."
"Quais contatos da etiqueta VIP não recebem mensagem há 30 dias?"
"Como está o desempenho da equipe neste mês?"
"Cria o funil Prospecção com as etapas Novo, Contato feito, Proposta e Fechado."
"Cria uma resposta rápida /horario com o nosso horário de funcionamento."
"Lê os áudios e o PDF que a Joana mandou hoje e me resume o que ela precisa."
"O que tem na foto que o cliente mandou por último?"

🧰 Tudo o que a IA consegue fazer¶

Área	Consultar	Agir
Visão geral	Totais do workspace, funis e etapas, etiquetas, equipe (com quem está online), departamentos, motivos de fechamento e campos personalizados
Contatos	Buscar e filtrar (por nome, telefone, etiqueta, funil, etapa, status, atendente, data) e ver a ficha completa	Cadastrar em lote (até 500 por vez), editar dados e campos personalizados, adicionar ou remover etiquetas
Conversas	Listar conversas, quem falta responder (com tempo de espera e atendente), ler o histórico de mensagens e entender as mídias: ver imagens, ouvir áudios (transcrição), ler documentos (PDF, Word, Excel, TXT) e ver um quadro dos vídeos	Enviar mensagem (texto ou mídia por link), atribuir a um atendente ou departamento, abrir e concluir o atendimento
CRM	Contatos de cada funil e etapa	Colocar ou mover contatos em um funil e etapa (com ou sem as automações da etapa), adicionar notas, alterar o valor do negócio e montar o funil: criar funis e etapas, renomear, mudar cor, reordenar e excluir (exclusão pede confirmação)
Tarefas	Listar tarefas	Criar e concluir tarefas
Respostas rápidas	Listar as respostas rápidas e o conteúdo de cada uma	Criar, editar e excluir (a exclusão pede confirmação)
Próximos envios	Tudo o que está programado pra sair: mensagens agendadas, automações e follow-ups do CRM, lembretes da Agenda e disparos em massa agendados (com a origem de cada um)	Agendar e cancelar mensagens
Agenda	Ver compromissos por período	Criar compromissos, com lembretes por WhatsApp
Resultados	Desempenho da equipe (os mesmos números do Ranking) e estatísticas por dia

🔑 Passo 1: gerar a chave MCP¶

Vá em Configurações → Integrações.
No card MCP: IA conectada ao workspace, clique em Gerar chave MCP e dê um nome (ex.: "Claude do João").
Copie a chave que aparece. Ela é mostrada uma única vez.

Na mesma tela aparecem a URL do servidor MCP e os comandos prontos pra copiar.

🔐 Só o dono ou admin

Apenas o dono ou um admin do workspace consegue gerar e revogar chaves.

🔌 Passo 2: conectar na sua IA¶

Claude Code (terminal)¶

Cole o comando que a própria tela mostra, que fica assim:

claude mcp add --transport http atendeagil-242 https://app.atendeagil.com/mcp/v1 --header "Authorization: Bearer SUA_CHAVE"

Depois é só abrir o Claude Code e conversar normalmente.

Claude pelo navegador (claude.ai)¶

Conectando no site, o Atende Ágil fica disponível também no Claude Desktop e no app do Claude no celular, na mesma conta.

No claude.ai, abra Configurações → Conectores e clique em Adicionar conector personalizado.
Preencha:
- Nome: atendeagil
- URL: https://app.atendeagil.com/mcp/v1
Em Autenticação, marque Sem login.
Na parte Cliente OAuth, não mexa em nada.
Em Cabeçalhos de requisição, adicione um cabeçalho:
- Nome: Authorization
- Valor: Bearer SUA_CHAVE (com a palavra Bearer, um espaço e depois a chave)
Salve. Abra uma conversa nova e teste com algo como: "quantas conversas abertas tenho no atendeagil?".

💡 Não apareceu a opção de cabeçalho?

Coloque a chave direto na URL e deixe os cabeçalhos vazios:

https://app.atendeagil.com/mcp/v1?key=SUA_CHAVE

Nesse caso, trate o endereço inteiro como uma senha.

ChatGPT¶

No ChatGPT, conectores personalizados ficam no modo desenvolvedor, que pode depender do seu plano.

No ChatGPT, abra Configurações → Aplicativos e Conectores → Configurações avançadas e ative o Modo desenvolvedor.
Volte em Aplicativos e Conectores e clique em Criar.
Preencha:
- Nome: Atende Ágil
- URL do servidor MCP: https://app.atendeagil.com/mcp/v1?key=SUA_CHAVE
- Autenticação: Sem autenticação
Confirme que confia no aplicativo e clique em Criar.
Numa conversa nova, clique no +, escolha o modo desenvolvedor e ative o conector Atende Ágil.

🔐 A chave fica dentro da URL

O ChatGPT não aceita cabeçalho de autorização, por isso a chave vai no final do endereço (?key=). Não compartilhe esse endereço com ninguém. Se vazar, revogue a chave em Configurações → Integrações.

📝 Os menus podem mudar

Claude e ChatGPT atualizam as telas com frequência. Se algum nome estiver diferente, procure por Conectores ou Aplicativos nas configurações.

🗂️ Tem mais de um workspace?

Gere uma chave em cada workspace e adicione um conector pra cada um. O nome do conector já vem com o número do workspace (ex.: atendeagil-242, atendeagil-305), então eles não se confundem. Na conversa, diga em qual workspace quer trabalhar.

Outros clientes compatíveis com MCP (Cursor, etc.)¶

Use a configuração em JSON que a tela mostra (servidor do tipo HTTP, com a URL e o cabeçalho de autorização):

{
  "mcpServers": {
    "atendeagil-242": {
      "type": "http",
      "url": "https://app.atendeagil.com/mcp/v1",
      "headers": { "Authorization": "Bearer SUA_CHAVE" }
    }
  }
}

🖥️ Cliente que só aceita servidores locais?

Alguns aplicativos (como o Claude Desktop) só aceitam servidores MCP locais no arquivo de configuração. Nesse caso use a ponte mcp-remote, que conecta o aplicativo ao servidor remoto:

{
  "mcpServers": {
    "atendeagil-242": {
      "command": "npx",
      "args": ["mcp-remote", "https://app.atendeagil.com/mcp/v1", "--header", "Authorization: Bearer SUA_CHAVE"]
    }
  }
}

🎧 Áudios, imagens e documentos¶

A IA também entende as mídias da conversa, pra ter o contexto completo:

Imagens e figurinhas: a IA vê a imagem.
Áudios: são transcritos em texto. A transcrição usa os créditos de IA do workspace, igual ao botão Transcrever do bate-papo. Cada áudio é cobrado uma vez só: se a IA ler o mesmo áudio de novo, usa o texto já transcrito.
Documentos: a IA lê o texto de PDF, Word, Excel, PowerPoint, TXT e CSV. PDF escaneado (só imagem) não tem texto pra ler.
Vídeos: a IA vê um quadro do vídeo.

⏳ Mídias antigas

As mídias ficam guardadas por um tempo limitado. Se uma mídia antiga não estiver mais disponível, a IA avisa em vez de inventar o conteúdo.

🗂️ Como a IA encontra os contatos¶

Você pode se referir a um contato pelo telefone (em qualquer formato, com ou sem DDD, espaços ou traços), pelo nome exato ou pelo identificador. Se houver dois contatos com o mesmo nome, a IA avisa e pede o telefone. O mesmo vale pra atendentes com nomes iguais: aí ela pede o e-mail.

Datas e horários são sempre no horário de Brasília.

🔒 Segurança¶

Acesso total ao workspace: a chave permite ler e agir em tudo, inclusive enviar mensagens reais pros seus clientes. Guarde como uma senha e não compartilhe.
Só o seu workspace: cada chave enxerga apenas o workspace em que foi criada, nunca outro.
Revogar a qualquer momento: em Configurações → Integrações, clique em Revogar ao lado da chave. Quem estiver usando perde o acesso na hora. A lista mostra quando cada chave foi criada e usada pela última vez.
Mesmas regras da tela: as ações passam pelos mesmos caminhos do sistema. Mover um contato de etapa dispara as automações da etapa, fechar um atendimento conta no Ranking, e assim por diante. As ações feitas pela IA ficam registradas em nome do dono do workspace.
Limite de uso: existe um limite de chamadas por minuto por chave, pra proteger o sistema.

✅ Confirmação antes de qualquer envio¶

Nenhuma mensagem sai sem você confirmar. Sempre que a IA for enviar, agendar ou disparar uma ação que manda mensagem (etapa do funil com mensagens automáticas, motivo de fechamento com mensagem de encerramento ou pesquisa, compromisso com lembrete por WhatsApp), o sistema primeiro devolve uma prévia assim:

Nome: Maria Souza
Telefone: 5584999999999
Mensagem: Olá, Maria! Seu pedido já saiu pra entrega.

Confirma?

Só depois que você responder que confirma a mensagem é enviada. Essa trava fica no próprio Atende Ágil, não depende só da IA:

Vale mesmo no modo agente/automático: sem a confirmação daquela prévia, o sistema não envia.
A confirmação vale só pra aquela prévia exata. Se o texto, o contato ou o horário mudarem, uma nova prévia é mostrada.
A confirmação expira em 10 minutos.

💡 Dica

Leia a prévia com atenção antes de confirmar, principalmente quando envolver vários contatos de uma vez.

❓ Dúvidas comuns¶

Funciona com o ChatGPT ou com o Claude pelo navegador?

Sim! Veja acima o passo a passo do Claude pelo navegador e do ChatGPT. No claude.ai a chave vai num cabeçalho; no ChatGPT ela vai no final da URL.

Uma ferramenta nova não aparece pra IA. E agora?

A IA carrega a lista de ferramentas quando a conversa começa. Abra uma conversa nova. Se ainda não aparecer, reconecte o conector (no Claude Code: digite /mcp, escolha o conector e clique em Reconnect). Não precisa gerar outra chave.

Perdi a chave, e agora?

A chave não pode ser vista de novo. Gere uma nova e revogue a antiga.

Posso ter mais de uma chave?

Sim, até 10 chaves ativas por workspace. Dá pra criar uma por pessoa ou por aplicativo e revogar cada uma separadamente.

Qual a diferença pra API Pública?

A API Pública é pra sistemas (programação, integrações automáticas). O MCP é pra conversar com uma IA que usa o seu workspace. As chaves são diferentes e independentes.

Esse tópico ajudou? 🤔

📖 Continuar lendo 🪄 Copiloto de IA →