Connecting Thematic MCP using Tokens

This page details connection instructions for common clients that require creating a bearer token, also known as 'header based authentication'.

There are three ways of connecting MCP servers:

1. OAuth using dynamic client registration. This is the simplest and most modern. Claude, ChatGPT and Cursor all use this
2. OAuth using explicit client registation. Gemini Enterprise requires this
3. Bearer tokens. Needed for when you can't auth in a browser and only have terminal access.

More information about the Thematic MCP Server can be found here. If the client you use isn't listed here, you might find it supports OAuth flows.

The region to server url table is reproduced here for convenience. It is vital you use the correct region when setting up the connection to ensure you can find your organization and data after connecting.

Creating a token

This section is common to all clients and is expected to be completed first.

Step 1: To create a token you can use with MCP you first will need to create a client.

Details you will need to enter:

• Name: This can be anything but will be used to identify the client in future
• Redirect URI: This can be any url. Feel free to use https://getthematic.com

On the next screen you do NOT need to copy the id and secret if this will only be used for generating tokens.

Step 2: Generate the token

The screen you land on after acknowledging the client was created will now have your client listed with a 'Generate Access token' button.

This will require you to sign in again, as we are now creating an access token linked to your account and permissions in Thematic.

After logging in you will be presented with your access token. You must copy this into a safe place as you will be using it in the connection instructions below.

Client specific instructions

Gemini CLI

Gemni CLI supports connecting MCP servers through commands in the CLI. It will require generating

First copy the below into a place you can edit and replace:

• <SERVER_URL>: the regional url you want to connect to
• <ACCESS_TOKEN>: the token you copied from the steps above

{
"mcpServers": {
  "thematic": {
    "httpUrl": "<SERVER_URL>",
    "headers": {
      "Authorization": "Bearer <ACCESS_TOKEN>"
    }
  }
 }
}

Copy this into .gemini/settings.json  in the project you want to connect Thematic to. Note: if this file already exists you will need to pick just the relevant part. Unfortunately gemini-cli has a bug that means this can't be done just using a command.

Testing

1. Start gemini
2. Type /mcp list This should confirm if Thematic MCP is connected and should show 'Ready' after a few seconds
3. Type What are my organizations in Thematic  which should respond with a list of the available organizations