Well

Um servidor MCP que unifica suas ferramentas de negócios em um único grafo de contexto que sua IA pode consultar.

Documentação

Well App AI - Contribua Construindo Operadores que Conquistam a Infraestrutura Internacional de Faturas

Você não precisa perder tempo recuperando faturas. A IA pode.

Chrome Web Store License: MIT Add to Claude Code


Sumário


Visão Geral

Well é a extensão do Chrome que se torna a melhor amiga de todo fundador quando chega a temporada de contabilidade.

Ela automatiza a recuperação de faturas de fornecedores e envia os dados diretamente para suas ferramentas contábeis, ERP ou dashboards — com zero esforço.

Feita para fundadores, operadores solo e equipes enxutas, a Well substitui horas de cliques repetitivos, arrastar, perseguir e copiar-colar. O que costumava consumir dias durante as temporadas de impostos agora leva um clique.

Em sua essência, a Well é uma extensão do Chrome que automatiza fluxos de trabalho no navegador em seu nome — aumentando a produtividade ao recuperar faturas em lote. Você também pode usá-la em movimento: enquanto navega, a Well captura faturas para você.

Recursos incluem:

  • Ingestão via WhatsApp e e-mail
  • Integrações com Google Drive e Slack
  • Blueprints de fluxo de trabalho gerados por IA
  • Automações auto-reparáveis que se adaptam a mudanças
  • Suporte a exportação em múltiplos formatos (JSON, CSV, XML, UBL, QuickBooks, Xero)
  • Validação integrada para integridade dos dados de faturas
  • Sistema de plugins extensível para formatos personalizados
  • Compatibilidade com padrões de e-invoicing, incluindo Factur-X e UBL 2.1

Acreditamos que a troca de faturas deveria seguir um protocolo universal: instantâneo, padronizado e automatizado. Você não deveria precisar pensar nisso. Com a Well, você não vai.


Recursos e Benefícios

  • Mais de 100.000 portais web cobertos
    Desde as plataformas de SaaS, utilidades e e-commerce mais usadas até portais de cauda longa que você achava que ninguém conseguiria automatizar.

  • Captura omnichannel
    Colete faturas do Gmail, WhatsApp, PDFs e muito mais — em tempo real.

  • Funciona com sua stack
    Conecta-se perfeitamente às suas ferramentas contábeis, ERP, CRM e planilhas — sem configuração extra.

  • Fluxos de trabalho auto-reparáveis
    A Well se adapta em tempo real quando as interfaces dos fornecedores mudam.

  • Privacidade em primeiro lugar, por design
    Nenhuma senha é armazenada. Totalmente em conformidade com GDPR e CCPA.

  • Formatos de Exportação A Well suporta exportação de dados de faturas em múltiplos formatos:

    FormatoDescriçãoMelhor Para
    JSONFormato JSON padrãoAPIs, Aplicações Web
    CSVValores separados por vírgulaPlanilhas, Análise de Dados
    XMLFormato XML padrãoSistemas Empresariais
    UBLUniversal Business Language 2.1E-invoicing Internacional
    QuickBooksFormato IIFQuickBooks Desktop
    XeroCSV compatível com XeroContabilidade Xero
  • Validação de Dados

    • Validação automática de campos obrigatórios
    • Verificação de tipo para valores e datas
    • Regras de validação extensíveis
    • Mensagens de erro claras para problemas de dados

Casos de Uso

  • Fundador em movimento
    Um clique, zero esforço — a Well recupera faturas de e-mails, navegadores ou WhatsApp.

  • Operador se preparando para o fechamento do mês
    Extraia 50+ faturas de 15+ portais em menos de 5 minutos — sem carga mental.

  • Líder de finanças aplicando a mentalidade 5S
    Imponha estrutura na origem: classifique, organize, padronize — e automatize.

  • Gestor acompanhando orçamentos de equipe
    Monitore gastos com fornecedores em tempo real, detecte desvios orçamentários e descubra economias.

  • Contador construindo uma trilha de auditoria limpa
    Comprove despesas na época de impostos com registros completos e padronizados.


Como Funciona

Uso Básico

from exporters import get_exporter

# Get an exporter instance
exporter = get_exporter('json')  # or 'csv', 'xml', 'ubl', 'quickbooks', 'xero'

# Export data
data = {
    'invoice_number': 'INV-1234',
    'date': '2025-07-29',
    'amount': 199.99,
    'customer': 'Acme Corp',
    # ... other fields
}

exporter.export(data, 'invoice.json')

Campos Obrigatórios

Todas as faturas devem incluir estes campos obrigatórios:

  • invoice_number (str): Identificador único da fatura
  • date (str): Data da fatura no formato AAAA-MM-DD
  • amount (float): Valor total da fatura (deve ser positivo)
  • customer (str): Nome do cliente
  1. Explore nossa galeria de provedores
    Visite wellapp.ai/providers para explorar milhares de portais suportados.

  2. Inicie a extensão do Chrome
    Instale e fixe a extensão. Um clique para iniciar a recuperação de faturas.

  3. Detecção automática de faturas enquanto você navega
    A IA da Well sugere a recuperação quando detecta uma fatura paga.

  4. Recuperação em lote durante a temporada de impostos
    Execute recuperações em larga escala com poucos cliques.

  5. Gere novos blueprints com IA
    Use o Modo Contribuidor para ensinar novos fluxos de trabalho à Well sem código.

  6. Deixe-a se auto-reparar
    Quando um portal muda, a Well se adapta — sem necessidade de correções manuais.


Instalação

  1. Instale pela Chrome Web Store.
  2. Fixe a extensão na sua barra de ferramentas.
  3. Faça login para começar a sincronizar com suas ferramentas contábeis.

Integração MCP

Conecte seu assistente de IA à Well usando o Model Context Protocol (MCP).

Consulte suas faturas, empresas e contatos diretamente do Claude, Cursor, Windsurf ou ChatGPT.

Plugin Claude Code (um clique)

A forma mais rápida de usar a Well no Claude Code — inclui o MCP e habilidades financeiras (construir um compte de résultat, balanço patrimonial, conciliar transações), sem necessidade de chave de API:

/plugin marketplace add WellApp-ai/Well
/plugin install well@well

Em seguida, execute /mcp, selecione well e Authenticate (login pelo navegador). Execute cada comando em sua própria linha.

Início Rápido (qualquer cliente MCP)

https://api.wellapp.ai/v1/mcp

Adicione esta URL ao seu cliente MCP e autentique-se com sua conta Well. No Claude Desktop / web: Configurações → Conectores → Adicionar conector personalizado. No Codex: adicione-a ao ~/.codex/config.toml via mcp-remote.

Documentação

Ferramentas Disponíveis

FerramentaDescrição
well_get_schemaDescubra roots e campos disponíveis
well_query_recordsConsulte faturas, empresas, pessoas, transações, o razão contábil, …
well_get_entityBusque um único registro por id
well_add_contact_channelAdicione um e-mail/telefone a uma empresa ou pessoa
well_remove_contact_channelRemova um canal de contato
well_update_invoiceAtualize campos em uma fatura
well_delete_invoiceExclua uma fatura

Para documentação completa, visite docs.wellapp.ai/mcp


Estendendo a Well

Adicionando Novos Formatos de Exportação

  1. Crie um novo arquivo Python no diretório exporters
  2. Crie uma classe que herde de BaseExporter
  3. Implemente o método _export
  4. Adicione o decorador @ExporterFactory.register()

Exemplo:

from .base_exporter import BaseExporter
from .exporter_factory import ExporterFactory

@ExporterFactory.register("myformat")
class MyFormatExporter(BaseExporter):
    """Exports invoice data to MyFormat."""
    
    def _export(self, data: dict, output_path: str) -> None:
        with open(output_path, 'w') as f:
            f.write(f"MyFormat: {data['invoice_number']}")

Contribuindo

Aceitamos contribuições da comunidade. Para propor uma correção, recurso ou melhoria:

  • Abra um pull request
  • Envie uma issue
  • Ou contribua com um novo blueprint via Modo Contribuidor

Revise nosso CONTRIBUTING.md e Código de Conduta.


Licença

Distribuído sob a Licença MIT. Consulte LICENSE para mais informações.


Agradecimentos

Agradecemos a todos os contribuidores e usuários iniciais que ajudaram a moldar a Well. Agradecimento especial às bibliotecas e protocolos de código aberto que tornaram isso possível.


Roadmap

  • Lançar beta público
  • Expandir suporte para 200K+ portais
  • Adicionar assistente de recuperação móvel
  • Habilitar integrações com Zapier e Make
  • Criar um ranking de contribuidores

FAQ

P: Meus dados estão seguros com a Well?
R: Sim. Não armazenamos senhas, seguimos padrões rígidos de criptografia e estamos em conformidade com GDPR e CCPA.

P: Posso usar a Well fora do Chrome?
R: Atualmente, a Well está disponível como extensão do Chrome. Outros navegadores podem ser suportados no futuro.

P: Como adiciono um novo portal?
R: Use o Modo Contribuidor para guiar a IA pelo seu fluxo de trabalho. Um blueprint é gerado instantaneamente.