aspa-mcp

Destaques

Related MCP server: Teletype MCP Server

Início rápido

Precisa de: Linux com systemd (Ubuntu testado), Node.js 22.12 ou mais novo, Google Chrome, uma conta no Aspa e um assistente de IA (Claude Code, Codex ou outro cliente de MCP).

1. Baixar e instalar

   git clone <link-do-repositório> ~/dev/aspa-mcp
   cd ~/dev/aspa-mcp && npm install
   npm run install-service && npm run init-config

2. Conectar ao seu assistente

   # Claude Code (completo, com envio após aprovação)
   claude mcp add --scope user aspa -- node "$HOME/dev/aspa-mcp/index.mjs"
   
   # Codex ou outro cliente (modo seguro: lê, resume e abre rascunhos; você envia no Aspa)
   codex mcp add aspa --env ASPA_READ_ONLY=1 -- node "$HOME/dev/aspa-mcp/index.mjs"

3. Pedir a configuração no assistente:

   Me ajuda a configurar o Aspa.

   Ele faz o login no Aspa com você e configura empresa, tom, assinatura, documentos e avisos, um item por vez.

4. Aviso no Slack (opcional): npm run slack -- <seu ID do Slack> e cole o token quando pedir.

5. Usar: "Lista as minhas conversas do Aspa e me diz quais estão não lidas."

Passo a passo completo, com cada comando explicado: docs/instalacao.md.

Documentação

Como funciona

Fonte editável do diagrama: assets/arquitetura.mmd

O serviço em segundo plano mantém um Chrome invisível logado no Aspa, executa uma ação por vez no painel e vigia mensagens novas. O servidor MCP é a ponte com o assistente (Claude Code, Codex ou outro cliente de MCP) e também entrega as diretrizes e os documentos da equipe.

Um atendimento do começo ao fim

Fonte editável do diagrama: assets/atendimento.mmd

Testado com

Testado de ponta a ponta: login, leitura, anexos (imagem, PDF, áudio), transcrição, envio de texto, anexo e template, concluir, reabrir, adiar, renomear contato e notificações no Ubuntu. Também testados: assumir, transferir, criar contato, janela de revisão, filtros, busca, estatísticas, responder citando e adiar até data. Anexos de vídeo: só download. No Codex, um segundo atendente testou a instalação, a configuração guiada e a leitura, sem enviar nada (detalhes em Outros clientes).

Segurança em uma frase

Nada é enviado, transferido ou concluído sem a sua aprovação, toda ação confere antes se a conversa aberta é a certa, e tudo fica num registro de auditoria local. Detalhes em Segurança e privacidade.

Roadmap

• Leitura, anexos, transcrição local e envio com aprovação

• Concluir, reabrir, adiar, renomear e assumir conversas

• Notificações no Ubuntu, Slack (direto para a pessoa) e celular

• Configuração da equipe e pessoal: tom, regras, exemplos, documentos, horários e canais

• Registro de auditoria de toda ação feita no Aspa

• Janela de revisão do rascunho no próprio Aspa

• Filtros e ordenação da lista, busca na conversa, nos concluídos e nos contatos

• Marcar como não lida, ler sem marcar, responder citando, adiar até data e hora

• Estatísticas e Respostas Rápidas

• Notificações por atendente, contato e conversa nova

• Transferência, assumir conversa de outro atendente e criação de contato testados ao vivo

• Modo somente leitura para outros clientes de MCP

• Configuração guiada pelo próprio MCP (checklist, ajustes, documentos, Slack e teste de avisos)

• Transcrição na GPU (CUDA)

• Usar as Respostas Rápidas automaticamente nos rascunhos (a conta ainda não tem nenhuma)

• Editar e-mail e empresa do contato; status do atendente

• Testar de forma interativa no Antigravity, opencode (DeepSeek, GLM, Kimi), Grok Bot e Z Code

• Jornadas e etiquetas, quando configuradas na conta

• API oficial da Aspa no lugar da automação do painel, quando disponível

• Webhook de mensagens: dispensar o navegador e oferecer conector para o claude.ai

Licença

MIT. Projeto independente, sem vínculo com a Aspa.