Connect common MCP Clients

For ChatGPT’s official documentation, see here.

Create connector

1. Go to the ChatGPT web interface.

2. Ensure that Developer Mode is enabled under Advanced Settings.

3. Go to Settings and select Apps.

4. Select Create app.

5. Name and describe your connector (e.g. “Pigment”).

6. Paste your Pigment MCP Endpoint URL in the MCP Server URL field.

7. Select OAuth in the Authentication field.

8. Leave the fields OAuth Client ID and OAuth Client Secret empty, as Pigment handles OAuth automatically.

9. Check the “I understand and want to continue” box.

10. Select Create.

11. 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 in your Workspace.

1. Go to Workplace Settings and select Connectors.

2. Select Drafts and then the Publish button.

3. Review safety warnings.

Once published, connectors appear in the Workspace’s approved connectors list and in users’ Apps & Connectors settings in ChatGPT.

ℹ️ Note

You do not need to have Developer Mode enabled to use the ChatGPT connector. You only need it to create the connector.

If you ask your ChatGPT admin to create a connector for your Pigment Workspace and publish it to you, you'll be able to use it even though you can't use Developer Mode.

If necessary, they can choose to publish the connector only to selected users of your organization, through ChatGPT Admin Settings.

Use connector

1. Start a new chat.

2. Select Add files & more then More and select your custom Pigment connector.

3. Begin your conversation. Pigment tools can now be invoked directly in chat.

Redirect URI whitelisted by Pigment: https://chatgpt.com/connector/oauth/*

For Claude’s official documentation, see here.

Create connector

1. Go to the Claude web interface.

2. You need Owner privileges.

3. Go to Customize and select the Connectors tab.

4. Select Add custom connector

5. Name your connector.

6. Paste your Pigment MCP Server URL in the Remote MCP server URL field.

7. Leave the optional fields OAuth Client ID and OAuth Client Secret empty. Pigment handles OAuth automatically.

8. Select Add.

Your connector should now be created and available for all users.

Use connector

1. Go to Personal settings and select the Connectors tab.

2. For your Pigment connector, select Connect and go through the authentication workflow using your Pigment credentials.

3. Start a new chat and select Search and tools to verify that your Pigment connector is active and tools are available.

4. Begin your conversation. Pigment tools can now be invoked directly in chat.

Redirect URIs whitelisted by Pigment:

https://claude.ai/api/mcp/auth_callback

https://claude.com/api/mcp/auth_callback

For Claude Code's official documentation, see here.

Option 1: Install plugin (recommended)

The Pigment plugin for Claude Code bundles the MCP configuration with domain-knowledge Skills. For detailed documentation, see here.

/plugin marketplace add gopigment/ai-plugins

/plugin install pigment@pigment

Option 2: Add in Claude.ai

If you have already created and connected the Pigment connector in the Claude web interface (see the Claude section above), it is automatically available in Claude Code. Simply run /mcp in your Claude Code session to verify the connector is active.

Option 3: Add in Claude Code CLI

You can also add the Pigment MCP server directly from Claude Code CLI. Replace https://pigment.app/api/mcp/public/{id} with your own MCP URL.

claude mcp add --transport http pigment https://pigment.app/api/mcp/public/{id}

ℹ️ Note

Ensure you are using the latest version of Cursor.

For Cursor’s official documentation, see here.

Option 1: Install plugin (recommended)

1. Go to Cursor plugins

2. Import https://github.com/gopigment/ai-plugins as a marketplace

3. Add Pigment plugin to Cursor from the plugins page, or open Cursor and run /add-plugin pigment in a new chat

For detailed documentation, see here.

{
  "mcpServers": {
    "pigment": {
      "type": "http",
      "url": "https://pigment.app/api/mcp/public/{id}"
    }
  }
}

After adding the MCP server, go back to the Settings page and select Connect to start the authentication flow.

When successfully connected, you see the connected MCP tool with tools enabled.

Option 3: Add on Cursor.com

1. Go to Integration & MCP.

2. Select Add MCP.

3. Name your connector, paste your Pigment MCP Server URL, and leave the other fields empty.

4. Select Add MCP.

Redirect URI whitelisted by Pigment:

cursor://anysphere.cursor-mcp/oauth/callback

https://www.cursor.com/agents/mcp/oauth/callback

For Microsoft’s official documentation, see here.

Create connector

1. Go to the Copilot Studio web interface.

2. Select Agents from the menu.

3. Select an existing Agent or create a new one.

4. Select Tools, Add a tool and then Model Context Protocol.

5. Name and describe your MCP Server, paste your MCP Server URL, select OAuth 2.0 and Dynamic Discovery for authentication, and click Create.

6. Select Create a new connection.

Your Agent should now be able to connect to Pigment’s MCP Server.

Use connector

You can create a tool once and reuse it across multiple Copilot Agents.

Redirect URI whitelisted by Pigment: https://global.consent.azure-apim.net/redirect/*

For Mistral’s official documentation, see here.

Create connector

1. Go to the Mistral Le Chat web interface.

2. Select Intelligence then Connectors in the menu.

3. Select Add Connector then Custom MCP Connector.

4. Name your connector.

5. Paste your Pigment MCP Server URL in the Connector Server field.

6. Select OAuth 2.1 as authentication method.

7. Select Connect.

8. Complete the authentication workflow using your Pigment credentials.

Your connector should now be created and available for all users of your organization.

Use connector

1. Start a new chat, select Enable tools and select your Pigment connector.

2. Begin your conversation. Pigment tools can now be invoked directly in chat

Redirect URI whitelisted by Pigment: https://callback.mistral.ai/v1/integrations_auth/oauth2_callback