---
title: "MCP Server"
slug: "mcp-server-1"
updated: 2026-10-27T11:05:34Z
published: 2026-10-27T11:05:34Z
canonical: "kb.pigment.com/mcp-server-1"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://kb.pigment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

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 access rights.

> [!TIP]
> 🎓 Pigment Academy
> 
> See also the Pigment Feature Spotlight videos on the MCP Server:
> 
> - [Connecting Your AI Applications to the Pigment MCP Server](https://academy.pigment.com/connecting-your-ai-applications-to-the-pigment-mcp-server/382461)
> - [Analyzing Your Pigment Data Through Your AI Applications](https://academy.pigment.com/analyzing-your-pigment-data-through-your-ai-applications/382462)

## Before you begin

The MCP Server is available when you [activate Pigment AI](/v1/docs/pigment-ai#set-up-pigment-ai). Check whether MCP Server is already available by following the [**Enable MCP server**](/v1/docs/mcp-server-1#permissions-and-access-rights) step-through below. If you cannot toggle on MCP (Model Context Protocol), it may not be activated in your Workspace.

### Configure data access rights

When a user accesses Pigment through the MCP server, they must authenticate with their Pigment account. All their existing permissions and access rights apply:

- They can only access Applications, Metrics, or data they already have access to in Pigment.
- No additional access rights or permissions are granted through MCP.

The **Use AI Agents** permission controls whether a user can use Pigment Agents and MCP tools in a given Application. Without this permission, all MCP tool calls on that Application fail.

> [!WARNING]
> ⚠️ **Important**
> 
> Before enabling MCP, verify that [access rights are properly configured](https://kb.pigment.com/docs/introduction-access-rights), especially on Blocks containing sensitive data.
> 
> To completely prevent a Block’s data from being accessible via MCP, [disable its “AI data access” setting](https://kb.pigment.com/docs/pigment-ai#ai-data-access).
> 
> To completely prevent an entire Application from being accessible via MCP, **remove the Use AI Agents permission to users**.

### **Enable MCP server**

> [!NOTE]
> **ℹ️** **Note**
> 
> You need the Role of Security Administrator, Workspace Administrator or Primary Owner to enable MCP.

1. Go to your Workspace and select **Settings** from the sidebar.
2. Select **Integrations** from the sidebar then the **MCP** tab in the main pane.
3. 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.

> [!WARNING]
> ⚠️ **Important**
> 
> Once MCP is enabled and a connector has been created with the MCP URL, all Workspace Members can connect to the Pigment MCP server.

## Track MCP connections

Connections through the MCP server are logged in the Audit Logs API. A `UserLoggedIn` event is logged when the user logs into Pigment, and a `CredentialUsed` event is logged on the Workspace the user accesses. For more information, see [Audit Logs API Events and Event Types](/v1/docs/audit-logs-api-event-types#model-context-protocol-mcp-event-type).

## Troubleshooting

If you encounter issues while connecting:

- **Authentication fails**:
  - In your Workspace settings, verify that the MCP server is enabled and that your MCP client is allowed.
  - Verify that you are using valid Pigment credentials, the correct MCP URL for the target Workspace, and that you have access to that Workspace.
- **Data leaks**: check that [data access rights](https://kb.pigment.com/docs/introduction-access-rights) are configured properly.
- **Data not visible**: confirm that [AI Data Access](/v1/docs/pigment-ai#ai-data-access-coming-soon) is enabled for the Metrics you want to query. Only Metrics with the following data types can be read via MCP: [Number, Integer, and Boolean](/v1/docs/data-types-in-pigment).
- **Modeling tools not visible**: in your Account settings, check that [advanced mode is enabled](https://kb.pigment.com/docs/supported-tools#advanced-mode).