Skip to content
AquillaAquilla Help

Connect ChatGPT or another AI assistant

You can connect an AI assistant such as ChatGPT to Aquilla by signing in with your Aquilla account. You never copy a token. The assistant asks Aquilla for access, you choose what it may reach, and you can cut it off at any time.

This works with ChatGPT and with any MCP host that supports the same sign-in.

Connecting

Section titled “Connecting”
  1. In ChatGPT, add Aquilla (from the directory listing, or in Developer Mode with Aquilla’s MCP URL).
  2. ChatGPT sends you to Aquilla. Sign in with your Aquilla account.
  3. On the consent page, tick the organizations the assistant may reach, then choose Allow access.
  4. Aquilla returns you to ChatGPT. In the desktop app, the return opens in your system browser instead of inside the Aquilla window. Ask it things like “write a status report on my Aquilla projects”.

The consent page is titled “Connect {client} to Aquilla”, with the assistant’s name in place of {client}, for example “Connect ChatGPT to Aquilla”. If the assistant gives no name, it reads “Connect an app to Aquilla”. It says:

This app wants to use Aquilla’s agent tools on your behalf. Choose what it may reach.

Under Organizations, each organization has a checkbox, and All current organizations ticks them all. Allow access stays disabled until you tick at least one. Deny access turns the request down. If no organization qualifies, the page says “You do not have the required access to an available organization.” The page also tells you who you are signed in as (“Signed in as {username}”), and that “Access doesn’t expire. You can see when it was last used and revoke it from API tokens at any time.”

What the assistant can do

Section titled “What the assistant can do”
  • Which organizations are listed. Only organizations where you have maintainer access or higher appear. Access includes their current and future projects.
  • New organizations. Organizations you join later require a new connection.
  • No Ask or Act choice. The page says: “This app can create and update content in the organizations you select, within your current permissions.” The assistant acts as Act, but only as far as your own role allows. Reads run freely, and project creation keeps its usual approval rules.
  • Validation stays human. The page says: “Saving a change does not mark it as human-validated. Reviewers validate each translation version on its own.”

Checking who is asking

Section titled “Checking who is asking”

The page shows: “Request from {host}. The app supplies its own name; Aquilla checked only the domain.” The name comes from the app, so trust the domain, not the title. If the request is not one you started, choose Deny access.

If you see “This connection request is not valid. Start the connection again from the app you came from.”, go back to the assistant and begin the connection again.

Disconnecting

Section titled “Disconnecting”

The connection appears in Preferences → API tokens under the app’s name, with a connected app badge. It does not expire. Revoke it there to disconnect the assistant, which then has to ask again before it can reach Aquilla. For the rest of that page, see Approving agent changes.