# 🚀 Início Rápido - Uazapi MCP Server
## Em 3 Passos Simples
### 1️⃣ Instalar Dependências
```bash
cd uazapi_mcp
pip install -r requirements.txt
```
### 2️⃣ Configurar Credenciais
```bash
export UAZAPI_API_KEY="sua_chave_api"
export UAZAPI_INSTANCE_ID="seu_instance_id"
```
**Onde obter?** Acesse https://uazapi.com/ → Dashboard → API
### 3️⃣ Testar
```bash
# Verificar se está funcionando
python3 -m py_compile uazapi_mcp.py
echo "✅ Servidor pronto para uso!"
```
## Usar no Claude Desktop
### Opção A: Instalação Automática (uv)
```bash
uv run mcp install uazapi_mcp.py --name "Uazapi WhatsApp"
```
### Opção B: Configuração Manual
Edite `~/.config/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"uazapi": {
"command": "python3",
"args": ["/caminho/completo/para/uazapi_mcp/uazapi_mcp.py"],
"env": {
"UAZAPI_API_KEY": "sua_chave_aqui",
"UAZAPI_INSTANCE_ID": "seu_instance_id_aqui"
}
}
}
}
```
**⚠️ Importante:** Use o caminho COMPLETO para o arquivo `.py`
Depois, reinicie o Claude Desktop.
## Primeiro Teste
No Claude Desktop, experimente:
```
Liste meus contatos do WhatsApp
```
Se funcionar, você verá a lista de contatos formatada!
## Próximos Passos
✅ **Funcionou?** Veja [EXAMPLES.md](./EXAMPLES.md) para mais casos de uso
❌ **Erro?** Verifique:
- Credenciais estão corretas?
- Caminho do arquivo está correto?
- Claude Desktop foi reiniciado?
📖 **Quer adicionar mais recursos?** Veja [CONTRIBUTING.md](./CONTRIBUTING.md)
---
## Comandos Úteis
```bash
# Ver ajuda do servidor
python3 uazapi_mcp.py --help
# Verificar sintaxe
python3 -m py_compile uazapi_mcp.py
# Testar com MCP Inspector
uv run mcp dev uazapi_mcp.py
```
## Ferramentas Disponíveis
- ✉️ `uazapi_send_text_message` - Enviar mensagens de texto
- 📎 `uazapi_send_media_message` - Enviar imagens, vídeos, docs
- 👥 `uazapi_get_contacts` - Listar contatos
- 💬 `uazapi_get_chats` - Listar conversas
## Estrutura do Projeto
```
uazapi_mcp/
├── uazapi_mcp.py # Servidor MCP principal
├── requirements.txt # Dependências Python
├── README.md # Documentação completa
├── EXAMPLES.md # Exemplos de uso
├── CONTRIBUTING.md # Guia para contribuir
├── QUICKSTART.md # Este arquivo
└── .env.example # Exemplo de variáveis de ambiente
```
## Suporte
- 📚 Documentação completa: [README.md](./README.md)
- 💡 Exemplos práticos: [EXAMPLES.md](./EXAMPLES.md)
- 🛠️ Adicionar recursos: [CONTRIBUTING.md](./CONTRIBUTING.md)
- 🌐 API Uazapi: https://docs.uazapi.com/
---
**Desenvolvido com ❤️ usando [Model Context Protocol](https://modelcontextprotocol.io/)**