Com o MCP oficial da Omie, você conversa com o Omie no assistente de IA que já usa. Pergunte em português e ele responde com os dados da sua empresa: contas, pedidos, estoque, ordens de serviço, CRM e clientes.
Sem código, sem chave de integração, com o mesmo login do Omie.
💡 Dica Omie: O passo a passo com botões e as habilidades para baixar também estão no guia do MCP da Omie.
Tópicos do Artigo:
Por que é seguro
🔐 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.
👤 Só o que você já pode: o assistente só vê e faz o que você já vê e faz no Omie, e só nas empresas a que você tem acesso.
✋ Excluir e cancelar pedem a sua confirmação: o assistente avisa que não têm volta e pergunta antes. Incluir, alterar e faturar acontecem na hora, como se você fizesse pela tela. As habilidades de faturar e de tirar pedido mostram o documento e pedem o seu sim antes.
🏢 Várias empresas de uma vez: se você tem acesso a mais de uma empresa, o assistente pode consultar todas numa mesma pergunta.
Passo 1: conecte
O endereço do MCP da Omie é:
https://api.omie.com.br/mcp
ChatGPT
1) Em Configurações, abra Aplicativos e conectores e crie um conector.
2) Cole o endereço acima.
3) Entre com o seu login do Omie e clique em Autorizar.
4) Na conversa, ative o conector do Omie.
Passo a passo com imagens: Conectando o Omie ao ChatGPT.
Claude
1) Em Configurações, abra Conectores.
2) Procure Omie e clique em Conectar.
3) Entre com o seu login do Omie e clique em Autorizar.
Detalhes, inclusive para contas de empresa: Conectando o Omie ao Claude.
Gemini (em breve)
Estamos finalizando a liberação com o Google. Quando estiver disponível, o passo a passo aparece aqui.
Para conferir que deu certo, 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.
Passo 2: comece por estas perguntas
Funcionam em qualquer assistente conectado. Se você tem mais de uma empresa, diga qual, ou peça "em todas". Pode perguntar do seu jeito: não precisa decorar as frases. As respostas abaixo são exemplos de uma empresa fictícia.
Financeiro
01 · Bom dia, como estamos?
Começar o dia com o saldo, o que vence hoje e o que já pede atenção.
🙋 Você: Bom dia! Como estamos hoje?
🤖 Assistente (exemplo):
Bom dia! Hoje, na sua empresa:
• Saldo em conta: R$ 48.230
• Vence hoje: R$ 6.150 a pagar e R$ 9.870 a receber
• Maior conta do dia: aluguel, R$ 3.800
• Em atraso: 4 títulos a receber
• 2 pedidos esperando nota
02 · O caixa dos próximos dias
Ver o saldo dia a dia e onde ele aperta.
🙋 Você: Como fica o meu caixa nos próximos 10 dias?
🤖 Assistente (exemplo):
Saldo previsto nos próximos 10 dias:
• Hoje: R$ 51.950
• Sexta: R$ 44.300
• Dia 15: R$ 58.120
Ponto de atenção: a maior saída é na sexta, R$ 12.400.
Nenhum dia fica negativo.
03 · Atrasos por idade
Saber quanto está em atraso e há quanto tempo, a pagar e a receber.
🙋 Você: O que está em atraso hoje, a pagar e a receber?
🤖 Assistente (exemplo):
A receber em atraso:
• Até 30 dias: 6 títulos, R$ 3.200
• De 31 a 90 dias: 2 títulos, R$ 1.150
• Mais de 90 dias: 1 título, R$ 400
A pagar: nada em atraso.
04 · Todas as empresas de uma vez
Para quem cuida de várias empresas: uma lista só, da que mais pede atenção para a que menos pede.
🙋 Você: Em quais das minhas empresas há títulos em atraso?
🤖 Assistente (exemplo):
Das suas 12 empresas, 3 têm títulos em atraso:
• Loja: 14 a receber, 2 a pagar
• Padaria: 4 a receber
• Oficina: 3 a pagar
As outras 9 estão em dia.
Estoque
05 · Estoque que precisa de atenção
Achar produto negativo, abaixo do mínimo ou prometido além do que existe.
🙋 Você: Quais produtos estão pedindo atenção no estoque?
🤖 Assistente (exemplo):
3 grupos pedem atenção:
• Negativo: Pão de forma integral (-12)
• Abaixo do mínimo: Farinha T65 (8 kg, mínimo 20 kg)
• Reservado além do físico: Fermento seco (10 reservados, 4 no estoque)
06 · Quanto tenho de um produto
Ver o saldo de um produto em cada local, com o que já está prometido e o que vai entrar.
🙋 Você: Quanto tenho de farinha T65?
🤖 Assistente (exemplo):
Farinha T65, hoje:
• Depósito: 8 kg (mínimo 20 kg)
• Loja: 3 kg
• 5 kg reservados para pedidos
• 25 kg previstos para entrar
Ponto de atenção: o depósito está abaixo do mínimo.
07 · O que entrou e saiu de um produto
Ver o movimento de um produto no período: entradas, saídas e de onde vieram.
🙋 Você: O que entrou e saiu de fermento seco nos últimos 30 dias?
🤖 Assistente (exemplo):
Fermento seco, últimos 30 dias:
• Entradas: 40 un. (2 notas de compra)
• Saídas: 46 un. (31 vendas no PDV, 3 pedidos)
• Último movimento: ontem, venda no PDV
Saiu mais do que entrou no período: 6 un.
CRM
08 · Como está o meu funil
Ver as oportunidades em cada fase, com o valor, e as que estão paradas ou com a previsão vencida.
🙋 Você: Como está o meu funil de vendas?
🤖 Assistente (exemplo):
Seu funil hoje:
• Prospect: 12 oportunidades, R$ 84 mil
• Proposta: 5 oportunidades, R$ 61 mil
• Negociação: 3 oportunidades, R$ 38 mil
Pontos de atenção: 4 com a previsão de fechamento vencida e 6 sem alteração há mais de 30 dias.
09 · Minhas tarefas de hoje
Começar o dia com as tarefas de hoje e as que ficaram para trás.
🙋 Você: Quais são as minhas tarefas de hoje?
🤖 Assistente (exemplo):
Você tem 5 tarefas para hoje:
• Ligar para o Mercado Bom Preço (urgente)
• Enviar proposta para o Café da Esquina
• e mais 3
Ficaram para trás: 2 tarefas de dias anteriores.
Vendas e serviços
10 · Tirar um pedido (cria pedido, pede a sua confirmação)
Criar um pedido de venda ditando o cliente e os itens, com o pedido montado na tela antes de incluir.
🙋 Você: Tira um pedido para o Mercado Bom Preço: 10 farinhas T65 e 5 fermentos.
🤖 Assistente (exemplo):
Montei o pedido para o Mercado Bom Preço:
• 10 Farinha T65 x R$ 18,00 = R$ 180,00
• 5 Fermento seco x R$ 9,50 = R$ 47,50
Total R$ 227,50. Atenção: só há 4 fermentos no estoque.
Qual a condição de pagamento? Depois disso, posso incluir?
11 · Pedidos esperando nota
Ver os pedidos de venda prontos para faturar e há quanto tempo estão parados.
🙋 Você: Quais pedidos estão esperando nota, e há quanto tempo?
🤖 Assistente (exemplo):
2 pedidos esperando nota, R$ 4.695 no total:
• Pedido 529: parado há 9 dias, R$ 1.215
• Pedido 532: parado há 2 dias, R$ 3.480
12 · Faturar um pedido de venda (emite nota, pede a sua confirmação)
Emitir a nota fiscal de um pedido, conferindo antes se ele pode ser faturado.
🙋 Você: Fatura o pedido 532.
🤖 Assistente (exemplo):
Conferi o pedido 532 e ele pode ser faturado:
• Cliente: Mercado Bom Preço
• 3 itens, R$ 3.480, boleto em 30 dias
Faturar emite a NF-e e não tem desfazer simples. Confirma?
(depois do seu sim) Pronto, NF-e 1.204 autorizada.
13 · Ordens de serviço em aberto
Ver o que ainda não foi faturado, separando o que já passou da previsão.
🙋 Você: Como estão as ordens de serviço em aberto?
🤖 Assistente (exemplo):
4 ordens de serviço em aberto, R$ 3.950 no total:
• Atrasadas (previsão já passou): 2
OS 1019, 12 dias de atraso, R$ 1.200
OS 1021, 3 dias de atraso, R$ 850
• No prazo: 2
14 · Faturar uma ordem de serviço (emite nota, pede a sua confirmação)
Emitir a nota de serviço (NFS-e) de uma OS, conferindo antes se ela pode ser faturada.
🙋 Você: Fatura a OS 1021.
🤖 Assistente (exemplo):
Conferi a OS 1021 e ela pode ser faturada:
• Cliente: Café da Esquina
• Manutenção preventiva, R$ 850
Faturar emite a NFS-e e não tem desfazer simples. Confirma?
(depois do seu sim) Pronto, enviada à prefeitura. NFS-e 318 autorizada.
Auditoria
15 · Quem alterou este cadastro
Ver o que mudou num cadastro, quando e por quem, mesmo que ele tenha mudado de nome.
🙋 Você: Quem alterou o cadastro do Mercado Bom Preço?
🤖 Assistente (exemplo):
Últimos 90 dias no cadastro do Mercado Bom Preço:
• 02/10, Ana: limite de crédito de R$ 5.000 para R$ 15.000
• 18/09, integração: e-mail de cobrança trocado
• 18/09, Ana: e-mail de cobrança trocado de novo
Ponto de atenção: o e-mail de cobrança mudou duas vezes no período.
16 · O que foi excluído
Ver o que foi apagado, por quem e quando, com o conteúdo do registro.
🙋 Você: O que foi excluído de clientes nesta semana?
🤖 Assistente (exemplo):
Nesta semana, 3 clientes foram excluídos:
• 06/10, Ana: Café da Esquina (CNPJ 11.222.333/0001-81)
• 06/10, Ana: Padaria Central
• 03/10, Bruno: Oficina Modelo
Ponto de atenção: 2 exclusões no mesmo minuto, pela mesma pessoa.
Cadastro
17 · Cadastrar sem abrir a tela
Incluir um cliente ditando os dados.
🙋 Você: Cadastre o cliente Café da Esquina Ltda, CNPJ 11.222.333/0001-81.
🤖 Assistente (exemplo):
Pronto! Café da Esquina Ltda cadastrado.
Habilidades: o assistente já sabe o caminho
Cada pergunta acima também existe como habilidade: um arquivo de texto que ensina o assistente a buscar aquilo no Omie do jeito certo. Funciona em qualquer assistente conectado ao Omie.
1) Baixe a habilidade no guia do MCP da Omie (uma por vez, ou todas num arquivo só).
2) Anexe o arquivo na conversa e peça: "Use esta habilidade do Omie."
3) Para não precisar anexar sempre, coloque o arquivo nas instruções de um Projeto (ChatGPT, Claude) ou de um Gem (Gemini).
Quer ir além?
O assistente responde o que você pergunta e destaca o que pede atenção. Os Agentes de IA dentro do Omie vão além: acompanham a cobrança, analisam o fluxo de caixa e sugerem o que fazer, com o conhecimento de cada área do sistema. Confira Conhecendo os agentes de IA da Omie.
Dicas de uso
Diga a empresa: se você tem acesso a mais de uma, diga em qual delas quer consultar ou alterar, ou peça "em todas as minhas empresas".
Consultas grandes: listas com muitos registros vêm em páginas, então perguntas de totais podem levar mais tempo. Prefira um período.
Aprovação: o assistente pode pedir a sua aprovação antes de usar o Omie. Nas configurações do conector dá para escolher o que ele faz sem perguntar.
Para desenvolvedores: requisitos técnicos
Para quem quer conectar outra ferramenta, integrar o MCP a um sistema próprio, 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ó comPOSTe resposta em JSON.Não há fluxo de eventos nem sessão:
GETeDELETEno 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-resourcee pelo cabeçalhoWWW-Authenticatedo 401.Nos assistentes, 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.Desenvolvimento próprio: para integrar o MCP a um sistema seu, é preciso um client ID cadastrado pela Omie. Solicite pelo Suporte, informando o nome do sistema e os endereços de retorno (redirect) dele.
Não há registro dinâmico de cliente (DCR).
O parâmetro
resourcedeve serhttps://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. Excluir e cancelar exigem o parâmetroconfirmado.omie_executar_em_varias: executa a mesma operação em até 40 empresas de uma vez.
Limitações conhecidas
Ferramentas de terceiros que exigem registro dinâmico ou client ID próprio 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. Ele funciona pelas APIs do Omie: empresas com mensalidade precisam do pacote de APIs, e no plano gratuito e em aplicativos de demonstração ele funciona com limite de uso por dia.
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.
O que são as habilidades para baixar?
São arquivos de texto, um por pergunta deste artigo, que ensinam o assistente a buscar aquilo no Omie do jeito certo. Funcionam em qualquer assistente: anexe na conversa e peça "use esta habilidade do Omie", ou deixe fixo num Projeto ou Gem. Os arquivos estão no guia do MCP da Omie.
Posso integrar o MCP a um sistema próprio?
Sim. Solicite um client ID pelo Suporte, informando o nome do sistema e os endereços de retorno (redirect). Os requisitos técnicos estão em Para desenvolvedores: requisitos técnicos.
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