mirror of
https://github.com/EvolutionAPI/evolution-api.git
synced 2025-12-26 23:27:45 -06:00
dc2f3fe93f
Implementa um servidor MCP (Model Context Protocol) completo que permite ao Claude analisar mensagens e dados do Evolution API diretamente do PostgreSQL. Funcionalidades incluídas: - list_instances: Lista instâncias WhatsApp - get_messages: Busca mensagens com filtros avançados - search_messages: Busca por conteúdo de texto - get_conversation: Obtém conversas completas - get_message_stats: Estatísticas detalhadas - get_contacts: Lista contatos - get_chats: Lista chats ativos - get_instance_details: Detalhes de instâncias - execute_query: Queries SQL personalizadas (apenas SELECT) Inclui documentação completa, guia rápido e exemplos de configuração para Claude Desktop.
154 lines
3.1 KiB
Markdown
154 lines
3.1 KiB
Markdown
# 🚀 Guia Rápido - Evolution API MCP Server
|
|
|
|
Este é um guia rápido para configurar o MCP Server em **5 minutos**.
|
|
|
|
## Passo 1: Instalar Dependências
|
|
|
|
```bash
|
|
cd mcp-server
|
|
npm install
|
|
```
|
|
|
|
## Passo 2: Configurar Banco de Dados
|
|
|
|
Crie o arquivo `.env`:
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
Edite `.env` e configure sua string de conexão PostgreSQL:
|
|
|
|
```env
|
|
DATABASE_CONNECTION_URI=postgresql://postgres:senha@localhost:5432/evolution
|
|
```
|
|
|
|
## Passo 3: Compilar
|
|
|
|
```bash
|
|
npm run build
|
|
```
|
|
|
|
## Passo 4: Configurar Claude Desktop
|
|
|
|
### macOS/Linux
|
|
|
|
1. Abra o arquivo de configuração:
|
|
```bash
|
|
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
|
|
```
|
|
|
|
2. Cole esta configuração (ajuste o caminho):
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"evolution-api": {
|
|
"command": "node",
|
|
"args": [
|
|
"/home/user/evolution-api/mcp-server/dist/index.js"
|
|
],
|
|
"env": {
|
|
"DATABASE_CONNECTION_URI": "postgresql://postgres:senha@localhost:5432/evolution"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
### Windows
|
|
|
|
1. Abra o arquivo de configuração:
|
|
```
|
|
notepad %APPDATA%\Claude\claude_desktop_config.json
|
|
```
|
|
|
|
2. Cole esta configuração (ajuste o caminho):
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"evolution-api": {
|
|
"command": "node",
|
|
"args": [
|
|
"C:\\Users\\SeuUsuario\\evolution-api\\mcp-server\\dist\\index.js"
|
|
],
|
|
"env": {
|
|
"DATABASE_CONNECTION_URI": "postgresql://postgres:senha@localhost:5432/evolution"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Passo 5: Reiniciar Claude Desktop
|
|
|
|
Feche completamente o Claude Desktop e abra novamente.
|
|
|
|
## ✅ Testar
|
|
|
|
Abra o Claude Desktop e digite:
|
|
|
|
```
|
|
Liste todas as instâncias do Evolution API
|
|
```
|
|
|
|
Se funcionar, você verá a lista de instâncias! 🎉
|
|
|
|
## 🔍 Exemplos de Comandos
|
|
|
|
Experimente estes comandos no Claude Desktop:
|
|
|
|
```
|
|
Mostre as últimas 10 mensagens da instância "minha-instancia"
|
|
```
|
|
|
|
```
|
|
Busque mensagens contendo "pedido" nas últimas 24 horas
|
|
```
|
|
|
|
```
|
|
Mostre estatísticas de mensagens da instância "vendas" agrupadas por dia
|
|
```
|
|
|
|
```
|
|
Liste os contatos da instância "suporte"
|
|
```
|
|
|
|
```
|
|
Mostre a conversa completa com o número 5511999999999@s.whatsapp.net
|
|
```
|
|
|
|
## 🐛 Problemas?
|
|
|
|
### Claude Desktop não mostra o MCP
|
|
|
|
1. Verifique se o caminho no `claude_desktop_config.json` está correto (use caminho ABSOLUTO)
|
|
2. Verifique se o arquivo foi compilado: `ls mcp-server/dist/index.js`
|
|
3. Reinicie o Claude Desktop completamente
|
|
4. Veja os logs: Menu > Help > Show Logs
|
|
|
|
### Erro de conexão com banco
|
|
|
|
1. Teste a conexão manualmente:
|
|
```bash
|
|
psql "postgresql://postgres:senha@localhost:5432/evolution"
|
|
```
|
|
2. Verifique se o PostgreSQL está rodando
|
|
3. Verifique usuário, senha e nome do banco
|
|
|
|
### Para testar localmente (sem Claude Desktop)
|
|
|
|
```bash
|
|
cd mcp-server
|
|
npm run dev
|
|
```
|
|
|
|
Isso iniciará o servidor MCP em modo stdio (você verá uma mensagem no console).
|
|
|
|
## 📚 Documentação Completa
|
|
|
|
Para mais detalhes, consulte o [README.md](README.md) completo.
|
|
|
|
---
|
|
|
|
**Pronto!** Agora você pode analisar suas mensagens do WhatsApp com o poder do Claude! 🚀
|