Skip to content
Optima docs
AI assistants (MCP)

AI assistants (MCP)

Let an AI assistant such as Claude, ChatGPT, Claude Code or Cursor work with your Optima data, limited to what one API key allows.

Optima has an MCP server: a connector that AI assistants use to work with your data. MCP (Model Context Protocol) is the open standard that assistants such as Claude, ChatGPT, Claude Code and Cursor use to call outside systems. Once connected, an assistant can describe your data model, query profiles and events, run reports, look at segments, campaigns and journeys and how they perform, and draft new segments, campaigns and journeys for a person to review.

How access works

The assistant signs in with an API key you create in the console, and it can do exactly what that key can do: the key's roles, purpose grants, sensitive data (PII) level and environment all apply. The connector adds no permissions of its own and stores no customer data. Every read of personal data is recorded in the privacy audit log under the key, and for a connection made through a chat assistant the entry also names the connection.

Some actions are never available to an assistant, whatever its key's roles: sending messages, activating, pausing, approving, deleting, erasing, merging and exporting, plus managing keys, users, roles, connectors and channel providers. Anything an assistant creates is saved as a draft or inactive, for a person to review in the console. The full list is on Tools.

In this section

PageWhat you find there
Connect an assistantThe server address, a key of its own, and the steps for Claude, ChatGPT, Claude Code and Cursor
Permissions and privacyWhich roles unlock which tools, purposes, the sensitive data level and the audit trail
ToolsEvery tool an assistant can use, and what is never available
Example promptsQuestions and requests that work well, by role
TroubleshootingWhat an error or a missing tool means and how to fix it

The step-by-step guide Connect an AI assistant walks a tenant administrator through a first connection, and Connected AI apps describes the console tab that lists and revokes connections.

Note:

The MCP server is set up by your Optima operator. If the Connected AI apps tab under Settings → Access → API keys shows no server address, it is not available for your instance yet: ask your operator.

On this page