O Grok, assistente de IA da xAI, 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, a conexão é pelo conector personalizado, com o ID do Cliente da Omie para o Grok, informado no passo a passo abaixo. Não é uma senha nem uma chave: ele só identifica o Grok para a Omie.
Os passos abaixo são do Grok no navegador, em grok.com.
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.
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".
Confirmação: antes de excluir, cancelar ou registrar um pagamento ou recebimento, o assistente pede a sua confirmação. No pagamento e no recebimento, ele confirma a empresa e os títulos. Se o seu pedido já disser o que fazer, ele entende o próprio pedido como a confirmação. Incluir, alterar e faturar acontecem na hora.
Desconectar: em Conectores, abra o Omie e remova.
Se algo der errado
"Não é possível autorizar o aplicativo": confira o ID do Cliente 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.