Skip to main content

Connecting Agent Spark to Gemini Enterprise

Agent Spark is your human insights analyst. You can access Agent Spark directly through our platform or via your favorite LLM tool.

This article covers how to connect Agent Spark to Gemini Enterprise. For more information on how to access Agent Spark in other ways, including via other LLM tools, see our article on how to access Agent Spark.

The connector for Gemini Enterprise is compatible with all our syndicated data sets depending on your subscription.

If you’re a Free user you can only use Agent Spark via our platform.

Note: Custom connectors are only available on the following Gemini Enterprise plans - Standard, Plus, Pay-as-you-go and Frontline plans (not Business).

How to connect Agent Spark to Gemini Enterprise

Getting started is simple - just follow the steps below:

  1. One-time setup by your IT or Development teams (Workspace admin)

  2. Configuration by the Workspace users/members (End user)

Below are the steps for both IT or Development teams and Workspace users/members to enable the connector in your workspace. Click on each to expand.

For IT or Development teams (Required first)

Before you start

Gemini Enterprise doesn’t support Dynamic Client Registration (DCR) yet, so we’ll set up your credentials manually. To get started, email [email protected] . If you have platform access, you can also open a ticket through live chat and select MCP Connector.

How to use the guide

  1. Open Google’s setup guide side by side with this page.

  2. Complete each step in the Gemini Enterprise console from Production values through Connect the data store to your Gemini app.

  3. When a form asks for URLs or OAuth settings, copy from the Production values table below.

  4. Screenshots show the UI at each step.

Admin setup (one-time)

​Production values

Field

Value

MCP Server URL

https://api.globalwebindex.com/v2/spark-api/mcp

Authorization URL

https://auth.globalwebindex.com/oauth2/authorize

Authorization URL Parameters

(leave blank)

Token URL

https://auth.globalwebindex.com/oauth2/token

Client ID

Contact GWI support for your Client ID

Client Secret

Contact GWI support for your Client Secret

Enable PKCE Support

Off (unchecked)

Scopes

openid profile email offline_access

Authentication

OAuth 2.0

​Setup walkthrough

Follow the steps below in the Gemini Enterprise console. They mirror Google’s setup guide; when a form asks for URLs or OAuth settings, use the Production values table above.

​Create the custom MCP server data store

Maps to Google: Create the custom MCP server data store.

1. Data stores list

  1. Gemini Enterprise → Data stores

  2. Confirm Current location (for example eu) - edit if your org requires another multi-region

  3. Click + Create data store

Gemini Enterprise data stores list

​

2. Select source

  1. Search sources → type Custom MCP Server

  2. On the Custom MCP Server card → Add MCP server

Custom MCP Server source card

​

3. Authentication — OAuth 2.0

  1. Select OAuth 2.0

  2. Fill the form from Production values (table above).

MCP OAuth form

  1. If Enable PKCE Support appears → leave unchecked

  2. Click Verify Auth

  3. A GWI sign-in popup opens → sign in with your work account

  4. Expect Successfully logged in. → click Continue on that success panel

  5. Back on the MCP form → Continue (wizard)

GWI sign-in during Verify Auth
Verify Auth success

​

4. Configure your data connector → Create

  1. Multi-region / Location - pick the location for this connector (for example eu). Cannot change later.

  2. Data connector name - the name you’ll use to recognize the connector (for example GWI Spark MCP)

  3. Tag (optional) - stable identifier across versions; immutable once set

  4. Other optional fields (sensitive-data policy, encryption) - leave unless your org requires them

  5. Click Create

  6. Wait until the data store state is Active (Creating → Active)

Configure data connector

​

5. Wait for Active, then enable actions

Maps to Google: Enable actions

After Create, open the data store. Connector state may show Creating briefly - wait until Active.

Data store creating

If a yellow banner says actions are disabled, go to Actions:

  1. Left nav (or banner) → Actions

  2. Reload custom actions (reauth / tools/list if prompted)

  3. Select the actions (tools) to enable - Google limit: up to 100 at a time

  4. Enable actions

Reload custom actions
Enable actions (v2beta tools)

Connect the data store to your Gemini app

Creating the data store is not enough - it must be linked to a Gemini Enterprise app.

Maps to Google: Connect a data store to an app.

​6a. Create an app if you don’t have one

  1. Gemini Enterprise → Apps → + Create app

  2. Set display name and location (same multi-region as the data store if possible, for example eu) → Create

Apps list — Create app
Create app form

​

6b. Connect the existing Spark MCP data store

  1. On Apps, find your app → under Connected data stores click view

  2. Add existing data stores

  3. In Connect an existing data store, select GWI Spark MCP (Custom MCP Server) → Connect

  4. You should see GWI Spark MCP · Custom MCP Server · Active

Apps row — view connected data stores
Add existing data stores
Connect existing data store picker
Connected GWI Spark MCP active

​

For Workspace users/members (After IT setup is completed)

If you’re an end user and your Gemini Enterprise admin has already completed the setup, use your own GWI account in the steps below.

​Authorize and activate the connector (first use)

Maps to Google: User authorization

Required before tools work in chat.

  1. Open the Gemini Enterprise web app (URL from the app overview)

  2. In the prompt bar, open the connector/tools control (near +)

  3. Find GWI Spark MCP - if it shows Authorise / Authorize, complete GWI sign-in

  4. Switch the connector toggle on (activate)

Authorize and activate connector

Without authorize and toggle-on, the connector can appear but tools won’t run.

​

Using the connector

Maps to Google: Authorize your connected services

Once connected, authorized, and toggled on:

  1. In Gemini Enterprise chat, make sure GWI Spark MCP is active (connector/tools panel)

  2. Ask in natural language and name the connector if helpful, for example: Using GWI Spark MCP, give me insights about pet owners and their shopping habits.

  3. The assistant should call enabled actions and answer with sources

Note: Please be aware that GWI provides the connectors only, and your use of your LLM to access Agent Spark is your own responsibility. You should check that you have the required rights and permissions to use your LLM with our connector. We require you not to allow your LLM to train on our data. We always recommend that you use paid or enterprise LLM accounts.

Troubleshooting

  • Connector not visible: Ask your IT or Development teams (Workspace Admin) to verify that the Agent Spark connector has been created and published.

  • Access denied during sign-in: Make sure you have an active GWI account. If you're unsure, check with your GWI contact to confirm.

  • Login Errors: Check in with your GWI contact to confirm that your GWI account has been set up correctly.

  • OAuth errors: Clear your browser cache or try connecting from an incognito/private browsing window.

Did this answer your question?