Thematic MCP Server

The Thematic MCP server lets AI assistants such as Claude, ChatGPT, Copilot and Cursor work with your customer feedback through natural conversation. Once connected, you can ask questions like "What are the top themes in our NPS survey?" or "Compare this quarter to last quarter", and, where your organization allows it, improve your theme structure in the same conversation.

Server URL

This depends on the region your Thematic account is initialized in. This ensures that data remains in that region up till the point it is used by the calling LLM.

Prerequisites

• A Thematic account (password or SSO login)
• Access to at least one organization with feedback data

Feature groups

The tools the assistant can use are organized into feature groups, so your organization and you can decide what an assistant is able to do.

Each feature group's article describes the tools it includes. You don't need to know them: ask for what you want and the assistant chooses the right tools.

Turning feature groups on and off

A feature group works only when it is on in both places: your organization's setting and your own choice.

For your organization (administrators)

Organization settings are changed in the Thematic portal, not through the MCP. You need the manage workspace permission.

1. Log in to the Thematic client portal.
2. Open Manage workspace from the main menu and select MCP access.
3. Use the switches:
   • Allow MCP access (on by default) lets members explore the organization's feedback from an AI assistant. Turn it off to stop AI assistants reading the organization's feedback.
   • Allow theme editing (off by default) lets members who already have theme editing permissions review, change and publish themes from an AI assistant.
4. Click Save.

Changes can take up to 5 minutes to reach AI assistants that are already connected. See Manage workspace for the rest of this area.

For yourself

When you connect the Thematic MCP, after signing in you choose which feature groups you want enabled. Your choice belongs to you rather than to an organization, and applies to every assistant you connect.

To change it later, ask your assistant, for example "turn on Theme Editing in Thematic". The change applies from the next request. You don't need to reconnect.

Connecting your agents to Thematic

1. Add the Thematic MCP to your agent using the server URL for your region.
2. Sign in with your Thematic email, then your password or SSO.
3. Choose which feature groups you want enabled.
4. Back in your agent, ask it to use the organization you want to work in, for example "switch to the Acme organization in Thematic". You can switch organization or region at any time the same way.

After that, your session lasts for up to one year. How you add the server depends on your agent:

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

Troubleshooting

"Not enabled for the organization"

• Your organization has that feature group switched off. An administrator can turn it on under Manage workspace > MCP access.

"The user switched it off"

• Your organization allows the feature group but you didn't choose it. Ask your assistant to turn it on.

"Does not have permission"

• Your role doesn't allow that action on that survey or lens. For theme editing you need theme editing permissions; see Permissions Glossary and ask whoever manages your Thematic users.

A setting change hasn't taken effect

• Organization changes can take up to 5 minutes to reach connected assistants.

Authentication fails or loops

• Clear your browser cookies for your region's MCP server address (from the table above) and try again.
• If you use SSO, make sure your identity provider session is active.

Tools don't appear after connecting

• Start a new conversation. Tools are loaded at conversation start.
• Check that the server shows as "Connected" in your client's MCP settings.

"Organization not found" or no organization selected

• Ask the assistant: "List my available organizations in Thematic", then ask it to switch to the one you want.

Session expired

• Sessions last up to one year. If yours expires, disconnect and reconnect the server to sign in again.

If something behaves in a way this article doesn't explain, ask your assistant to send feedback to Thematic.