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.
✋ Você aprova o que pesa: registrar pagamento ou recebimento (baixa), incluir, alterar e faturar acontecem na hora, sem aprovação, como se você fizesse pela tela. Pagamento e recebimento vão uma empresa por vez. Pedem aprovação na Omie sempre: o que tira dinheiro da conta (um pagamento de verdade, não o registro da baixa), o que gera custo (consulta de crédito, frete, etiqueta, serviço pago) e negativar ou protestar. Excluir, cancelar e alterar pedem aprovação só quando vêm em sequência (a partir da sexta seguida na mesma empresa, em poucos minutos) ou em várias empresas de uma vez. Na sequência, uma aprovação libera as próximas da mesma operação, naquela empresa, por 15 minutos. Para aprovar, o assistente mostra um link: você entra com o seu login e a página mostra quem pede, o quê, em qual empresa e o que acontece. Depois de aprovar, volte ao assistente e diga que aprovou. A permissão do próprio assistente continua valendo antes de cada alteração: a aprovação na Omie vem a mais. 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) Abra Plugins e procure Omie.
2) Clique em Instalar plugin.
3) Entre com o seu login do Omie e clique em Autorizar.
4) Na conversa, escreva @Omie antes da pergunta.
Passo a passo, inclusive para o Codex: 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.
Grok e Grok Bot
1) Em Conectores, clique em Novo conector e escolha Conector personalizado.
2) Informe o nome Omie, a URL https://api.omie.com.br/mcp e, na tela seguinte, o ID do Cliente da Omie. O Grok e o Grok Bot têm cada um o seu ID.
3) Clique em Salvar & Conectar, entre com o seu login do Omie e clique em Autorizar.
Todos os campos, com o ID do Cliente do Grok e o do Grok Bot: Conectando o Omie ao Grok.
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, por quem e de onde veio (tela, integração ou rotina), mesmo que ele tenha mudado de nome. Só para administradores.
🙋 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, na tela: limite de crédito de R$ 5.000 para R$ 15.000
• 18/09, por uma integração via API: e-mail de cobrança trocado
• 18/09, Ana, na tela: e-mail de cobrança trocado de volta
Ponto de atenção: uma integração trocou o e-mail de cobrança e a Ana desfez na tela no mesmo dia.
16 · O que foi excluído
Ver o que foi apagado, por quem, de onde veio (tela, integração ou rotina) e quando, com o conteúdo do registro. Só para administradores.
🙋 Você: O que foi excluído de clientes nesta semana?
🤖 Assistente (exemplo):
Nesta semana, 3 clientes foram excluídos:
• 06/10, Ana, na tela: Café da Esquina (CNPJ 11.222.333/0001-81)
• 06/10, Ana, na tela: Padaria Central
• 03/10, por uma integração via API: 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.
Permissão no assistente: o próprio assistente pode pedir permissão antes de usar o Omie. Nas configurações do conector dá para escolher o que ele faz sem perguntar. A aprovação na Omie não substitui essa permissão: ela vem a mais, só para o que pesa.
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. O Grok e o Grok Bot não usam o documento: entram com um client ID da Omie, digitado no conector personalizado.Desenvolvimento próprio: para integrar o MCP a um sistema seu, é preciso um client ID cadastrado pela Omie. Solicite pelo Suporte, num chamado do tipo API, com o nome do sistema, a empresa e o aplicativo Omie, os endereços de retorno, o responsável técnico (nome, e-mail e telefone) e uma frase do que o sistema faz. O passo a passo do login está em Conectando um sistema próprio ao MCP da Omie (client ID).
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_consultar: executa uma consulta numa empresa. Só lê: o que altera dados ou gera custo é recusado aqui.omie_consultar_em_varias: executa a mesma consulta em até 40 empresas de uma vez.omie_executar: executa uma operação de alteração numa empresa. Registrar pagamento ou recebimento, incluir, alterar e faturar executam direto. O que tira dinheiro da conta, o que gera custo, negativar e protestar devolvem sempre um link de aprovação na Omie. Excluir, cancelar e alterar devolvem o link só em sequência (a partir da sexta seguida na mesma empresa, em poucos minutos), e a aprovação libera as próximas da mesma operação naquela empresa por 15 minutos. Depois que a pessoa aprova, a mesma chamada, repetida, executa.omie_executar_em_varias: executa a mesma alteração em até 40 empresas de uma vez. Excluir, cancelar, alterar e o que sempre pede aprovação pedem uma aprovação para o lote. Pagamento e recebimento vão uma empresa por 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, num chamado do tipo API. O que informar e o passo a passo do login estão em Conectando um sistema próprio ao MCP da Omie (client ID).
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