Whitepaper
Mindbreeze InSpire in OpenAI ChatGPT

Introduction

This white paper explains how to create a ChatGPT app that connects to a Mindbreeze InSpire MCP server within your organization using a ChatGPT Business account. To add your Mindbreeze InSpire MCP server to ChatGPT as an MCP app, developer mode must be enabled for your ChatGPT account.

Configuration

Preparation

As a first step, please enable “Developer mode” for your account. For this, navigate to the account settings menu and then open Settings / Security and login. Please set here the “Developer mode” switch to active.

Create a New App

In the Plugins entry of the main menu, after development mode is enabled, you can create a new app by clicking on “Create app”.

This will lead you to setting up the MCP app parameter. You can choose here a custom icon for your ChatGPT app and also set the “name” and “description” parameter for your new app. To be able to continue with the setup you have to enable access to custom MCP server.

Set the connection parameter to the following URL:

, where {{mindbreeze_inspire_client_url}} is the base URL of the Mindbreeze Client Service that is acting as the MCP server endpoint.

Authentication

If the Mindbreeze InSpire MCP server requires authentication, the ChatGPT app allows OAuth settings to be configured manually. In this current example we are assuming that an OAuth identity provider was configured (for example a Microsoft Entra ID application) for login and we also set up JWT authentication using this identity provider, as described in JWT Authentication.

If these prerequisites are fulfilled, we can continue by setting the “Advanced OAuth settings”. If authorization server discovery with protected resource metadata is set up in the Mindbreeze InSpire Client Service (for details, see the above documentation), then all settings should be prefilled excepting the client ID and client secret of the OAuth identity provider. Please check if Microsoft Entra ID is used that the Resource field is set to empty. If it is the case, remove any pre-filled value.

If no Protected Resource Metadata is configured, in Advanced OAuth settings, set the following parameters to manually configure authentication:

1. Set the “Registration method” to “User-Defined OAuth Client”

1. Set the Client ID and Client Secret fields with the Client ID / Client secret of the configured OAuth identity provider.

1. Add the scope defined in the OAuth identity provider to “Default Scopes”.

1. Add “Auth URL” and “Token URL” of the configured identity provider. In case of a Microsoft Entra ID application this is https://login.microsoftonline.com/{{tenant_id}}/oauth2/v2.0/authorize, respective https://login.microsoftonline.com/{{tenant_id}}/oauth2/v2.0/token.

Attention: It is possible that adding the app’s Callback URL shown on this configuration page (f. ex. https://chatgpt.com/connector/oauth/0MOErz4Ddzrj), has to be added to the Identity Provider application’s valid redirect URL-s, like in case of Microsoft Entra ID:

1. Attention: Make sure the Resource field is empty and only scopes are specified if you are using Microsoft Entra ID as authorization server.

1. Click on “Create” to finalize the process.

1. After creating the app, a login dialog is shown where the current user can sign in with the configured identity provider and test the ChatGPT app. After successful login, please click on “Refresh” on the app’s settings to load the tools provided by the MCP server.

Testing the ChatGPT App

The app is now available for testing for the account that created it. Please try adding the app in the chat and test it with a question:

Submitting the question should result in calling the Mindbreeze InSpire app for retrieving the answer. The called tool (search) and the request and response should be visible in the output.

If the tests have been successful, the app is ready for publishing in your organization’s app gallery.

Publishing the ChatGPT App

Attention: Publishing the app will make it available for all users in the organization in the app gallery.

The ChatGPT app, after its creation is finished, should be shown in the current user’s “Personal” tab on the Plugins configuration (Main menu / Plugins).

To request publishing, please open the app’s settings with the “Manage” menu entry and then in the ‘…’ menu, click on “Publish”.

This will lead you to the workspace settings, where the app can be published for the organization’s app gallery after reviewing the potential risks.

If these actions completed successfully, the app should be available for all users in the organization.