Agents de AI
Conectar a Treeunfe no assistente de IA (login OAuth)
Para clientes Treeunfe que usam Cursor, Claude, Lovable ou outro app com MCP por URL. Você não precisa de chave de API:
só faz login no site da Treeunfe no navegador.
Em resumo
1. Coloque a URL do servidor MCP no app de IA.
2. Faça login no site Treeunfe quando o navegador abrir.
3. Escolha a empresa (organização) que o assistente pode usar.
O que você precisa
- Conta ativa na Treeunfe
- Acesso à organização desejada
- App de IA com suporte a servidor MCP remoto (URL)
URL para configurar
Nome do servidor (se o app pedir): Treeunfe
URL do MCP (copie exatamente assim, sem espaços no final):
https://mcp.treeunfe.com.br/operations/mcp
Não acrescente senha, chave nem nada depois do link.
Passo a passo (qualquer app)
1. Abra Configurações e depois MCP (ou Integrações / Servidores externos).
2. Adicione um servidor do tipo URL remota (não use instalação local).
3. Cole a URL: https://mcp.treeunfe.com.br/operations/mcp
4. Salve e ative o servidor Treeunfe.
5. Na primeira vez, o app abre o navegador em nfe.treeunfe.com.br — entre com sua conta.
6. Na tela de autorização, selecione a organização e confirme.
7. Volte ao app: o servidor deve aparecer conectado.
8. Teste no chat, por exemplo: "Liste meus clientes".
Cursor
1. Configurações → MCP → Adicionar servidor
2. Tipo: URL
3. URL: https://mcp.treeunfe.com.br/operations/mcp
4. Conectar → login no navegador → escolher organização
Se não conectar: desligue o servidor Treeunfe, ligue de novo e repita o login.
Claude Desktop ou Claude Code
1. Abra a configuração de MCP do Claude.
2. Inclua a URL (sem chave): https://mcp.treeunfe.com.br/operations/mcp
3. Reinicie o app e conclua o login no navegador.
Lovable
1. Settings → Integrations → MCP
2. Novo servidor, nome Treeunfe
3. URL: https://mcp.treeunfe.com.br/operations/mcp
4. Salvar e autorizar no browser quando solicitado
OpenAI (Codex ou conectores MCP)
Use a mesma URL se o produto oferecer MCP remoto com login OAuth. Se não houver OAuth no app, use Cursor ou Claude com
OAuth.
Perguntas frequentes
Preciso de API Key?
Não. Neste fluxo você usa apenas login OAuth (sua conta Treeunfe).
Homologação ou produção?
O ambiente fiscal é definido pela Treeunfe na autorização. Você não escolhe isso na URL.
Não conecta ou dá timeout
- Confira se a URL termina em /operations/mcp, sem nada a mais.
- Reconecte o MCP e faça login de novo.
- Feche e abra o app de IA.
Conectou, mas dá erro ao usar
- Verifique se escolheu a organização certa na autorização.
- Autorize novamente (reconectar o servidor).
É seguro?
O acesso fica no seu app, como uma sessão. Não compartilhe prints com códigos de login. Revogue pelo painel Treeunfe se
precisar.
Falar com o suporte
Informe:
- Qual app você usa (ex.: Cursor)
- Se o login no navegador terminou com sucesso
- A mensagem de erro (sem enviar senha nem token)
