Nineteen Blocks Sales Automation

Um sistema de automação de vendas que integra Gmail, Google Sheets, Streak CRM, Notion e Google Drive em um fluxo de trabalho unificado.

GitHubExperimente este MCPPatrocinado

Documentação

Nineteen Blocks Sales Automation MCP

Um sistema abrangente de automação de vendas usando Model Context Protocol (MCP) que integra Gmail, Google Sheets, Streak CRM, Notion e Google Drive em um fluxo de trabalho unificado acessível pelo Claude Desktop.

Recursos

✅ Totalmente Implementado (28 Ferramentas em Funcionamento)

  • Integração com Gmail

    • Verificar respostas de prospects
    • Encontrar e-mails que precisam de acompanhamento
    • Pesquisar e-mails com critérios personalizados
    • Identificar solicitações de reunião
    • Baixar e organizar anexos

  • Integração com Google Sheets

    • Atualizações rápidas de negócios usando linguagem natural
    • Ler dados do pipeline com estatísticas resumidas
    • Adicionar novos negócios ao pipeline
    • Fórmulas inteligentes para cálculos de vendas

  • Integração com Google Drive

    • Organizar automaticamente anexos de e-mail por empresa
    • Criar pastas estruturadas de negócios
    • Pesquisar documentos no Drive
    • Compartilhar arquivos em massa com a equipe
    • Rastrear arquivos modificados recentemente

  • Integração com Streak CRM

    • Sincronizar threads do Gmail com negócios
    • Atualizar etapas e valores de negócios
    • Criar novos negócios com contexto de e-mail
    • Análises avançadas de pipeline
    • Encontrar negócios parados que precisam de atenção

  • Integração com Notion

    • Criar notas de reunião com modelos
    • Atualizar status de negócios entre bancos de dados
    • Construir perfis de contato com histórico de e-mail
    • Gerar relatórios semanais automatizados
    • Pesquisar em todo o conteúdo do Notion

  • Recursos Multiplataforma

    • Criar negócios simultaneamente em TODAS as plataformas
    • Sincronização bidirecional entre plataformas
    • Relatórios e análises unificados
    • Organização inteligente de arquivos

🚧 Em Breve

  • Integração com Dropbox
  • Processamento de transcrições do Otter.ai
  • Agendamento automatizado
  • Insights com IA

🎯 O Que Ele Pode Fazer?

Este servidor MCP transforma o Claude em seu assistente de vendas com IA que pode:

  1. Gerenciar Negócios Entre Plataformas - Crie um negócio uma vez e ele aparece no Sheets, Streak, Notion e Drive
  2. Rastrear Comunicações por E-mail - Monitore respostas, encontre acompanhamentos necessários e sincronize threads com seu CRM
  3. Organizar Arquivos Automaticamente - Baixe anexos e organize-os por empresa no Google Drive
  4. Manter Tudo Sincronizado - A sincronização bidirecional garante que todas as plataformas tenham os dados mais recentes
  5. Gerar Relatórios Unificados - Veja todo o seu pipeline em todas as plataformas em uma única visão

🚀 Início Rápido

Pré-requisitos

  • Node.js 18+
  • Claude Desktop
  • Contas para os serviços que você deseja integrar

Instalação

# Clone the repository
git clone https://github.com/YOUR_USERNAME/nineteen-blocks-sales-automation-mcp.git
cd nineteen-blocks-sales-automation-mcp

# Install dependencies
npm install

# Copy and configure environment variables
cp config/.env.example config/.env
# Edit config/.env with your credentials

# Verify setup
npm run test:integrations

Adicionar ao Claude Desktop

Adicione isto à sua configuração do Claude Desktop:

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

{
  "mcpServers": {
    "sales-automation": {
      "command": "node",
      "args": ["/absolute/path/to/nineteen-blocks-sales-automation-mcp/src/server.js"]
    }
  }
}

Reinicie o Claude Desktop e comece a usar comandos em linguagem natural!

📚 Exemplos de Comandos

"Create a deal workspace for Acme Corp worth $50,000"
"Check if john@example.com responded to my email"
"Download all attachments from sarah@client.com"
"Sync all platforms"
"Show me deals that haven't been updated in 2 weeks"
"Generate a unified sales report"

📖 Guia de Configuração Completo

Consulte SETUP.md para instruções detalhadas sobre:

  • Obter credenciais para cada serviço
  • Configurar contas do Google Workspace
  • Configurar bancos de dados e pipelines
  • Solucionar problemas comuns

Ferramentas Disponíveis

Ferramentas de E-mail

  • check_prospect_response - Verificar se um prospect respondeu
  • find_follow_up_needed - Encontrar prospects que precisam de acompanhamento
  • find_meeting_requests - Identificar solicitações de reunião
  • search_emails - Pesquisar com critérios personalizados

Ferramentas de Planilha

  • quick_deal_update - Atualizar negócios usando linguagem natural
  • read_pipeline_data - Obter resumo do pipeline
  • add_new_deal - Adicionar novos negócios
  • add_smart_formulas - Adicionar cálculos de vendas

Desenvolvimento

Estrutura do Projeto

src/
├── server.js           # Main MCP server
├── integrations/       # Platform integrations
│   ├── gmail.js
│   ├── sheets.js
│   └── ...
├── tools/             # MCP tool definitions
│   ├── email-tools.js
│   ├── sheets-tools.js
│   └── ...
└── utils/             # Utilities
    └── scheduler.js   # Cron jobs

Adicionando Novas Ferramentas

  1. Crie a definição da ferramenta no arquivo tools/ apropriado
  2. Implemente a lógica de integração em integrations/
  3. Exporte do módulo da ferramenta
  4. Teste com o Claude Desktop

Solução de Problemas

Problemas de Conexão com Gmail

  • Certifique-se de que a verificação em duas etapas esteja ativada
  • A senha de aplicativo deve ter 16 caracteres (sem espaços)
  • Verifique se o IMAP está ativado nas configurações do Gmail

Acesso Negado ao Google Sheets

  • Verifique se a conta de serviço foi compartilhada com a planilha
  • Verifique se a API está ativada no Google Cloud Console
  • Certifique-se de que o caminho do arquivo de chave JSON está correto

Ferramenta Não Encontrada

  • Reinicie o Claude Desktop após alterações na configuração
  • Verifique os logs do servidor para erros
  • Verifique se a ferramenta está exportada do módulo

🌐 Implantação no GitHub

Para compartilhar este projeto:

  1. Crie um repositório no GitHub

  2. Inicialize o git e envie:

    git init
git add .
git commit -m "Initial commit - Sales Automation MCP"
git branch -M main
git remote add origin https://github.com/YOUR_USERNAME/nineteen-blocks-sales-automation-mcp.git
git push -u origin main

  3. Importante: Certifique-se de adicionar .env ao .gitignore para manter as credenciais seguras:

    echo "config/.env" >> .gitignore
echo "config/service-account-key.json" >> .gitignore
git add .gitignore
git commit -m "Add gitignore for sensitive files"
git push

🔒 Notas de Segurança

  • Nunca envie seu arquivo .env ou chaves de conta de serviço
  • Use variáveis de ambiente para todos os dados sensíveis
  • Compartilhe contas de serviço com as permissões mínimas necessárias
  • Rotacione regularmente chaves de API e senhas

🤝 Contribuindo

Contribuições são bem-vindas! Por favor:

  1. Faça um fork do repositório
  2. Crie um branch de recurso
  3. Faça suas alterações
  4. Envie um pull request

📝 Licença

Licença MIT - sinta-se à vontade para usar isso em seus próprios projetos!

🆘 Suporte

Para problemas ou perguntas:

  1. Consulte SETUP.md para instruções detalhadas de configuração
  2. Revise os logs do servidor para erros
  3. Crie uma issue no GitHub

Feito com ❤️ para a equipe de vendas da Nineteen Blocks