Odoo Pulse

odoo-pulse

Um analista de negócios com IA para o seu ERP Odoo. Faça uma pergunta, obtenha uma resposta — números, destaques, riscos e um veredito (no caminho / em risco / fora do caminho) — via Model Context Protocol. Pontes CRUD para o Odoo já existem; esta é a camada de análise que fica por cima.

As ferramentas do analista

Cada ferramenta responde a uma questão gerencial completa em uma única chamada, retornando um relatório estruturado com um veredito — não um despejo bruto que você precisa interpretar.

Ferramenta	Responde
business_pulse ⭐	O briefing matinal: vendas de ontem, novos leads, faturas vencidas, tarefas atrasadas, quem está de folga — com um veredito para toda a empresa
pipeline_review	Funil de CRM por etapa, negócios parados, receita ponderada, taxa de conversão recente
sales_snapshot	Receita deste período vs. anterior (Δ%), principais clientes/produtos, cotações obsoletas
receivables_health	Faixas de vencimento de contas a receber/pagar, % em atraso, principais devedores
inventory_risk	Faltas (previsão negativa) e estoque parado
absence_overview	Quem está de folga esta semana, aprovações pendentes, departamentos com cobertura insuficiente
procurement_watch	Compras: recebimentos atrasados, cotações obsoletas, gastos em aberto por fornecedor
production_health	Manufatura: ordens atrasadas em relação ao início planejado, WIP travado
project_profitability	Projetos: horas registradas vs. alocadas, custo/receita/margem, veredito de consumo do orçamento
project_budget	Orçamento vs. real por projeto, linha por linha — linhas acima do planejado e gastos que o orçamento não captura
team_workload · project_status_report · standup_digest	Entrega de projetos: membros sobrecarregados, projetos em risco e um resumo diário de stand-up

Toda ferramenta que reporta dinheiro aceita um filtro opcional company= e sinaliza totais em moedas mistas em vez de somá-los silenciosamente; os limites de veredito (% parado, % em atraso, % de crescimento) são parâmetros, para que você possa calibrá-los para o seu negócio.

Semântica de fuso horário

Todas as ferramentas de relatório aceitam timezone_offset (padrão 7). O Odoo armazena campos de data/hora em UTC; as ferramentas os deslocam em timezone_offset horas antes de agrupar por dia de calendário, e as janelas de dias nos domínios são expressas como limites de data/hora UTC. Campos somente de data (ex.: project.milestone.deadline, invoice_date_due, project.task.date_deadline) são comparados como estão.

Campos dependentes da versão

find_partner pesquisa mobile apenas em instâncias que ainda o possuem (removido no Odoo 19), e list_timesheets reporta um erro acionável quando hr_timesheet não está instalado.

Por baixo dos panos, é a API externa XML-RPC padrão do Odoo — nada para instalar dentro do Odoo, funciona no Odoo Online, Odoo.sh e on-premise. Requer Odoo 18+: as ferramentas genéricas (search_read, read_records, …) ainda rodam em versões mais antigas, mas as ferramentas de relatório não são garantidas lá.

Experimente o playground

Não tem conta no Odoo? Inicie um Odoo de demonstração pré-carregado com uma história para contar (um negócio parado, uma fatura vencida há 90 dias, uma falta de estoque, alguém de folga hoje):

docker compose -f deploy/playground/compose.yml up -d

A primeira inicialização baixa ~4 GB de imagens (Odoo + Postgres) e carrega os dados de demonstração — permita de 5 a 10 minutos dependendo da sua conexão. Depois aponte o Claude para ele e peça para run business_pulse. Passo a passo completo: docs/guides/playground.md.

Instalação e conexão

Adicione ao Claude Code (sem etapa de instalação — uvx o busca):

claude mcp add odoo-pulse \
  --env ODOO_URL=https://acme.odoo.com \
  --env ODOO_DB=acme \
  --env ODOO_USERNAME=you@example.com \
  --env ODOO_API_KEY=your-api-key \
  --env ODOO_READ_ONLY=true \
  -- uvx odoo-pulse

Gere a chave de API no Odoo em Configurações → Usuários → (seu usuário) → Segurança da Conta → Nova Chave de API. Configuração para Claude Desktop e Cursor, além de alternativas via pip e Docker: docs/guides/install.md. Se uma chave pode ter sido exposta, veja Se uma chave de API pode ter sido exposta.

Ou com um clique:

Somente leitura por padrão, gravações seguras quando você quiser

O servidor é somente leitura por padrão (ODOO_READ_ONLY=true). Gravações exigem quatro controles independentes alinhados: ODOO_READ_ONLY=false, ODOO_WRITABLE_MODELS (uma lista de permissão de modelos separada por vírgulas), ODOO_ALLOW_DELETE=true adicionalmente para exclusões, e um confirm=true por chamada — toda ferramenta de gravação retorna uma prévia de simulação sem ele. Modelos de sistema nunca são graváveis. Detalhes: docs/reference/tools.md#write-operations.

Mais ferramentas

Além dos relatórios do analista, há ~60 ferramentas de consulta cientes de modelos abrangendo CRM, Vendas, Inventário, Contabilidade, RH, Projeto, Manufatura, PoS e aplicativos Enterprise — ative via ODOO_TOOL_GROUPS. Catálogo completo e configuração: docs/reference/tools.md.

Testes

A suíte simula a camada XML-RPC, então não é necessário Odoo real ou rede:

pip install -e ".[dev]"
pytest

Para uma verificação ao vivo contra um Odoo real (somente leitura), veja docs/reference/tools.md#live-smoke-test-against-a-real-odoo.

Licença

MIT