MCP Agendor - Projeto Comunitário 🚀

Um servidor MCP (Model Context Protocol) completo para integração com o Agendor CRM, fornecendo acesso programático a todas as funcionalidades principais do sistema.

🚀 Instalação e Uso

🚀 Características Principais

Operações CRUD Completas

• Negócios (Deals): Criar, listar, atualizar e buscar negócios
• Organizações: Gerenciar empresas e clientes
• Pessoas: Administrar contatos e leads
• Tarefas: Criar e gerenciar atividades

Funcionalidades Avançadas

• Integrações HTTP: Conectar com sistemas externos de forma configurável
• Webhooks: Notificações automáticas para eventos do Agendor
• Relatórios Customizados: Geração de relatórios com filtros e métricas avançadas
• Analytics de Vendas: Análises detalhadas de performance e pipeline
• Automações: Workflows baseados em eventos (em desenvolvimento)

Configuração e Metadata

• Funis e Estágios: Acesso a configurações do pipeline
• Busca Global: Pesquisa unificada em todos os tipos de dados
• Campos Customizados: Suporte completo a campos personalizados

💻 Instalação Local

Pré-requisitos

• Node.js 18+
• Token de API do Agendor (obtenha aqui)

Instalação via NPM

npm install -g mcp-agendor

Configuração do Token

# Variável de ambiente
export AGENDOR_TOKEN="seu-token-aqui"

# Ou via arquivo .env
echo "AGENDOR_TOKEN=seu-token-aqui" > .env

Uso como Servidor MCP

# Iniciar servidor
mcp-agendor --token seu-token-aqui

# Com URL customizada
mcp-agendor --token seu-token-aqui --base-url https://api.agendor.com.br/v3

🔧 Integração com Claude Code CLI

{
  "mcpServers": {
    "agendor": {
      "command": "npx",
      "args": ["mcp-agendor"],
      "env": {
        "AGENDOR_TOKEN": "seu-token-aqui"
      }
    }
  }
}

🛠️ Ferramentas Disponíveis (26 no total)

Operações Básicas

• agendor_list_deals - Lista negócios com filtros
• agendor_create_deal - Cria novo negócio
• agendor_update_deal - Atualiza negócio existente
• agendor_get_deal - Busca negócio específico
• agendor_list_organizations - Lista organizações
• agendor_create_organization - Cria nova organização
• agendor_list_people - Lista pessoas/contatos
• agendor_create_person - Cria nova pessoa
• agendor_list_tasks - Lista tarefas
• agendor_create_task - Cria nova tarefa

Configuração e Metadata

• agendor_get_funnels - Lista funis disponíveis
• agendor_get_deal_stages - Lista estágios dos funis
• agendor_search - Busca global no Agendor

Integrações Avançadas

• agendor_create_integration - Configura integração HTTP
• agendor_execute_integration - Executa integração
• agendor_test_integration - Testa conectividade
• agendor_sync_data - Sincroniza dados com sistema externo

Webhooks

• agendor_create_webhook - Configura webhook
• agendor_list_webhooks - Lista webhooks ativos
• agendor_test_webhook - Testa webhook

Relatórios e Analytics

• agendor_generate_report - Gera relatório customizado
• agendor_get_predefined_reports - Lista relatórios predefinidos
• agendor_run_predefined_report - Executa relatório predefinido
• agendor_sales_analytics - Analytics de vendas
• agendor_pipeline_analytics - Análise de pipeline
• agendor_performance_metrics - Métricas de performance

Automação

• agendor_create_automation - Cria automação (em desenvolvimento)
• agendor_list_automations - Lista automações
• agendor_bulk_update - Atualização em lote

📊 Exemplos de Uso

Exemplos de Comandos

Via Claude Code CLI

# Listar negócios recentes
"Liste os 10 negócios mais recentes do Agendor"

# Criar nova organização
"Crie uma nova empresa no Agendor: 'TechCorp Ltda', CNPJ: 12.345.678/0001-90, email: [email protected]"

# Gerar relatório de vendas
"Gere um relatório de vendas dos últimos 30 dias agrupado por vendedor"

# Configurar webhook
"Configure um webhook para notificar https://meuapp.com/webhook quando um negócio for criado"

🔗 Deploy Próprio (Opcional)

Se quiser fazer seu próprio deploy no Cloudflare Workers:

# Clone o repositório
git clone https://github.com/leonidasjf/MCP_Agendor.git
cd MCP_Agendor

# Instale dependências
npm install

# Configure Wrangler
npx wrangler login

# Deploy
npm run worker:deploy

📚 Documentação Adicional

• SECURITY.md - Modelo de segurança e boas práticas
• Funcionalidades Avançadas
• API do Agendor
• Exemplos Práticos
• Comandos Prontos
• Guia de Deploy Cloudflare

🤝 Contribuindo

Este é um projeto comunitário! Contribuições são muito bem-vindas:

1. Fork o projeto
2. Crie uma branch para sua feature (git checkout -b feature/AmazingFeature)
3. Commit suas mudanças (git commit -m 'Add some AmazingFeature')
4. Push para a branch (git push origin feature/AmazingFeature)
5. Abra um Pull Request

📝 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

🔗 Links Úteis

• Repositório GitHub: https://github.com/leonidasjf/MCP_Agendor
• Documentação da API do Agendor
• Model Context Protocol
• Cloudflare Workers

⚠️ Importante

• Este é um projeto não oficial e não é afiliado ao Agendor
• Use por sua própria conta e risco
• Mantenha seu token do Agendor sempre seguro
• O projeto é mantido pela comunidade

🌟 Status do Projeto

• ✅ Produção: API funcionando 24/7
• ✅ Estável: Todas as funcionalidades testadas
• ✅ Documentado: Guias completos disponíveis
• ✅ Open Source: Código aberto no GitHub
• 🔄 Ativo: Melhorias contínuas pela comunidade