> ## Documentation Index
> Fetch the complete documentation index at: https://api.globalwebindex.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom connector

## Overview

The Spark Custom Connector can be easily integrated with ChatGPT on both the web and desktop versions.

There are two types of actors for this integration:

* **Workspace Admin**: adds the GWI connector integration for their organization and publishes it to the workspace.
* **Workspace Members**: connect to the GWI connector by using their GWI account.

Reference: [ChatGPT official documentation](https://help.openai.com/en/articles/12584461)

## How to use

Below you can find the detailed steps for both the **Workspace Admin** and **Workspace Member** roles in order to enable the connector in your workspace.

### Workspace Admin

1. Create a new custom connector by navigating to `Plugins -> Add -> Create custom MCP server`

2. Input the following information:

   * Name: `GWI Spark`
   * Connection (Server URL): `https://api.globalwebindex.com/v1/spark-api/openai/mcp`
   * Authentication: `OAuth`

   ![ChatGPT MCP admin setup](https://mintcdn.com/gwi-c45e8f9c/26X4w1kPDqgDXbEK/assets/images/chatgpt_custom/admin_setup.png?fit=max\&auto=format\&n=26X4w1kPDqgDXbEK\&q=85\&s=fb5c3af0567fd383fad06dcda1104c52)

3. Select `I understand and want to continue`, then click `Create as a plugin`

4. The connector will appear as a draft in `Workspace Settings -> Apps & Connectors -> Drafts`

5. Test the connector to ensure it works properly

6. Once testing is complete, click `Publish` to make it available to all workspace members

### Workspace Member

#### Web Version

1. Open a new chat in ChatGPT web
2. Click the **"+"** button (Add tools) in the chat interface
3. Locate the `GWI Spark` custom connector in the list and click `Connect`

   ![ChatGPT MCP member connect web](https://mintcdn.com/gwi-c45e8f9c/3HcAawbi_cvpxlEW/assets/images/chatgpt_custom/connect_web.png?fit=max\&auto=format\&n=3HcAawbi_cvpxlEW\&q=85\&s=848e5113c74d46c6214c145f656da53f)

#### Desktop Version

1. Go to `Settings -> Apps & Connectors`
2. Locate the `GWI Spark` custom connector in the list and click `Connect`

You'll be returned to ChatGPT and the `GWI Spark` connector will now be available in your chat sessions. The connector will appear with a "custom" label next to its name.

Once connected, ChatGPT will GWI's connector whenever your query indicates the use of GWI's data.

#### Authentication Process (Both Web & Desktop)

1. You'll be redirected to the GWI sign-in page. Use your GWI credentials to sign in. **If you don't have a GWI login, click Sign up to create one**

   ![ChatGPT MCP member signin](https://mintcdn.com/gwi-c45e8f9c/9OAn9n12OgESEeAq/assets/images/common/signin.png?fit=max\&auto=format\&n=9OAn9n12OgESEeAq\&q=85\&s=852362b8342610d593587111faad14b3)

2. Review the requested permissions and scopes, then click `Allow` to authorize the connection

## Troubleshooting

* **Connector not visible**: Ask your workspace admin to verify that the `GWI Spark` connector has been created and published.
* **Access denied during sign-in**: Confirm with your GWI contact that your email address or domain is enabled for your organization's Spark MCP access.
* **OAuth errors**: Clear your browser cache or try connecting from an incognito/private browsing window.

## Security & Management

* **Organization level**: Workspace admins can unpublish or remove the connector at any time. Admins can use RBAC to control which roles have access to the connector.
* **User level**: Individual users can disconnect from the connector in `Settings -> Apps & Connectors`.
* **Token management**: ChatGPT automatically handles OAuth token refresh and storage. No manual token management is required.
* **Action controls**: Admins can configure which specific actions the connector is allowed to perform.