Pigment offers Model Context Protocol (MCP) solutions that Pigment users can leverage to access Pigment features securely through AI systems such as ChatGPT, Claude and Mistral.
What is MCP?
MCP is an open standard that allows AI systems to connect to external tools and data sources in a controlled, secure, and structured way.
By exposing Pigment capabilities via MCP, you enable AI systems to query data and retrieve insights directly from Pigment—all while respecting user permissions and Workspace security policies.
🎓 Pigment Academy
See also the Pigment Feature Spotlight videos on the MCP Server:
Available Pigment tools
Tool | Description | Sample Prompt |
|---|---|---|
GetApplications | Returns the list of Applications in a given Workspace. Only Applications the authenticated user has access to are shown. | “List all my Pigment Applications.” |
FindAiMetrics | Returns the list of Metrics searchable via MCP Server in a given Application. These are the Metrics where AI is enabled in Pigment. See the official documentation for more information. | “Show me Metrics available for analysis in the Financial Planning application.” |
QueryData | Returns data requested by the user. Available only for Metrics where AI is enabled. | “Show me Revenue.” “Show me Sales for top 10 products by Year.” |
How to connect to the Pigment MCP Server
Before you begin
⚠️ Important
You need the Role and access rights of Security Administrator, or Primary Owner to set up MCP.
Your Workspace needs to have AI activated. For this, submit a Support ticket following the guidance on our Pigment AI page, choosing “Data, Documentation Assistant and MCP Server” under AI Feature request.
Ensure "AI Search" is activated on key Metrics which you want MCP to read from.
1. In Pigment
Request activation by submitting a Support ticket, selecting MCP Server.
Once you have been notified in the ticket that MCP has been activated, go to your Workspace and select Settings from the sidebar.
Select Integrations from the sidebar then the MCP tab in the main pane.
Toggle on MCP (Model Context Protocol).
A unique MCP Endpoint URL is generated, which you will need to connect a third-party AI system to Pigment. If you plan to connect multiple Workspaces, each must have its own MCP Endpoint URL and connector. Test & Deploy environments also need one MCP Endpoint URL and connector each.
2. In your AI system
Use the MCP Endpoint URL to connect third-party AI systems to Pigment tools. We currently support ChatGPT, Claude and Mistral—support for other AI systems is in development.
ChatGPT
For ChatGPT’s official documentation, see here.
Create connector
Go to the ChatGPT web interface.
Ensure that Developer Mode is enabled under Advanced Settings.
Go to Settings and select Apps.
Select Create app.
Name and describe your connector (e.g. “Pigment”).
Paste your Pigment MCP Endpoint URL in the MCP Server URL field.
Select OAuth in the Authentication field.
Leave the fields OAuth Client ID and OAuth Client Secret empty, as Pigment handles OAuth automatically.
Check the “I understand and want to continue” box.
Select Create.
Complete the authentication workflow using your Pigment credentials.
Your connector should now be created.
Publish connector
If you are a ChatGPT Admin or Owner, you can publish the connector so it becomes available to all users of your workspace.
Go to Workplace Settings and select Connectors.
Select Drafts and then the Publish button.
Review safety warnings.
Once published, connectors appear in the workspace’s approved connectors list and in users’ Apps & Connectors settings in ChatGPT.
Use connector
Start a new chat.
Select Add files & more then More and select your custom Pigment connector.
Begin your conversation. Pigment tools can now be invoked directly in chat.
Claude
For Claude’s official documentation, see here.
Create connector
Go to the Claude web interface.
You need Owner privileges.
Go to Admin settings and select the Connectors tab.
Select Add custom connector at the bottom of the section.
Name your connector.
Paste your Pigment MCP Server URL in the Remote MCP server URL field.
Leave the optional fields OAuth Client ID and OAuth Client Secret empty. Pigment handles OAuth automatically.
Select Add.
Your connector should now be created and available for all users.
Use connector
Go to Personal settings and select the Connectors tab.
For your Pigment connector, select Connect and go through the authentication workflow using your Pigment credentials.
Start a new chat and select Search and tools to verify that your Pigment connector is active and tools are available.
Begin your conversation. Pigment tools can now be invoked directly in chat.
Mistral
For Mistral’s official documentation, see here.
Create connector
Go to the Mistral Le Chat web interface.
Select Intelligence then Connectors in the menu.
Select Add Connector then Custom MCP Connector.
Name your connector.
Paste your Pigment MCP Server URL in the Connector Server field.
Select OAuth 2.1 as authentication method.
Select Connect.
Complete the authentication workflow using your Pigment credentials.
Your connector should now be created and available for all users of your organization.
Use connector
Start a new chat, select Enable tools and select your Pigment connector.
Begin your conversation. Pigment tools can now be invoked directly in chat.
Permissions and access rights
When a user accesses Pigment via an MCP connector, they must authenticate with their Pigment account.
All existing Pigment permissions and access rights apply:
Users can only access Applications, Metrics, or data they already have access to in Pigment.
No additional access is granted through MCP.
Troubleshooting
If you encounter issues while connecting:
Connection fails: verify that your MCP URL is active and the MCP Server is enabled in your Pigment Workspace.
Authentication errors: make sure you have the correct role and are using valid Pigment credentials.
Tools not visible: confirm that AI Search is enabled for the Metrics you want to query.
Multiple Workspaces: check that you’re using the correct MCP URL for the Workspace you’re trying to access.