O MCP (Model Context Protocol) da LigueLead conecta o Claude direto à nossa API — depois de instalado, você pode pedir pro Claude enviar SMS, SMS Flash, campanhas de voz e RCS sem sair da conversa, sem escrever código.

Este artigo cobre os dois jeitos mais comuns de instalar: Claude Desktop e Claude Code.

O código do MCP é aberto — dá pra ver (e contribuir) em github.com/liguelead/mcp.

Antes de começar

• Uma conta ativa na LigueLead

• Node.js instalado na sua máquina (o comando npx, usado na instalação, vem junto com ele)

• 5 minutos — a maior parte do tempo é só copiar e colar

Passo 1 — Pegue suas credenciais

O MCP precisa de duas informações suas pra funcionar: o API Token e o App ID.

1. Acesse areadocliente.liguelead.app.br e faça login

2. No menu lateral, clique em Integrações

3. Clique em API Token

4. Crie um App (se ainda não tiver um) e copie o API Token e o App ID

Guarde os dois — você vai colar eles na configuração do Claude daqui a pouco.

Passo 2 — Instale no Claude Desktop

Abra o arquivo de configuração do Claude Desktop:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Se o arquivo não existir ainda, crie ele. Cole (ou mescle, se já tiver outros MCPs configurados) o seguinte dentro de mcpServers:

{
  "mcpServers": {
    "liguelead": {
      "command": "npx",
      "args": ["-y", "@liguelead/mcp-server"],
      "env": {
        "LIGUELEAD_API_TOKEN": "seu-token-aqui",
        "LIGUELEAD_APP_ID": "seu-app-id-aqui",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Troque seu-token-aqui e seu-app-id-aqui pelas credenciais do Passo 1.

Salve o arquivo e feche e abra o Claude Desktop de novo pra ele carregar o novo MCP.

Alternativa — instale no Claude Code

Se você usa o Claude Code (terminal), não precisa editar arquivo nenhum — roda esse comando:

claude mcp add -s user liguelead \
  -e LIGUELEAD_API_TOKEN=seu-token-aqui \
  -e LIGUELEAD_APP_ID=seu-app-id-aqui \
  -e TRANSPORT=stdio \
  -- npx -y @liguelead/mcp-server

Passo 3 — Teste

Numa conversa nova com o Claude, peça algo simples pra confirmar que conectou, por exemplo:

• Liste meus uploads de áudio de voz na LigueLead

• Envie um SMS de teste pro número 11999999999 com o texto "oi, é um teste"

Se o Claude conseguir chamar a ferramenta e trazer uma resposta de verdade (não um erro de permissão), a instalação funcionou.

O que dá pra fazer com o MCP

• Enviar SMS e SMS Flash

• Disparar campanhas de voz (upload de áudio incluso)

• Criar e enviar campanhas de RCS — texto, mídia, rich card e carrossel

Problemas comuns

• Erro 401 / Unauthorized — confira se o API Token e o App ID foram colados certinho, sem espaço antes ou depois

• O Claude não reconhece o MCP — confirme que o Node.js está instalado (node -v no terminal) e que você reiniciou o Claude Desktop depois de salvar o arquivo

• Erro 429 — é limite de envio; espace os envios ou agrupe os números numa única chamada