IntegraX MCP Server

MCP Server oficial da IntegraX — conecte o Claude à sua conta IntegraX para enviar SMS, RCS, encurtar links, criar automações e muito mais, tudo por linguagem natural.

Instalação rápida

Pré-requisitos

• Node.js 18+
• npm ou yarn
• Conta ativa na IntegraX

1. Clone ou baixe o projeto

git clone https://github.com/integraX/integraX-mcp
cd integraX-mcp

2. Instale as dependências

npm install

3. Build

npm run build

4. Configure no Claude Desktop

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

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Adicione o servidor:

{
  "mcpServers": {
    "integraX": {
      "command": "node",
      "args": ["/caminho/absoluto/para/integraX-mcp/dist/index.js"]
    }
  }
}

5. Reinicie o Claude Desktop

Após reiniciar, você verá as ferramentas da IntegraX disponíveis.

Primeiro uso

Diga ao Claude:

"Faça login na IntegraX com o email [email protected] e senha suasenha"

Após autenticar, você pode usar linguagem natural para tudo:

O que você pode fazer

Mensageria

• "Envie um SMS para 5511999999999 com a mensagem X usando marketing direct"
• "Crie uma campanha de RCS com card para minha lista de clientes"
• "Envie um OTP para o número X para verificação"
• "Valide se os números desta lista estão no WhatsApp"

Links

• "Encurte este link usando meu domínio personalizado"
• "Quais foram os links com mais cliques esta semana?"

Automações

• "Crie uma automação na Hotmart que envia SMS 2 minutos após um novo pagamento"
• "Qual é o desempenho da minha automação Gestor IRPF nos últimos 30 dias?"
• "Mostre o funil de conversão da automação X"

Relatórios

• "Qual foi o resultado da minha última campanha de SMS?"
• "Quanto gastei em RCS este mês?"
• "Exporte o relatório da campanha 8174 em CSV"

Enriquecimento

• "Enriqueça esta lista de 500 números com operadora, WhatsApp e dados demográficos"
• "Qual é o perfil da minha base de leads?"

Financeiro

• "Qual é meu saldo atual?"
• "Gere um PIX de R$200 para adicionar créditos"

API Externa

• "Crie um token de API para integrar SMS no meu sistema"
• "Mostre o relatório de uso da minha API de transações"

Fórum

• "Publique no fórum as boas práticas desta campanha de reativação"

Tools disponíveis (35 no total)

| Categoria | Tools | |---|---| | Auth | login | | Conta | get_account_summary, get_financial_summary, get_coverage_list | | Financeiro | buy_credits | | SMS | get_sms_config, get_sms_providers, test_sms, send_sms, list_campaigns, get_campaign_report, export_campaign_report | | RCS | send_rcs_text, send_rcs_richcard | | OTP | send_otp, verify_otp | | Links | list_links, shorten_link, list_custom_domains | | Validação | validate_whatsapp | | Enriquecimento | enrich_create, enrich_list, enrich_detail | | Automação | list_platforms, get_platform_detail, list_integrations, create_integration, get_integration_detail, get_integration_leads, get_lead_details, get_integration_report, get_integration_metrics, export_integration_leads | | API Externa | list_api_tokens, create_api_token, get_api_token_detail, get_api_token_sms_report | | Fórum | list_forum_categories, list_forum_posts, post_forum_strategy |

Segurança

• Credenciais são armazenadas apenas em memória durante a sessão
• Tokens de API são exibidos apenas uma vez na criação
• A tool post_forum_strategy bloqueia automaticamente qualquer conteúdo que detecte dados sensíveis (telefones, valores, tokens)
• Compras via PIX nunca são processadas automaticamente — sempre requerem confirmação do pagamento

Suporte

Dúvidas? Acesse o fórum da IntegraX ou entre em contato pelo suporte oficial.