O Grok, assistente de IA da xAI (no navegador e no Grok Bot), 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.
Tópicos do Artigo:
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.
No Grok e no Grok Bot, a conexão é pelo conector personalizado, com o ID do Cliente da Omie, informado no passo a passo abaixo. Cada um tem o seu ID. Não é uma senha nem uma chave: ele só identifica o assistente para a Omie.
Os passos abaixo são do Grok no navegador, em grok.com. O Grok Bot tem a sua parte logo depois.
Conectando o Omie ao Grok
1) No Grok, abra Conectores, clique em Novo conector e escolha Conector personalizado.
2) Em Nome, informe Omie. Em URL do servidor, informe https://api.omie.com.br/mcp. Clique em Adicionar conector.
3) Na tela Credenciais OAuth necessárias, preencha assim:
ID do Cliente:
065e2d38129a9b54657456b39f68812cSegredo do Cliente: deixe em branco
Endpoint de Autorização:
https://app.omie.com.br/login/oauth2/Endpoint do Token:
https://app.omie.com.br/login/oauth2/validate/Escopos: deixe em branco
Método de Autenticação de Token: nenhum (somente PKCE, recomendado)
4) Clique em Salvar & Conectar. Na janela da Omie, 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 Grok vai poder fazer e clique em Autorizar.
5) Pronto! Numa conversa nova, pergunte: "quais são as minhas empresas no Omie?"
💡 Confira a conta antes de autorizar. Se o Omie já estiver aberto no navegador, a autorização usa essa conta. A tela mostra o usuário em Autorizando como. Se não for a conta certa, saia do Omie no navegador e conecte de novo.
Conectando o Omie ao Grok Bot
O Grok Bot é o agente do Grok que funciona na estrutura do Cursor. Para o Omie é o mesmo assistente, mas ele tem o próprio ID do Cliente.
Siga os passos 1 a 5 acima, trocando só o ID do Cliente:
ID do Cliente:
0a58e96aa6095f21e0a51e918442d506Segredo do Cliente e Escopos: deixe em branco
Endpoints: os mesmos do Grok
Método de Autenticação de Token: nenhum (somente PKCE), se o Grok Bot perguntar
💡 Um ID para cada um. O ID do Grok não funciona no Grok Bot, e o do Grok Bot não funciona no Grok.
Dicas de uso
Diga a empresa: se você tem acesso a mais de uma empresa, diga em qual delas quer consultar ou alterar, ou peça "em todas as minhas empresas".
Aprovação na Omie: registrar pagamento ou recebimento (baixa), incluir, alterar e faturar acontecem na hora, sem aprovação, mesmo em sequência. 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 e cancelar pedem aprovação só quando vêm em sequência (mais de 20 seguidas 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 uma hora. O Grok 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 Grok e diga que aprovou.
Permissão no assistente: se o Grok ou o Grok Bot pedir permissão antes de alterar algo no Omie, ela continua valendo. A aprovação na Omie não substitui essa permissão: ela vem a mais, só para o que pesa.
Apps criados no Grok: o Grok também cria apps, painéis e páginas, e eles podem ficar abertos na internet para qualquer pessoa. Se pedir um com dados do Omie, confira que ele está privado antes de usar e não compartilhe o link.
Desconectar: em Conectores, abra o Omie e remova.
Se algo der errado
"Não é possível autorizar o aplicativo": confira o ID do Cliente (o do Grok ou o do Grok Bot, conforme o que você usa) e os dois endpoints, sem espaço no começo nem no fim, e o método nenhum (somente PKCE). Depois clique em Salvar & Conectar de novo.
Apareceram empresas que não são as suas: a autorização usou outra conta do Omie aberta no navegador. Remova o conector, saia do Omie no navegador e conecte de novo.
