Custom connector

​

Overview

The GWI MCP server can be easily integrated with ChatGPT on both the web and desktop versions with GWI’s enterprise plan. 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

​

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 Workspace Settings -> Apps & Connectors -> Create

You might be prompted to enable Developer Mode. This step is required to create and publish custom connectors. Once you have created the connector, you can publish it within your organization’s workspace and then deactivate Developer Mode.

2. Input the following information:
   • Name: GWI Spark
   • URL: https://api.globalwebindex.com/v1/spark-api/openai/mcp
   
3. Configure the authentication mechanism (OAuth 2.0) and click Create
4. The connector will appear as a draft in Workspace Settings -> Apps & Connectors -> Drafts
5. Test the connector in developer mode 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

​

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
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.