@lionchat/mcp-server

MCP server que conecta agentes de IA a plataforma LionChat. Expoe mais de 540 ferramentas para gerenciar contatos, conversas, kanban, funis, mensagens, automacoes e muito mais.

O que e MCP?

MCP (Model Context Protocol) e um protocolo aberto que permite agentes de IA interagirem com servicos externos. Com este servidor, qualquer agente compativel (Claude Code, n8n, agentes customizados) pode executar acoes no LionChat por linguagem natural.

Sem MCP: Voce le a documentacao, copia endpoints, configura manualmente. Com MCP: Voce diz "crie um funil com 4 etapas" e o agente faz tudo.

Inicio Rapido

1. Obtenha seu token

1. Faca login no LionChat
2. Va em Configuracoes > Perfil
3. Copie o Access Token

2. Descubra seu Account ID

O account_id aparece na URL quando voce esta logado:

app.lionchat.com.br/app/accounts/ACCOUNT_ID/dashboard

3. Conecte ao Claude Code

claude mcp add lionchat \
  -e LIONCHAT_API_TOKEN=seu_token \
  -e LIONCHAT_ACCOUNT_ID=123 \
  -- npx @lionchat/mcp-server

Pronto. Agora voce pode pedir ao Claude Code para fazer qualquer coisa no LionChat.

Instalacao alternativa (variaveis de ambiente)

export LIONCHAT_API_TOKEN=seu_token
export LIONCHAT_ACCOUNT_ID=123
npx @lionchat/mcp-server

Instancia self-hosted / white-label

export LIONCHAT_BASE_URL=https://sua-instancia.com
npx @lionchat/mcp-server

Configuracao

Prioridade: argumentos CLI > variaveis de ambiente > valores padrao.

Filtro por Categoria

Para melhor performance do agente, carregue apenas as ferramentas que precisa:

npx @lionchat/mcp-server --categories=contacts,conversations,kanban_items

Perfis Sugeridos

Categorias Disponiveis

Exemplos de Uso

No Claude Code

Depois de conectar, basta pedir em linguagem natural:

"Liste meus ultimos 10 contatos"
→ lionchat_contacts_list

"Crie um funil chamado 'Vendas Q2' com etapas Prospeccao, Qualificacao, Proposta, Fechado"
→ lionchat_funnels_create

"Mova o card 42 para a etapa 'Proposta'"
→ lionchat_kanban_items_move_to_stage

"Envie 'Ola!' na conversa 15"
→ lionchat_conversations_messages_create

"Quais conversas estao abertas no time de suporte?"
→ lionchat_conversations_list (com filtro por time)

"Crie uma regra de automacao: quando criar conversa com label VIP, atribuir ao time Premium"
→ lionchat_automation_rules_create

"Qual o saldo do meu VoIP?"
→ lionchat_voip_calls_balance

No n8n

O n8n suporta MCP de duas formas:

Opcao 1: MCP Client + AI Agent (recomendado para decisoes inteligentes)

1. Adicione um node "AI Agent" ao seu workflow (Claude, GPT, ou outro LLM)
2. Adicione um node "MCP Client" como ferramenta do agente
3. Configure o MCP Client:
   • Transport: stdio
   • Command: npx
   • Arguments: @lionchat/mcp-server
   • Environment Variables:
     • LIONCHAT_API_TOKEN = seu token
     • LIONCHAT_ACCOUNT_ID = seu account ID
     • LIONCHAT_CATEGORIES = categorias desejadas (opcional)
4. Conecte o MCP Client ao AI Agent
5. O agente de IA decide automaticamente quais ferramentas usar

Exemplo de prompt no AI Agent:

"Analise os contatos criados ontem. Se algum tem empresa no nome, crie um card no funil 'Vendas B2B' na etapa 'Prospeccao'."

O agente vai chamar lionchat_contacts_list, analisar os resultados, e chamar lionchat_kanban_items_create para cada contato relevante.

Opcao 2: HTTP Request (para automacoes fixas)

Para automacoes tipo "se X entao Y" sem necessidade de IA, use o node HTTP Request do n8n chamando a API do LionChat diretamente:

• URL: https://app.lionchat.com.br/api/v1/accounts/{account_id}/contacts
• Header: api_access_token: seu_token
• Method: GET, POST, etc.

Quando usar cada opcao

Em scripts ou agentes customizados

O MCP server funciona com qualquer cliente MCP via transporte stdio. Execute como subprocesso e comunique via stdin/stdout (JSON-RPC).

Ferramentas Meta

Sempre disponiveis, independente do filtro de categorias:

Use lionchat_ping para verificar se a conexao esta funcionando antes de executar outras acoes.

API Publica

Os 12 endpoints da API publica (widget, contatos publicos, CSAT) sao ocultos por padrao por seguranca. Para habilitar:

npx @lionchat/mcp-server --include-public-api

Esses endpoints usam inbox_identifier e contact_identifier em vez de token. Habilite apenas se seu agente precisa criar contatos ou conversas em nome de usuarios finais.

Upload de Arquivos

Endpoints que requerem upload de arquivo (importacao CSV, avatar, anexos) estao incluidos mas retornam uma mensagem orientando a usar a interface web ou chamadas API diretas. Upload via MCP sera suportado em versoes futuras.

Seguranca

• Token armazenado em variavel de ambiente, nunca logado ou incluido em respostas
• Transporte stdio -- comunicacao local entre processos, sem porta de rede aberta
• Stateless -- nada salvo em disco
• Timeout de 30 segundos por requisicao
• Retry automatico com backoff exponencial para rate limiting (429)
• Cada requisicao usa o token do cliente -- permissoes do LionChat sao respeitadas no servidor

Recomendacao: Use um token com permissoes minimas para seu caso de uso. Evite tokens de administrador em agentes automatizados.

Requisitos

• Node.js 18 ou superior
• Conta no LionChat com access token

Desenvolvimento

# Clonar o repositorio
git clone https://github.com/LionChatCRM/lionchat-mcp-server-.git
cd lionchat-mcp-server-

# Instalar dependencias
npm install

# Build
npm run build

# Testar localmente
LIONCHAT_API_TOKEN=seu_token LIONCHAT_ACCOUNT_ID=123 node dist/index.js

Atualizar endpoints

Quando a API do LionChat mudar:

1. Atualize o HTML de documentacao da API
2. Execute npm run extract -- caminho/para/api-docs.html
3. Verifique o endpoints.json gerado
4. Incremente a versao no package.json
5. npm publish

Licenca

MIT