Pigment offers Model Context Protocol (MCP) solutions that developers can use to access Pigment features securely through AI systems such as ChatGPT.
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.
Available Pigment tools
Tool | Description | Sample Prompt |
|---|---|---|
Get Applications | Returns the list of Applications in a given Workspace. Only Applications the authenticated user has access to are shown. | “List all my Pigment Applications.” |
Query Data | Returns data requested by the user. Available only for Metrics where AI Search is enabled. Learn more. | “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, Workspace 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
From November 26, 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.
2. In your AI system
Use the MCP Endpoint URL to connect third-party AI systems to Pigment tools. We currently support ChatGPT—support for other AI systems is in development.
ChatGPT
Create connector
You need Developer Mode enabled.
Go to Settings and select Apps & Connectors.
Select Add a new connector.
Name your connector (e.g. “Pigment”).
Paste your Pigment MCP Server URL and click Add.
Use connector
Start a new chat.
Click Add files & more then More and select your custom Pigment connector.
Go through the authentication workflow using your Pigment credentials.
Once connected, your Pigment tools appear in the list of available connectors.
Begin your conversation. Pigment tools can now be invoked directly in chat.
Claude (coming soon)
Create connector
You need Owner privileges.
Go to Admin settings and select the Connectors tab.
Select Add a custom connector.
Name your connector.
Paste your Pigment MCP Server URL and select Add.
Use connector
Go to Settings and select the Connectors tab
Click on Connect and go through the authentication workflow using your Pigment credentials.
Start a new chat and select Search & 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.
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.