Connecting a chat app

Manual — AI agents · chapter 4 of 7

Apps such as Claude, ChatGPT and Copilot connect by authorization: you enter the server address, the app opens an H2O page and you approve the access with your own user. No key is copied by hand.

1. In the app, add a custom connector or MCP server and enter the Server address copied from the AI agents card.
2. The app opens the Connect to H2O page. Type the address you use to sign in to H2O, for example yourcompany.atg.com.br, and click Continue.
3. Sign in to H2O with your user, if you are not signed in yet.
4. On the Authorize AI agent screen, check the app name and the return address. If the app asked to write, tick the option only if you want to allow it.
5. Click Authorize. You return to the app, already connected.

Warning

The Connect to H2O page never asks for a password. If you received one of these links without connecting an app yourself, close the page.

What the authorization grants	Detail
Validity	30 days. After that the app asks for a new authorization.
Reach	Only the agent server. The access granted cannot be used to call the rest of the H2O API.
Reading	Always included.
Writing	Only if the app asks for it and you tick it on the authorization screen.

Viewing and cancelling an access

Each authorization appears under System › API Keys named Agente: followed by the app name, with its expiry and last-used date. To cancel, deactivate or revoke the key: the app loses access at once.