Activation required. AI access management must be enabled for your tenant before you can use it. To get started, contact the C1 support team for a walkthrough.
What you’ll do
Setup spans two products and three roles. Plan for a Google Cloud administrator with organization-level permissions to be available.Before you begin
Gather these before you start.- AI access management must be enabled for your tenant. See Enable AI access management.
- A Google Cloud project with a Gemini Enterprise app already created.
-
The gcloud CLI, authenticated with
gcloud auth login. -
A Google Cloud administrator who can grant
roles/orgpolicy.policyAdminat the organization or folder level. Project Owner is not sufficient for the organization policy change in Allow custom MCP data connectors. -
The
betacomponent, which the optional gateway commands need:
Required roles
Grant these roles on the Google Cloud project.Get your C1 MCP server URL
Every C1 tenant has its own MCP server URL and its own OAuth endpoints.1
In C1, open your user profile menu and select AI & API > AI connections.
2
Copy the MCP server URL at the top of the page. It looks like this:
Check your region requirements
Your Gemini Enterprise app location determines every other region you pick. Find it at the top of the Apps page in the Google Cloud console, next to Current location.Agent Registry does not support the
us and eu multi-region locations. Use a specific region such as us-central1, or use global. These regions matter only if you follow Optional: Publish through Agent Registry. When regions do not line up, the server never appears in the data store list and no error explains why.Enable the Google Cloud APIs
Enable the APIs that back Gemini Enterprise data connectors and their tools.1
In the Google Cloud console, go to APIs & Services > Library.
2
Search for each API by name and select Enable.
connectors.googleapis.com, integrations.googleapis.com, and secretmanager.googleapis.com back the tool actions a data connector exposes. Google’s setup documentation does not list them, and tool discovery fails without them.Allow custom MCP data connectors
Google Cloud blocks custom MCP data connectors by default. Creating the data store fails at the final step until an administrator turns the constraint off:policy.yaml:
enforce: false, and your project can create custom MCP data connectors.
Allow several minutes for the policy to propagate. Until it does, the console returns the same denial message, so a failure right after you apply the policy does not mean the policy is wrong. Setting this policy requires
roles/orgpolicy.policyAdmin at the organization or folder level.<your-tenant>-mcp.conductor.one and <your-tenant>.conductor.one. Use hostnames only, not full URLs.
Get the OAuth client ID
Gemini Enterprise authenticates each user to C1 with the OAuth 2.0 authorization code flow. It needs an OAuth client that already exists, because it does not register itself the way Claude Code and Cursor do. C1 publishes a client metadata document for Gemini Enterprise. Use its URL as the client ID:Create the data store
Connect the C1 MCP gateway to your Gemini Enterprise app.1
In the Google Cloud console, open Gemini Enterprise and select your app.
2
Select Connected data stores > New data store.
3
In Select a data source, search for
Custom MCP.4
Select Add MCP server on the Custom MCP Server card.
5
For Select your authentication method, choose OAuth 2.0.
6
Complete the authentication fields:
7
Select Verify Auth. A window opens for you to sign in through your identity provider and authorize the connection.
8
Select Continue.
9
Enter a Data connector name.
10
Select Create.
- Clear Use HTTP Basic Authentication. It is selected by default. Leaving it selected sends the client ID and secret in an
Authorizationheader, which does not work for a client that has no secret. - Leave Client Secret empty. The field is optional even though Client ID, Authorization URL, and Token URL are marked required.
- Include
offline_accessin the scopes. Without it C1 issues no refresh token, and users reauthorize every time their access token expires. - Set Authorization URL Parameters. C1 binds tokens to a specific resource, so the
resourceparameter scopes the issued token to your MCP endpoint.
Enable the tools
Gemini Enterprise imports every tool in a disabled state. Turn on the ones you want available to users.Wait for the connector state to reach Active before you start. The reload fails while the connector is still creating.
1
Open the data store and select the Actions tab.
2
Select Reload custom actions. Gemini Enterprise queries your MCP server for its current tool list.
3
Select the tools to expose.
4
Select Enable actions.
Verify the Gemini Enterprise connection
Tool discovery runs before authentication is proven, so seeing tools listed does not confirm your credentials are correct. You confirm the setup only when a user successfully calls a C1 tool.1
Open your Gemini Enterprise app as an end user and ask a question that needs a C1 tool, such as “Who has access to Salesforce?”
2
Authorize the connection when prompted. Sign in through your identity provider and approve.
3
As that same user in C1, open the user profile menu and select AI & API > AI connections. The Gemini Enterprise connection appears. Administrators can see connections for everyone under AI access management > AI clients.
4
In C1, go to Settings > System log and filter on
activity_name starts with "mcp_". Tool calls appear as mcp_tool_call events attributed to the individual user.Optional: Publish through Agent Registry
Agent Registry gives your organization a catalog of approved MCP servers, and Agent Gateway applies policy to agent traffic. Neither is required to connect Gemini Enterprise to C1, and the setup in the previous sections works without them. Add them when you want the C1 gateway to appear in a shared catalog alongside your other approved servers.Gemini Enterprise supports only Agent-to-Anywhere (egress) mode. Google’s documentation states that traffic between Gemini Enterprise agents and their data connectors does not trigger Agent Gateway policy enforcement, so treat this path as catalog publishing rather than traffic governance.
Enable the additional APIs
Agent Registry and Agent Gateway need networking and platform APIs beyond the ones you already enabled.iap.googleapis.com is missing from Google’s published list of required APIs, and the authorization extension fails without it.Register the server
Describe the tools you want catalogued in atoolspec.json file. Each tool needs name, description, and inputSchema, and the file is limited to 10 KB.
inputSchema is required on every tool, even though Google’s published example omits it. Without it, registration fails with invalid MCP tool spec content: tools.0: inputSchema is required.Create the gateway
The gateway routes and governs outbound agent traffic for the registry you just populated. Save this asgateway.yaml:
The
registries value must start with //agentregistry.googleapis.com/. A plain projects/.../locations/... path is rejected with does not match the pattern. There is no separate registry resource to create, because the registry is implicit for each project and location.Bind the gateway to your app
Creating the gateway is not enough. Each Gemini Enterprise app must point at it explicitly. Until you do this, the data store list shows a Configure Agent Gateway prompt and no registered servers appear.1
In your Gemini Enterprise app, go to Security > Configuration.
2
Under Agent Gateway configuration, enter the gateway resource name:
3
Select Save.
Troubleshoot Gemini Enterprise connection errors
Gemini Enterprise integration limitations
These constraints come from Gemini Enterprise and Google Cloud.- Gemini Enterprise supports egress (Agent-to-Anywhere) mode only.
- MCP servers must use StreamableHTTP transport. Server-sent events are not supported.
- VPC Service Controls and Private Service Connect are not supported for custom MCP data stores.
- The MCP server needs a certificate from a publicly trusted authority. Self-signed certificates are rejected.
- A gateway supports at most 5,000 registered resources.
Frequently asked questions about connecting Gemini Enterprise
Why is the Client Secret field empty?
Why is the Client Secret field empty?
The client is a public OAuth client with no secret. Client ID Metadata Document clients cannot use shared secrets, so C1 ignores the field. Security comes from the authorization code flow with PKCE, which you turn on with Enable PKCE Support.
Do I need Agent Gateway?
Do I need Agent Gateway?
No. Connecting Gemini Enterprise to C1 works without it. Agent Gateway and Agent Registry publish the C1 gateway in a shared catalog of approved servers. Google’s documentation notes that Gemini Enterprise data connector traffic does not trigger Agent Gateway policy enforcement, so adding it does not change how tool calls are governed. C1 governs the tool calls.
How do I cut off access in a hurry?
How do I cut off access in a hurry?
In C1, open AI access management > AI clients, find the Gemini Enterprise client, and use the kill switch. It revokes all tokens for that client immediately. See Manage AI clients.
Can I see what tools Gemini Enterprise called?
Can I see what tools Gemini Enterprise called?
Yes. C1 records every MCP session and tool call in the system log. Filter on
activity_name starts with "mcp_" to see sessions and calls, each attributed to the user who made them. See Audit AI tool usage.Pages related to governing AI tool access
These pages cover the C1 side of the integration.- Manage AI clients covers lifecycle states, the kill switch, and allowed client types.
- Connect to the C1 MCP covers the same gateway from desktop AI assistants.
- AI access management covers the access profiles and toolsets that decide what each user’s tools can do.
- Audit AI tool usage covers reviewing MCP activity in the system log.