Conectar o MCP Omie ao seu assistente de IA

O MCP Omie é um servidor MCP remoto (Model Context Protocol): ele funciona com assistentes de IA que aceitam conectores MCP. Os passos são os mesmos em qualquer assistente compatível — mudam só os nomes dos menus; abaixo está onde fica cada coisa nos mais usados.

O que o assistente precisa aceitar

Conector (servidor) MCP remoto, por um endereço https:// — não só servidores locais;
login por OAuth, com campos para informar o ID e o segredo do cliente OAuth (Client ID e Client Secret).

Por segurança, o login só devolve o acesso a assistentes que o seu escritório liberou. Quem administra o cliente escolhe na área do cliente, em Assistentes de IA, entre os mais usados — Claude, ChatGPT, VS Code / GitHub Copilot, Cursor, Claude Code, Gemini CLI — e pode liberar outro informando o endereço de retorno (redirect URI) que ele mostra. Escritórios novos começam com o Claude liberado.

1. Pegue os dados do conector

Entre na área do cliente com a conta Google do e-mail que o seu escritório convidou. Em Conectar ao assistente de IA estão os três dados, cada um com um botão para copiar:

URL do conector — normalmente https://mcp-omie.damasiormoura.org/mcp;
ID do cliente OAuth (Client ID);
Segredo do cliente OAuth (Client Secret) — trate como senha: não publique nem envie por chat aberto.

2. Adicione o conector no assistente

Abra as configurações de conectores (ou de servidores MCP) do seu assistente.
Escolha adicionar um conector personalizado / servidor MCP remoto.
Dê um nome (por exemplo, Omie) e cole a URL do conector.
Nas opções de autenticação (OAuth), cole o ID e o segredo do cliente OAuth.
Salve e mande conectar.

Em cada assistente

Claude: Em claude.ai → Configurações → Conectores → Adicionar conector personalizado: dê um nome e cole a URL; o ID e o segredo ficam em Configurações avançadas. O conector aparece também no Claude Desktop e nos apps.
ChatGPT: No ChatGPT → Configurações → Apps, ative o modo desenvolvedor e crie um app: cole a URL e escolha autenticação OAuth; em Configurações avançadas, escolha cliente OAuth definido pelo usuário (User-defined OAuth client) e cole o ID e o segredo.
VS Code / GitHub Copilot: Na paleta de comandos, MCP: Add Server → HTTP, cole a URL e dê um nome. Quando o VS Code pedir, informe o ID e depois o segredo do cliente.
Cursor: Em Settings → MCP, abra o mcp.json e acrescente o servidor abaixo, colando o segredo no lugar indicado.
Claude Code: No terminal, rode o comando abaixo; o segredo é pedido em seguida, sem aparecer na tela. Depois, em uma sessão, use /mcp para entrar.
Gemini CLI: No settings.json do Gemini CLI, acrescente o servidor abaixo, colando o segredo no lugar indicado. Depois, em uma sessão, use /mcp auth omie para entrar.

Para Cursor, Claude Code e Gemini CLI, a área do cliente mostra o comando ou a configuração já com a sua URL e o seu ID, pronta para copiar. Nos planos Team e Enterprise do Claude, pode ser preciso que um administrador da organização adicione o conector antes. Os nomes dos menus podem variar entre versões.

3. Entre e autorize

O assistente abre a tela de login do MCP Omie: escolha Google e use a conta do e-mail convidado.
Confirme o acesso que o conector pede (só nome e e-mail).
De volta ao assistente, o conector aparece como conectado.

4. Use numa conversa

Numa conversa nova, ative o conector nas ferramentas do assistente e pergunte, por exemplo: "Liste as empresas do Omie que eu acesso" ou "O que vence esta semana em todas as empresas?". Operações que movimentam dinheiro ou emitem documento fiscal mostram uma prévia e só acontecem depois que você confirma.

Se algo der errado

"Autorização falhou" ao conectar: remova o conector e adicione de novo, conferindo o ID e o segredo. No Claude, o botão Reconectar reaproveita os dados antigos e não resolve.
Erro de endereço de retorno (redirect_uri) na tela de login: o seu assistente ainda não foi liberado — peça a quem administra o seu escritório que o libere em Assistentes de IA.
"Este conector não foi configurado com o ID do cliente OAuth de…": o conector usa o ID e o segredo de outro escritório. Cada escritório tem os seus — remova o conector e adicione de novo com os dados da área do cliente do escritório certo.
"Não está cadastrado em nenhum cliente": o e-mail com que você entrou não foi convidado. Peça a quem administra o seu escritório que convide exatamente esse e-mail.
Outras dúvidas: [email protected].