O ChatGPT, assistente de IA da OpenAI, consegue se conectar ao Omie pelo MCP oficial da Omie. Depois de conectado, você consulta e opera o Omie conversando com ele.
💡 Dica Omie: Antes de conectar, vale ler Conectando o Omie a um assistente de IA (MCP), com o que o MCP faz, a segurança e quem pode usar.
Antes de começar
O MCP usa as APIs do Omie. Empresas com mensalidade precisam ter o pacote de APIs contratado; no plano gratuito ele funciona com limite de uso por dia.
O Omie está no diretório de Plugins do ChatGPT.
O ChatGPT tem dois modos: Chat, para conversar, e Work, que é o Codex, o agente da OpenAI para tarefas no computador. Os dois se conectam ao Omie, cada um pelo seu caminho.
Em contas de empresa, o administrador pode precisar liberar o plugin do Omie antes.
Conectando no modo Chat
1) No ChatGPT, abra Plugins e procure por Omie (ou use o link direto do plugin).
2) Clique no + ao lado do Omie (ou abra o Omie e clique em Instalar plugin).
3) Faça o login com o mesmo e-mail e senha que você usa no Omie, confira na tela de autorização o que o ChatGPT vai poder fazer e clique em Autorizar.
4) Numa conversa nova, escreva @Omie e pergunte: "quais são as minhas empresas no Omie?"
💡 Dica Omie: Já tinha conectado o Omie pelo Modo de desenvolvedor? Remova aquele e instale o do diretório, para não ficar com dois Omie.
Conectando no modo Work (Codex)
1) Abra Configurações e entre em Plug-ins. Em Adicionar, escolha Adicionar servidor MCP.
2) Informe o nome omie e a URL https://api.omie.com.br/mcp. Deixe o token e os cabeçalhos em branco e clique em Salvar.
3) Na aba MCPs, ao lado do omie, escolha Documento de metadados do ID do cliente (CIMD) e clique em Autenticar. Faça o login com o seu e-mail e senha do Omie e autorize.
O que muda no ChatGPT
Uma ferramenta por operação: por regra da OpenAI, no modo Chat cada operação do Omie aparece como uma ferramenta própria. Estão lá as mais usadas: financeiro (contas a pagar e a receber, baixa de pagamento e de recebimento, lançamentos em conta corrente, DRE e contas por vencimento), vendas (incluir e alterar pedido, faturar, consultar notas fiscais), serviços (ordens de serviço e contratos), compras, estoque, CRM e cadastros (incluir e alterar cliente, produto e categoria). Operações menos usadas ficam disponíveis no Claude e nas ferramentas de desenvolvimento.
CPF: também por regra da OpenAI, o ChatGPT não pede nem mostra CPF. Filtros e cadastros aceitam só CNPJ, e nas respostas o CPF aparece como CPF oculto. Para cadastrar uma pessoa física com CPF, complete o cadastro direto no Omie.
Dicas de uso
Diga a empresa: se você tem acesso a mais de uma empresa, diga em qual delas quer consultar ou alterar.
Aprovação do ChatGPT: antes de cadastrar, alterar ou excluir, o ChatGPT pede a sua aprovação, com as opções Permitir uma vez, Sempre permitir ou Negar. Depois de permitir, as alterações seguintes da mesma conversa podem acontecer sem uma nova aprovação. A aprovação na Omie não substitui essa permissão: ela vem a mais, só para o que pesa.
Aprovação na Omie: registrar pagamento ou recebimento (baixa), incluir, alterar e faturar acontecem na hora, sem aprovação. 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. O ChatGPT 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 ChatGPT e diga que aprovou.
Desconectar: em Configurações, Plugins, abra o Omie e desconecte ou remova.
Se algo der errado
Erro interno ao usar o Omie (às vezes com o código -32603), depois de dias funcionando: a conexão precisa ser refeita. Em Configurações, Plugins, abra o Omie, clique em Reconectar e entre de novo com o seu login do Omie.
O ChatGPT diz que uma operação não está habilitada ou não existe: a operação não está entre as ferramentas do Omie no ChatGPT. Uma ferramenta nova pode levar até um dia para aparecer; nesse caso, em Configurações, Plugins, abra o Omie e clique em Reconectar. Se continuar, faça a operação direto no Omie ou pelo Claude e avise o Suporte, para avaliarmos incluir.
A tela de login abre já em outra conta do Omie: saia do Omie no navegador antes de reconectar, senão a autorização usa a conta que estava aberta.
O ChatGPT não usa o Omie na conversa: escreva @Omie no começo da pergunta.