Content
# 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
```bash
git clone https://github.com/integraX/integraX-mcp
cd integraX-mcp
```
### 2. Instale as dependências
```bash
npm install
```
### 3. Build
```bash
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:
```json
{
"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 **seu@email.com** 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.
