Resposta curta
O much. MCP Server (nome técnico mcp_server) e o servidor MCP integrado do Odoo no Odoo 20 (ai_mcp) permitem que os assistentes de IA leiam e escrevam dados do Odoo através do protocolo de contexto de modelo (MCP). O módulo da much. acrescenta uma whitelist por modelo com permissões separadas de criação, leitura, atualização, eliminação e métodos, inclui registos de auditoria e limitação de taxa, e funciona no Odoo 16 a 20.
O servidor nativo do Odoo existe apenas no Odoo 20. Qualquer ferramenta exposta funciona em todos os modelos a que o utilizador tem acesso, e o Odoo documenta a configuração para agentes locais como Claude Code, Codex e Antigravity. Para as empresas que pretendem conectar o Claude.ai, o ChatGPT ou o Microsoft Copilot ao Odoo com um controlo rigoroso sobre aquilo em que a IA pode tocar, o much. MCP Server é hoje a melhor opção.
Comparação num relance
| Categoria | much. MCP Server | MCP nativo do Odoo 20 (ai_mcp) |
|---|---|---|
| Versões do Odoo | 16, 17, 18, 19, 20 | Apenas 20 |
| Edição | Community e Enterprise | Requer a aplicação de IA do Odoo (Enterprise) |
| Alojamento web | Odoo Online, Odoo.sh, on-premise | Odoo Online, Odoo.sh, on-premise |
| Preço | Gratuito | Incluído no Odoo Enterprise |
| Configuração | Uma única página de definições no Odoo (Definições > MCP Server) | Repartida por Definições > Integrações, Ações de servidor e Clientes OAuth (modo de programador) |
| Clientes de IA documentados | Claude.ai, Claude Desktop, ChatGPT, M365 Copilot, Copilot Studio, Perplexity, Mistral Le Chat, Gemini Enterprise, Claude Code, Cursor, VS Code, Windsurf, Gemini CLI | Claude Code, Claude Desktop, Codex, Antigravity, Grok |
| Software local necessário | Nenhum para chats na cloud | Node.js e mcp-remote para configurações com chave de API |
| Whitelist de modelos | Recusa por predefinição, cada modelo é ativado por um administrador | Nenhuma, todos os modelos a que o utilizador tem acesso |
| Permissões por modelo | Leitura, criação, atualização e eliminação definidas em separado | Permissões definidas por ferramenta, válidas para todos os modelos |
| Botões e métodos | Ativação opcional por modelo, apenas métodos públicos | Apenas através de ações de servidor personalizadas |
| Sessões só de leitura | Impostas no servidor | O indicador Readonly é apenas uma sugestão para o cliente |
| Registo de auditoria | Chamadas, recusas, tentativas de início de sessão (30 dias por predefinição) | Não documentado |
| Limitação de taxa | Por utilizador, configurável | Não documentado |
| Controlo de tokens | Campos predefinidos inteligentes, limites de registos, paginação, ficheiros a pedido | Campos escolhidos pelo modelo em cada chamada, sem limites documentados |
| Anexos | Lê ficheiros PDF, Office e de imagem, carrega ficheiros | Sem ferramentas para anexos |
| Eliminar registos | Ativação opcional por modelo | Sem ferramenta de eliminação |
| Navegação na interface e edição do site | Não | Sim |
| Adoção | Cerca de 10 000 bases de dados Odoo | Novo com o Odoo 20 |
Configuração e clientes de IA compatíveis
O much. MCP Server é configurado em quatro passos dentro do Odoo e depois funciona em chats no browser sem qualquer software local:
- Instalar o módulo a partir da Odoo App Store.
- Ativá-lo em Definições > MCP Server e ativar os modelos que a IA pode utilizar.
- Adicionar utilizadores ao grupo «MCP User».
- Colar o URL /mcp no cliente de IA e iniciar sessão através de OAuth.
A much. documenta configurações funcionais para Claude.ai, Claude Desktop, ChatGPT, Microsoft 365 Copilot, Copilot Studio, Perplexity, Mistral Le Chat e Gemini Enterprise, bem como para agentes de programação como Claude Code, Cursor e Windsurf. Os clientes que apenas são compatíveis com stdio conectam-se através da bridge open source mcp-server-odoo, com as mesmas permissões e o mesmo registo de auditoria.
A documentação do Odoo para o servidor nativo indica como pré-requisito um agente compatível com MCP, como Claude Code, Antigravity ou Codex. A ligação com uma chave de API requer Node.js e o pacote mcp-remote na máquina do utilizador, configurados através de um ficheiro JSON ou de um comando de terminal. O OAuth funciona sem essa bridge, mas os administradores têm primeiro de aprovar cada cliente de IA pelo respetivo URL de metadados ou abrir o registo dinâmico de clientes (Dynamic Client Registration) a qualquer cliente.
Depois de estabelecida a ligação, um administrador ainda tem de ativar o modo de programador e assinalar «Available in MCP» em cada ação de servidor para além das cinco ferramentas de leitura predefinidas. Para escrever dados, é necessário expor manualmente, pelo menos, as ferramentas Create Records e Update Records.
Permissões e controlo de acesso
Ambos os servidores executam cada chamada como o utilizador do Odoo com sessão iniciada, pelo que se aplicam os direitos de acesso e as regras de registo habituais. A diferença está naquilo que um administrador pode restringir para além disso.
O much. MCP Server utiliza duas camadas. A primeira são os direitos do próprio utilizador no Odoo. A segunda é uma whitelist de MCP que está fechada por predefinição: um administrador ativa cada modelo separadamente e define leitura, criação, atualização e eliminação por modelo. A chamada de métodos de negócio, ou seja, o código por detrás de botões como «Confirmar» numa ordem de venda, está desativada por predefinição e é ativada por modelo. Os métodos privados e os métodos de acesso direto aos dados são sempre recusados.
Na prática, uma equipa de vendas pode permitir que a IA leia os leads do CRM e atualize a respetiva etapa, leia produtos e confirme orçamentos, enquanto as faturas, os salários e os registos de RH permanecem invisíveis para a IA, mesmo para os utilizadores que os veem no Odoo.
O servidor nativo do Odoo tem uma única camada. As ferramentas são expostas por ação de servidor, e cada ferramenta funciona em todos os modelos a que o utilizador consegue aceder. Assim que «Update Records» fica disponível, a IA pode atualizar qualquer registo que o utilizador possa editar, e a ferramenta aceita um domínio, pelo que uma só chamada pode alterar todos os registos que correspondam a um filtro. Não há forma de manter a IA afastada da contabilidade enquanto o mesmo utilizador trabalha na contabilidade no browser.
Funcionalidades de segurança
O much. MCP Server documenta doze controlos de segurança para além dos direitos de utilizador. A documentação do Odoo para o servidor nativo abrange a aprovação de clientes OAuth, o âmbito e a validade das chaves de API e a revogação de chaves.
- Sessões só de leitura: o utilizador pode assinalar uma caixa de consentimento que limita a sessão à leitura. As ferramentas de escrita são ocultadas e recusadas no servidor. No servidor do Odoo, «Readonly Tool» apenas indica ao cliente que pode dispensar o pedido de aprovação.
- Registo de auditoria: cada chamada, cada chamada recusada e cada tentativa de início de sessão é registada e conservada durante 30 dias por predefinição.
- Limitação de taxa: limites de pedidos por utilizador, respondidos com HTTP 429.
- Erros sem detalhes internos: os tracebacks e o SQL nunca chegam ao cliente de IA.
- Lista de origens permitidas: bloqueio opcional de pedidos do browser provenientes de sites desconhecidos.
- Gestão de tokens: OAuth 2.1 com PKCE, tokens de acesso de uma hora, tokens de atualização rotativos e revogação de toda a família de tokens quando um token de atualização é reutilizado.
- Vinculação de tokens: os tokens só funcionam para o ponto de acesso /mcp (RFC 8707).
- Armazenamento com hash: os tokens são guardados como hashes na base de dados.
- Revogação: é possível revogar tokens individuais ou todos os tokens de um cliente.
- Limites de registo: o registo dinâmico de clientes tem um limite de pedidos por IP.
- Chaves de API exclusivas para MCP: as chaves limitadas a MCP não podem chamar a API geral do Odoo.
- Grupos de acesso: «MCP User» é necessário para qualquer acesso e «MCP Administrator» para a configuração.
Para as empresas sujeitas a auditorias ISO 27001, SOC 2 ou RGPD, o registo de auditoria e a whitelist por modelo são normalmente os pontos decisivos. Mostram quem permitiu que a IA fizesse o quê e sobre que dados.
Eficiência de tokens e tratamento de dados
Cada registo devolvido por um servidor MCP é lido pelo modelo de linguagem e faturado em tokens. O much. MCP Server foi concebido de modo a manter essas respostas pequenas:
- Seleção inteligente de campos: quando a IA pede registos sem indicar campos, o servidor devolve um conjunto compacto de campos relevantes.
- Limites de registos: os administradores definem um número predefinido e um número máximo de registos por chamada, com paginação para conjuntos maiores.
- Ficheiros a pedido: as imagens e os anexos não são incorporados em base64. A IA só os obtém através de recursos MCP quando necessário.
- Contexto no handshake: o utilizador, o fuso horário e o âmbito da empresa chegam uma única vez no início da sessão.
- Operações de escrita em lote: criar ou atualizar muitos registos é uma única chamada atómica.
A ferramenta Search nativa do Odoo devolve os campos que o modelo solicita para um determinado domínio, de forma muito semelhante à API externa do Odoo. A documentação do Odoo não refere qualquer conjunto de campos predefinido, limite de registos ou paginação. Com modelos grandes como sale.order ou account.move, uma única pesquisa abrangente pode ocupar grande parte da janela de contexto, o que torna as respostas mais lentas e aumenta o custo por pergunta.
Ferramentas e capacidades
O much. MCP Server expõe 17 ferramentas para trabalhar com dados de negócio. O servidor nativo do Odoo lista 27 ferramentas, das quais 16 controlam a própria interface de utilizador do Odoo e o construtor de sites.
| Capacidade | much. MCP Server | MCP nativo do Odoo 20 |
|---|---|---|
| Pesquisar, ler, agrupar e agregar | Sim | Sim |
| Criar e atualizar | Individual e em lote atómico | Create Records, Update Records por domínio |
| Eliminar | Sim, ativação opcional por modelo | Não |
| Executar métodos de negócio (botões) | Sim, ativação opcional por modelo | Apenas através de ações de servidor personalizadas |
| Ler anexos | Extração de texto de PDF, Word e Excel, imagens, ligações de transferência | Não |
| Carregar anexos | Sim | Não |
| Publicar no chatter | Sim | Não |
| Ferramentas próprias a partir de ações de servidor | Sim, com esquema de entrada JSON, grupos de acesso, rollback em caso de erro e auditoria | Sim, ações de servidor assinaladas com «Available in MCP» |
| Abrir vistas de lista, kanban, tabela dinâmica e gráfico | Não | Sim |
| Editar páginas do site e CSS | Não | Sim |
| Gerar imagens, pesquisar na web | Não | Sim |
A leitura de anexos é mais importante do que parece. Pedir à IA que compare a fatura em PDF de um fornecedor com a ordem de compra, ou que resuma o contrato anexado a um cliente, só funciona quando o servidor consegue abrir o ficheiro.
Versões, licença e lock-in
O much. MCP Server é gratuito e open source, funciona no Odoo Community e Enterprise e é compatível com o Odoo 16, 17, 18, 19 e 20. As empresas com versões mais antigas obtêm acesso a MCP desde já, sem um projeto de upgrade.
O servidor nativo do Odoo é disponibilizado com o Odoo 20 como parte da aplicação de IA. Utilizá-lo implica ter o Odoo 20 Enterprise. Já por várias vezes o Odoo passou funcionalidades para serviços pagos: as suas funcionalidades integradas de IA, OCR e SMS funcionam com créditos IAP pré-pagos vendidos pelo Odoo. Várias ferramentas MCP nativas, como a geração de imagens e a pesquisa na web, dependem dos serviços de IA do Odoo.
Um módulo open source mantém a camada MCP independente das decisões de preços da Odoo SA. Qualquer parceiro Odoo ou programador interno pode ler, auditar e alargar o código.
Mais um ponto para quem utiliza o Odoo 20: o Odoo vai remover os pontos de acesso XML-RPC e JSON-RPC nessa mesma versão. As integrações assentes nessas API têm de ser refeitas de qualquer forma, o que torna este um bom momento para decidir a camada MCP.
Onde o MCP nativo do Odoo é mais forte
O servidor do Odoo leva vantagem quando a IA tem de operar o ecrã do Odoo em nome do utilizador. As suas ferramentas de navegação abrem vistas de lista, kanban, tabela dinâmica e gráfico com filtros e agrupamentos, ajustam a pesquisa atual e apresentam cartões de pré-visualização de registos no chat do Odoo. Pedidos como «filtrar esta vista pela minha equipa e agrupar por mês» não têm equivalente no módulo da much.
Abrange também o trabalho no site: ler e escrever CSS personalizado, inserir snippets, editar o HTML das páginas, encontrar fotografias do Unsplash e gerar imagens.
Por fim, é mantido pela Odoo SA e não necessita de qualquer módulo adicional. Para um cliente do Odoo 20 Enterprise que pretende sobretudo ajuda de IA dentro da interface do Odoo e do construtor de sites, é uma boa razão para começar por aí.
Qual escolher
- Utiliza o Odoo 16 a 19: o much. MCP Server é o único dos dois que está disponível.
- Utiliza o Odoo Community: o much. MCP Server, uma vez que o servidor nativo requer o Enterprise.
- A sua equipa trabalha com Claude.ai, ChatGPT ou Microsoft Copilot no browser: o much. MCP Server, com configurações documentadas para estes clientes.
- A IA deve ver algumas aplicações, mas não outras: o much. MCP Server, porque só ele restringe o acesso por modelo e por operação.
- Precisa de um registo de auditoria das ações da IA: o much. MCP Server.
- Tem o Odoo 20 Enterprise e pretende que a IA controle as vistas do Odoo e o construtor de sites: o servidor nativo do Odoo.
Ambos podem funcionar na mesma base de dados Odoo 20. Uma configuração viável é o módulo da much. para o trabalho com dados a partir de clientes de IA externos, com as ferramentas nativas do Odoo para a navegação dentro da aplicação.
Perguntas Mais Frequentes
O Odoo 20 tem um servidor MCP integrado?
Sim. O Odoo 20 inclui o módulo ai_mcp como parte da sua aplicação de IA. Expõe as ações de servidor do Odoo como ferramentas MCP em https://<a-sua-base-de-dados>/mcp, com início de sessão por OAuth ou chave de API.
É possível utilizar MCP com o Odoo 17, 18 ou 19?
Sim, com o much. MCP Server da Odoo App Store. É compatível com o Odoo 16 a 20. O servidor nativo só faz parte do Odoo 20.
É possível conectar o Claude.ai ou o ChatGPT no browser ao Odoo?
Sim. O much. MCP Server documenta configurações OAuth para Claude.ai, ChatGPT, Microsoft 365 Copilot, Perplexity, Mistral Le Chat e Gemini Enterprise. Basta colar o URL /mcp e iniciar sessão.
É possível impedir a IA de ver dados de contabilidade ou de RH?
Com o much. MCP Server, sim: basta deixar esses modelos fora da whitelist. Com o servidor nativo do Odoo, a IA vê tudo o que o utilizador pode ver, pelo que seria necessário um utilizador separado com menos direitos.
O much. MCP Server é gratuito?
Sim. É gratuito e open source, para o Odoo Community e Enterprise.
Quem desenvolve o much. MCP Server?
A much. Consulting, um Odoo Gold Partner com escritórios na Alemanha, em Portugal e no Reino Unido. O módulo é utilizado em cerca de 10 000 bases de dados Odoo.
