Chatwoot MCP
MCP local · open source

Transforme conversas em trabalho resolvido.

Seu agente consulta o histórico, organiza a fila, acompanha tempos de resposta e compara a operação no Chatwoot com ferramentas claras para cada etapa.

Conectar meu Chatwoot Explorar o código
Demonstração interativa · dados fictícios
CENTRAL DE OPERAÇÕES

Atendimentos

Chatwoot conectado
Abertos12
Sem responsável3
Aguardando5
Resolvidos hoje18
7 na visualização
Triagem3
Em atendimento2
Aguardando cliente2
Fluxo completo

Do primeiro sinal à resolução.

O agente combina ferramentas pequenas e explícitas para avançar cada atendimento com o contexto certo.

  1. 01⌕

    Encontre

    Busque contatos e conversas entre todas as caixas visíveis.

    search_contacts
  2. 02≡

    Entenda

    Leia o histórico, os anexos e o estado atual do atendimento.

    get_conversation
  3. 03↗

    Organize

    Atribua responsáveis, prioridade, etiquetas e status.

    assign_conversation
  4. 04✓

    Resolva

    Responda, registre uma nota ou encerre a conversa.

    send_reply
Caixa de ferramentas

Uma API operacional para seu agente.

Ferramentas organizadas pelo trabalho que você precisa concluir no Chatwoot.

01

Conversas

Consulte o contexto e mantenha o atendimento em movimento.

  • list_conversations
  • get_conversation
  • add_private_note
  • set_priority
  • set_conversation_status
02

Roteamento

Organize a fila e entregue cada caso à pessoa certa.

  • list_inboxes
  • list_agents
  • assign_conversation
  • get_conversation_labels
  • add_conversation_labels
03

Mensagens

Use o formato aceito por cada canal para responder.

  • send_reply
  • send_attachment
  • list_message_templates
  • send_template
Recursos variam conforme o canal.
04

Contatos

Encontre, atualize e inicie novos atendimentos.

  • search_contacts
  • get_contact
  • update_contact
  • create_conversation
05

Analytics

Encontre as esperas mais longas, entenda tempos de resposta e resolução e compare o desempenho da operação.

  • list_attention_queue
  • get_analytics_summary
  • get_conversation_metrics
  • compare_performance
Métricas e tempos disponíveis variam conforme a edição e versão do Chatwoot.
Controle operacional

Cada mudança deixa um rastro claro.

O MCP trabalha com IDs explícitos e confirma o resultado retornado pelo Chatwoot. Se uma entrega ficar ambígua, ela não é repetida por conta própria.

  • 01
    Alvo identificado

    Conta, caixa, contato e conversa aparecem antes da ação.

  • 02
    Estado confirmado pela API

    A resposta inclui os dados que o Chatwoot realmente aceitou.

  • 03
    Regras do canal preservadas

    Templates, anexos e janelas de envio seguem a capacidade da caixa.

execução #cw-1842concluída
10:42:08
CONSULTAget_conversation

account_id: 1 · conversation_id: 9321

10:42:09
DECISÃOContexto validado

pedido localizado · canal WhatsApp

10:42:11
AÇÃOassign_conversation

assignee_id: 17 · status: accepted

✓Confirmado pelo Chatwootresponsável: Marcos · conversation_id: 9321
Comece local

Seu Chatwoot, disponível no cliente MCP.

Baixe o aplicativo de bandeja para macOS, Windows ou Linux, configure a URL, a conta e o token no painel local e registre o servidor no Claude Desktop ou no Codex com um clique — ou cole a configuração no Cursor ou em outro cliente compatível.

Baixar para seu sistema →Como instalar
1

InstaleInstalador para macOS, Windows ou Linux.

2

ConecteAbra o app e registre no cliente MCP.

3

AtendaChame as ferramentas pela IA.