Guides

Gemini Enterprise

Add airlock to Gemini Enterprise as a custom MCP server, with the exact value for every field of Google's form.

Gemini Enterprise can use your organization's Airlock MCP endpoint as a custom MCP server. Every tool call goes through your policies, approvals and audit trail, and each person signs in as themselves.

Airlock ships a built-in client ID for Gemini Enterprise, so there is nothing to register first and nothing that expires. Google's form asks for about ten values; this page gives the exact value for each one.

Before you start

  • A Google Cloud admin for your Gemini Enterprise instance. Adding an MCP server needs the Discovery Engine Editor role (roles/discoveryengine.editor) on the project.
  • Your organization's MCP URL. Open Settings → Account in the Control Room; your endpoint is shown there, ready to copy. It has the form https://mcp.air-lock.ai/org/<org-slug>.
  • Gemini Enterprise allowed under Allowed AI clients. It is on by default. An Airlock admin can check under Settings → Security → Allowed AI clients.

Add the MCP server

  1. In the Google Cloud console, open Gemini Enterprise.
  2. In the navigation menu, select Data stores, then Create data store.
  3. Search for the custom MCP server connector, select it, and choose to add an MCP server.
  4. Under authentication, choose OAuth 2.0 and fill in the fields below, in the order Google shows them.
FieldValue
Authentication methodOAuth 2.0
MCP Server URLhttps://mcp.air-lock.ai/org/<org-slug>, your endpoint from Settings → Account
Authorization URLhttps://control-room.air-lock.ai/mcp/authorize
Authorization URL ParametersLeave empty
Token URLhttps://mcp.air-lock.ai/token
Client ID1dbc425f-d57d-4418-a8ae-7e591922ac96
Client SecretLeave empty
Scopesopenid profile email
Enable PKCE SupportTicked
Use HTTP Basic AuthenticationUnticked (Google ticks it by default)

Check these before you continue:

  • Enable PKCE Support must be ticked. Airlock requires PKCE on every sign-in, and without it the Airlock page refuses the request.
  • Use HTTP Basic Authentication must be unticked. Google ticks it by default.
  • Client Secret must be empty. The Gemini Enterprise client has no secret, and Airlock refuses a sign-in that presents one.
  • Check the MCP Server URL character by character. Google does not let you change it after the data store is created; a mistyped URL means creating a new data store.

Copy the client ID whole. It is the same for every Airlock organization and it never changes.

Verify and finish

  1. Select Verify Auth. A pop-up opens on Airlock's sign-in page.
  2. Sign in with your Airlock account, using the same method you use for the Control Room.
  3. The consent screen names the app Gemini Enterprise and shows vertexaisearch.cloud.google.com as the return address. Approve the connection. The pop-up closes and Google shows the check as passed.
  4. Choose a location and a name for the data connector, and create it.

Verify Auth only proves the connection works; it does not connect anyone's account. Every person who uses the connector, the admin included, authorizes it once in the Gemini Enterprise web app (under Connectors, or when their first prompt needs Airlock) and signs in to Airlock there. Until the admin has done that, Reload custom actions cannot list Airlock's tools. Access tokens last 8 hours and refresh on their own, so people are not asked again during a normal working session.

Controlling who can connect

Gemini Enterprise appears under Settings → Security → Allowed AI clients with the same on/off switch and group scope as every other client. Turning it off stops new Gemini Enterprise sign-ins for the whole organization, even if Google's callback address is also in your approved redirect URIs; a group scope limits sign-ins to members of the selected groups. Both are checked at sign-in only, so people already connected keep their access until their session ends. See Controlling which AI clients may connect.

Troubleshooting

SymptomCause and fix
The Airlock page shows "Missing code_challenge parameter (PKCE required)"Enable PKCE Support is unticked. Tick it, save, and select Verify Auth again
You approve on Airlock, then Verify Auth fails with invalid_client ("This client has no client secret")A value was entered in Client Secret, or Use HTTP Basic Authentication is ticked. Clear the secret, untick the box, and verify again
The Airlock page shows "This AI client has been disabled for your organization"The Gemini Enterprise row is switched off under Settings → Security → Allowed AI clients. An Airlock admin can switch it back on
The Airlock page refuses with access_deniedGemini Enterprise is scoped to groups your account is not in. An Airlock admin can change the scope under Allowed AI clients, or you can sign in with an account that is in scope
Sign-in succeeds, but connecting fails with "Access denied to this organization"The account you signed in with does not belong to the organization in the MCP Server URL. Sign in with an account from that organization, or check the org slug in the URL
The Airlock page says the connection's registration is no longer recognizedThe client ID was mistyped. Copy it from this page again, whole
Reload custom actions fails with "unable to get tools: Server error '503 Service Unavailable'"Google could not reach the MCP Server URL, usually because it is mistyped. The URL cannot be edited, so create a new data store with https://mcp.air-lock.ai/org/<org-slug>
Reload custom actions fails with "The service is currently unavailable", and the Google Cloud logs say "Could not acquire the stored end-user credentials"The Google account you are using has not connected its own Airlock account yet. Open the Gemini Enterprise web app, authorize the Airlock connector, then reload again