Odoo MCP Pro (cloud based)

Uma versão em nuvem hospedada ou auto-hospedada do Odoo MCP

GitHub
87

Documentação

Odoo      Model Context Protocol

odoo-mcp-pro

Conector de IA para Odoo ERP — fale com seus dados de negócios usando linguagem natural.
Pesquise, crie, atualize e gerencie registros — basta perguntar.

License: Elastic 2.0 and MPL-2.0 Python 3.10+ MCP Compatible Odoo 14-20 OAuth 2.1

Pule a configuração. A versão hospedada está funcionando em 5 minutos — com atualizações automáticas, OAuth gerenciado e chaves de API criptografadas. Comece em pantalytics.com →

Odoo connected to Claude, OpenAI, Gemini, Copilot, Mistral via MCP

A ideia

Odoo é poderoso. IA é poderosa. Juntos, são melhores.

odoo-mcp-pro é um conector de IA para Odoo que usa MCP (Model Context Protocol) — um padrão aberto que permite que assistentes de IA conversem com sistemas externos. Ele conecta seu assistente de IA ao seu ERP Odoo, para que você possa usar linguagem natural como interface para seus dados de negócios. Não para substituir a interface do Odoo — mas para dar a você uma segunda interface mais rápida para muitas tarefas. Funciona com Claude, ChatGPT, Cursor, Windsurf e qualquer outra ferramenta de IA compatível com MCP.

"Mostre-me todas as faturas não pagas acima de 5.000 EUR do 4º trimestre" — sua IA consulta sua instância Odoo diretamente e retorna os resultados.

Demo of odoo-mcp-pro

Use a interface que se adapta à tarefa. Configuração complexa? Use a interface do Odoo. Consulta rápida de dados, perguntas em massa ou criação de registros em tempo real? Basta perguntar à sua IA.

O que você pode fazer

  • "Encontre todos os contatos em Amsterdã com cotações em aberto"
  • "Crie um lead para a Acme Corp, receita esperada de 50 mil EUR"
  • "Quais pedidos de venda do mês passado ainda não têm entrega?"
  • "Quais campos o modelo sale.order possui?"
  • "Atualize a data de fechamento esperada da oportunidade #42 para a próxima sexta-feira"

Funciona com qualquer modelo Odoo — vendas, faturas, contatos, estoque, CRM, RH, você escolhe.

Quer testar agora? Pule a configuração — a versão hospedada está conectada ao seu Odoo em menos de 5 minutos. Comece em pantalytics.com →

Comece agora

Hospedado (recomendado)

A maneira mais rápida e segura de começar. Nós executamos o servidor para você — cadastre-se, cole sua URL do Odoo + chave de API, pronto.

  • Funcionando em 5 minutos. Sem instalação, sem Docker, sem infraestrutura. Funciona com Claude, ChatGPT, Cursor, Windsurf e qualquer ferramenta de IA compatível com MCP.
  • Sempre atualizado. Correções de segurança, compatibilidade com versões do Odoo e novos recursos MCP são enviados automaticamente — sem trabalho de atualização para você.
  • Mais seguro por padrão. Chaves de API criptografadas (AES-128), OAuth 2.1 gerenciado, monitoramento contínuo, infraestrutura europeia. Cuidamos das partes chatas, mas críticas, para que você não precise.
  1. Cadastre-se em pantalytics.com
  2. Faça login e insira sua URL do Odoo + chave de API (como gerar uma)
  3. Adicione o servidor MCP à sua ferramenta de IA (Claude, ChatGPT, Cursor, etc.)
  4. Comece a fazer perguntas

Seus dados permanecem no Odoo — o servidor é um proxy sem estado. As chaves de API são criptografadas em repouso.

Comece em pantalytics.com →

Auto-hospedado

Execute em sua própria máquina. Apenas single-tenant: uma instância Odoo, configurada via variáveis de ambiente. A autenticação é sua chave de API do Odoo — sem OAuth, sem gerenciamento de usuários, sem interface de administração.

# Install
pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"

# Run (stdio mode, for Claude Desktop / Claude Code)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key python -m mcp_server_odoo

# Run (HTTP mode, for remote access from one trusted network)
ODOO_URL=https://mycompany.odoo.com ODOO_API_KEY=your_key \
  python -m mcp_server_odoo --transport streamable-http --host 0.0.0.0 --port 8000

O modo HTTP não tem autenticação integrada — exponha-o atrás de um proxy reverso ou restrinja no nível da rede.

Ou adicione ao seu Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "mcp_server_odoo"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_API_KEY": "your_api_key_here"
      }
    }
  }
}

Precisa de multi-tenant, conexões por usuário, OAuth ou interface de administração? Isso é território SaaS. A versão hospedada é mais rápida de configurar, atualiza automaticamente e cuida das correções de segurança para você — e custa menos do que o tempo que você gastaria auto-hospedando. Esses recursos estão em um pacote comercial separado que se baseia neste servidor open-core.

Como funciona

odoo-mcp-pro é um conector Odoo que implementa MCP (Model Context Protocol) — um padrão aberto que permite que assistentes de IA chamem ferramentas externas. Ele expõe as seguintes ferramentas que sua IA pode chamar com base em suas perguntas:

FerramentaO que faz
search_recordsPesquise qualquer modelo com filtros de domínio, ordenação, paginação
get_recordBusque um registro específico por ID com seleção inteligente de campos
list_modelsDescubra modelos Odoo disponíveis
list_resource_templatesDescubra modelos de URI de recurso disponíveis
create_record / create_recordsCrie um ou vários registros
update_record / update_recordsAtualize um ou vários registros
delete_record / delete_recordsExclua um ou vários registros
import_recordsUpsert idempotente via IDs externos (igual à importação CSV do Odoo)
server_infoVersão do servidor, status da conexão

Suporta Odoo 14-20 — usa a API JSON/2 para Odoo 19+ e XML-RPC para versões mais antigas. O protocolo correto é selecionado automaticamente.

Segurança

  • O Odoo é o chefe. Todos os dados, permissões e lógica de negócios vivem no Odoo. A chave de API de cada usuário determina o que ele pode ver e fazer — ACLs e regras de registro se aplicam normalmente.
  • Proxy sem estado. O servidor MCP não armazena nem armazena em cache seus dados de negócios.
  • Chaves de API criptografadas em repouso usando AES-128 (Fernet). Nunca expostas à IA, ao navegador ou aos logs.
  • Você mantém o controle. Revogue sua chave de API no Odoo a qualquer momento para cortar o acesso instantaneamente.
  • Encontrou uma vulnerabilidade? Envie um e-mail para rutger@pantalytics.com, veja SECURITY.md. Os relatores são creditados no changelog.

Prefere segurança gerenciada? A versão hospedada cuida de patches, rotação de tokens OAuth e monitoramento de incidentes — seus dados ainda permanecem no Odoo, apenas executamos o proxy para você.

Desenvolvimento

uv venv --python 3.10
source .venv/bin/activate
uv pip install -e ".[dev]"
pytest tests/ -q
ruff check . && ruff format .

Veja architecture.md para detalhes técnicos e CLAUDE.md para convenções de codificação.

Contribuindo

Contribuições são bem-vindas. Faça um fork do repositório, crie um branch de recurso, execute pytest tests/ e ruff check ., e então abra um PR.

FAQ

Quais versões do Odoo são suportadas? Odoo 14-20. O servidor detecta automaticamente se deve usar JSON/2 (Odoo 19+) ou XML-RPC (14-18). Nenhuma configuração necessária.

Funciona no meu celular? Sim — a versão hospedada funciona no Claude mobile (iOS/Android), Claude.ai em qualquer navegador, Claude Desktop, Claude Code e ChatGPT. Instalações locais (STDIO) só funcionam na máquina onde estão instaladas.

Meus dados estão seguros? Seus dados permanecem no Odoo. O servidor MCP é um proxy sem estado — ele não armazena nem armazena em cache dados de negócios. As chaves de API são criptografadas em repouso com AES-128 (Fernet). As permissões do Odoo de cada usuário se aplicam: você só pode ver e fazer o que seu papel no Odoo permite.

Recebo "Access denied" em todos os modelos Isso geralmente significa que sua chave de API do Odoo não tem as permissões corretas. Tente:

  1. Regenere sua chave de API no Odoo (Configurações > Usuários > Chaves de API) e atualize-a onde você a configurou (hospedado: /admin/setup; auto-hospedado: sua variável de ambiente ODOO_API_KEY)
  2. Certifique-se de que seu usuário Odoo tenha pelo menos acesso de leitura aos modelos que deseja consultar
  3. Se você estiver no Odoo.sh, verifique se seu plano de assinatura suporta a API JSON/2

Recebo "Authentication required" ou "invalid_token" (versão hospedada) Isso significa que a conexão OAuth entre sua ferramenta de IA e o servidor MCP falhou. Tente desconectar e reconectar o servidor MCP nas configurações da sua ferramenta de IA. Instalações auto-hospedadas não usam OAuth — elas autenticam diretamente com sua chave de API do Odoo.

Preciso definir ODOO_DB? Somente se você auto-hospedar Odoo com vários bancos de dados. Odoo.sh e Odoo Online não precisam — o hostname determina o banco de dados.

Devo usar hospedado ou auto-hospedado? Hospedado, a menos que você tenha um motivo forte para não. Hospedado está funcionando em 5 minutos, atualiza automaticamente com cada versão do Odoo e tem OAuth gerenciado + chaves de API criptografadas. Auto-hospedar é apenas single-tenant (uma instância Odoo, autenticação por chave de API, sem interface de administração), e você é responsável por patches e segurança. Comece com hospedado em pantalytics.com →

Licença

Este projeto é dual-licensed:

  • Arquivos derivados do mcp-server-odoo original por Andrey Ivanov permanecem sob a Mozilla Public License 2.0 (LICENSE.MPL-2.0). Esses arquivos carregam um cabeçalho SPDX-License-Identifier: MPL-2.0, e NOTICE os lista.
  • Todo o resto — o código que a Pantalytics adicionou por cima — está sob a Elastic License 2.0.

Para as partes licenciadas pela Elastic, em termos simples:

  • Você pode usar, copiar, modificar e distribuir este software — inclusive para seus próprios fins comerciais (executá-lo dentro da sua própria empresa, sua própria instância Odoo, seus próprios projetos).
  • Você não pode oferecê-lo a terceiros como um serviço hospedado ou gerenciado que forneça a eles acesso a um conjunto substancial de seus recursos — é isso que a Pantalytics faz, e é o que a licença protege.
  • Você não pode remover avisos de licença ou contornar a funcionalidade de chave de licença.

As partes licenciadas pela Elastic têm código-fonte disponível, mas não são open-source OSI. Veja LICENSE, LICENSE.MPL-2.0 e NOTICE para o quadro completo.

Para Parceiros de Implementação Odoo

Quer oferecer Odoo com IA aos seus clientes? Executar sua própria versão hospedada do odoo-mcp-pro para clientes não é permitido sob a Elastic License 2.0. Em vez disso, executamos um Programa de Parceiros com comissão de indicação: você recomenda o odoo-mcp-pro aos seus usuários finais, eles se cadastram através do seu link de indicação, e você ganha uma taxa recorrente. Sem hospedagem ou manutenção do seu lado.

Interessado? Entre em contato com rutger@pantalytics.com para detalhes.

Construído pela Pantalytics

odoo-mcp-pro é construído e mantido pela Pantalytics, um parceiro de implementação Odoo sediado em Utrecht, Holanda.

Originalmente bifurcado de mcp-server-odoo por Andrey Ivanov. Os arquivos que vieram desse projeto permanecem sob a Mozilla Public License 2.0; veja NOTICE.

Odoo é uma marca registrada da Odoo S.A. O logotipo MCP é usado sob a Licença MIT. Este projeto não é afiliado ou endossado pela Odoo S.A. ou Anthropic.