Odoo MCP Pro (cloud based)

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

GitHub
74
Experimente este MCPPatrocinado

Documentação

Odoo      Model Context Protocol

odoo-mcp-pro

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

License: Elastic 2.0 Python 3.10+ MCP Compatible Odoo 14-19+ 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 Odoo ERP, para que você possa usar linguagem natural como interface para seus dados de negócio. 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 do Odoo diretamente e retorna os resultados.

Demo of odoo-mcp-pro

Use a interface que se adequa à tarefa. Configuração complexa? Use a interface do Odoo. Consulta rápida de dados, perguntas em lote 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 abertas"
  • "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 do Odoo -- vendas, faturas, contatos, estoque, CRM, RH, você escolhe.

Quer experimentar agora? Pule a configuração -- a versão hospedada é conectada ao seu Odoo em menos de 5 minutos. Comece em pantalytics.com →

Comece agora

Hospedado (recomendado)

A forma 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 lançados 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 se preocupar.
  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 do 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 uma interface de administração? Isso é território de 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 com auto-hospedagem. 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 e 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 recursos 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 (mesmo que a importação CSV do Odoo)
server_infoVersão do servidor, status da conexão

Suporta Odoo 14-19+ -- 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ócio 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ócio.
  • Chaves de API criptografadas em repouso usando AES-128 (Fernet). Nunca expostas à IA, ao navegador ou a logs.
  • Você mantém o controle. Revogue sua chave de API no Odoo a qualquer momento para cortar o acesso instantaneamente.

Prefere segurança gerenciada? A versão hospedada cuida de correções, rotação de tokens OAuth e monitoramento de incidentes -- seus dados continuam no Odoo, nós 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 código.

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 abra um PR.

Perguntas frequentes

Quais versões do Odoo são suportadas? Odoo 14-19+. 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), no Claude.ai em qualquer navegador, no Claude Desktop, no Claude Code e no 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ócio. 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 "Acesso negado" 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 do Odoo tenha pelo menos acesso de leitura aos modelos que você deseja consultar
  3. Se você estiver no Odoo.sh, verifique se seu plano de assinatura suporta a API JSON/2

Recebo "Autenticação necessária" 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 o 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. A versão hospedada está funcionando em 5 minutos, atualiza automaticamente a cada lançamento do Odoo e tem OAuth gerenciado + chaves de API criptografadas. A auto-hospedagem é apenas single-tenant (uma instância do Odoo, autenticação por chave de API, sem interface de administração), e você é responsável por correções e segurança. Comece com a versão hospedada em pantalytics.com →

Licença

Este projeto tem licença dupla:

  • Arquivos derivados do mcp-server-odoo original de Andrey Ivanov permanecem sob a Mozilla Public License 2.0 (LICENSE.MPL-2.0). Esses arquivos têm um cabeçalho SPDX-License-Identifier: MPL-2.0 e o 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 do Odoo, seus próprios projetos).
  • Você não pode oferecê-lo a terceiros como um serviço hospedado ou gerenciado que lhes forneça 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, temos um Programa de Parceiros com comissão de indicação: você recomenda o odoo-mcp-pro aos seus usuários finais, eles se cadastram pelo 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 mais 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 do mcp-server-odoo de Andrey Ivanov. Os arquivos que vieram desse projeto permanecem sob a Mozilla Public License 2.0; veja NOTICE para detalhes.

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