Passar para o conteúdo principal

Conectando o Omie a um assistente de IA (MCP)

Neste artigo, descubra o que é o MCP oficial da Omie e como conectar o Omie ao assistente de IA que você usa, para consultar e operar o sistema conversando.

Escrito por Rodrigo Angeline

O MCP oficial da Omie permite que um assistente de IA consulte e opere o Omie em seu nome: contas a pagar e a receber, pedidos de venda, estoque, ordens de serviço, clientes e muito mais.

MCP (Model Context Protocol) é um padrão aberto que os assistentes de IA usam para se conectar a outros sistemas.

Tópicos do Artigo:

Informações importantes

  • 🔐 Mesmo login do Omie: a conexão abre a tela de login da Omie e depois a de autorização. Não é preciso criar chave de integração nem copiar e colar nenhum código.

  • 👤 Suas permissões: o assistente só consegue ver e fazer o que você já pode ver e fazer no Omie, e só nas empresas a que você tem acesso.

  • 🏢 Várias empresas de uma vez: se você tem acesso a mais de uma empresa, o assistente pode consultar todas numa mesma pergunta.

  • ✍️ As alterações são reais: incluir, alterar e faturar acontecem na hora, como se você fizesse pela tela. Excluir e cancelar sempre pedem a sua confirmação antes, porque não têm volta.

  • 📦 Pacote de APIs: o MCP funciona pelas APIs do Omie. Empresas com mensalidade precisam ter o pacote de APIs contratado. No plano gratuito e em aplicativos de demonstração ele funciona com limite de uso por dia.

💡 Dica Omie: O MCP é para usar o Omie a partir do assistente de IA que você já usa. Para os agentes de IA que ficam dentro do próprio Omie, confira Conhecendo os agentes de IA da Omie.

Conectando o seu assistente

O endereço do MCP da Omie é:

https://api.omie.com.br/mcp

Siga o passo a passo do seu assistente:

Em qualquer assistente, o caminho é parecido:

1) Nas configurações do assistente, procure a área de conectores (ou plugins, ou integrações) e adicione um conector personalizado com o endereço acima.

2) Conecte. O assistente abre a tela de login da Omie: entre com o mesmo e-mail e senha que você usa no Omie.

3) Confira na tela de autorização o que o assistente vai poder fazer e clique em Autorizar.

4) Para começar, pergunte: "quais são as minhas empresas no Omie?"

💡 Nem todo assistente consegue fazer o login na Omie ainda. Os requisitos estão em Para desenvolvedores: requisitos técnicos.

Dicas de uso

  • Diga a empresa: se você tem acesso a mais de uma empresa, diga em qual delas quer consultar ou alterar.

  • Exemplos para começar:

    • "Quanto tenho a receber em atraso na empresa X?"

    • "Em quais das minhas empresas há contas a pagar vencidas?"

    • "Quais ordens de serviço estão abertas?"

    • "Cadastre o cliente Acme Ltda, CNPJ 11.222.333/0001-81."

    • "Quem alterou o cadastro deste cliente, e o que havia antes?"

  • Consultas grandes: listas com muitos registros vêm em páginas, então perguntas de totais podem levar um pouco mais para serem respondidas.

Para desenvolvedores: requisitos técnicos

Para quem quer conectar outra ferramenta, ou entender por que uma ferramenta não conecta. A documentação completa, com todas as operações disponíveis, está em api.omie.com.br/docs.

Transporte

  • Streamable HTTP em https://api.omie.com.br/mcp, só com POST e resposta em JSON.

  • Não há fluxo de eventos nem sessão: GET e DELETE no endereço respondem 405.

Autorização

  • OAuth 2.1 com PKCE (S256) obrigatório. O servidor de autorização é https://app.omie.com.br, descoberto pelo documento /.well-known/oauth-protected-resource e pelo cabeçalho WWW-Authenticate do 401.

  • O cliente se identifica por documento de metadados do cliente (Client ID Metadata Document, CIMD): o client_id é uma URL https que publica o nome e os endereços de retorno do cliente.

  • O documento precisa ser de um provedor liberado pela Omie. Hoje: Claude e ChatGPT.

  • Não há registro dinâmico de cliente (DCR) nem cadastro manual de client ID.

  • O parâmetro resource deve ser https://api.omie.com.br/mcp. Não há escopos a pedir.

Ferramentas

  • omie_listar_apps: lista as empresas a que a pessoa tem acesso.

  • omie_buscar_operacao: acha a operação da API do Omie a partir de um pedido em linguagem natural.

  • omie_descrever_operacao: mostra os campos, as regras e um exemplo da operação.

  • omie_executar: executa a operação numa empresa.

  • omie_executar_em_varias: executa a mesma operação em até 40 empresas de uma vez.

Limitações conhecidas

  • Ferramentas que exigem registro dinâmico ou client ID manual ainda não conseguem fazer o login. Entre elas, hoje, o Cursor e o Gemini CLI.

  • No VS Code com GitHub Copilot Business ou Enterprise, o administrador da empresa precisa liberar o uso de servidores MCP.

  • Vale o limite de consumo das APIs do Omie. Confira Limites de Consumo da API do Omie.

Dúvidas frequentes

Tem custo adicional?

Não há cobrança à parte pelo MCP. Vale a mesma regra das APIs do Omie: empresas com mensalidade precisam do pacote de APIs.

O que acontece com as informações que o assistente consulta?

Os dados que o assistente consulta passam a fazer parte da conversa no aplicativo de IA que você usa, e seguem a política de privacidade desse provedor.

Como desconectar?

Nas configurações do seu assistente, desconecte ou remova o conector da Omie.

Onde vejo o que o MCP consegue fazer?

Na documentação: api.omie.com.br/docs

📚 Artigos Relacionados:

Respondeu à sua pergunta?