Connect common MCP Clients

Prev Next

Use the MCP Endpoint URL to connect the following third-party AI systems to Pigment tools. Select the tool to open the instructions for each.

ChatGPT

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/*

Claude

For Claude’s official documentation, see here.

Create connector

  1. Go to the Claude web interface.

  2. You need Owner privileges.

  3. Go to Admin settings and select the Connectors tab.

  4. Select Add custom connector at the bottom of the section.

  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

Claude Code

For Claude Code's official documentation, see here.

Option 1: Via Claude.ai (recommended)

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 2: Directly in Claude Code

You can add the Pigment MCP server directly from your terminal:

claude mcp add --transport http --callback-port 4567 pigment [YOUR-MCP-SERVER-URL]

Because Claude Code runs locally, it uses a local callback URL for OAuth. You must specify a fixed callback port using --callback-port, otherwise Claude Code assigns a random port on each connection, which will not match the whitelisted redirect URI.

You will need to whitelist this redirect URI for your Workspace. Submit a whitelisting request to Pigment Support with:

  • Your Workspace name or ID.

  • The redirect URI (e.g. http://localhost:4567/callback in this example).

See Connect a custom application below for more information on whitelisting requests. Once the redirect URI has been whitelisted, run claude in your terminal and the authentication flow starts automatically when Pigment tools are invoked.

Cursor

ℹ️ Note

Ensure you are using the latest version of Cursor.

For Cursor’s official documentation, see here.

In Cursor, go to Settings > Cursor Settings > Tools & MCP.

Click on New MCP Server and in the mcp.json file, paste your Pigment MCP Server URL where you see [YOUR-MCP-SERVER-URL] as follows:

{
  "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.


Redirect URI whitelisted by Pigment: cursor://anysphere.cursor-mcp/oauth/callback

Microsoft Copilot

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/*

Mistral

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

Miscellaneous

For other providers, follow their respective documentation:

Provider

Redirect URI whitelisted by Pigment

Dust

https://dust.tt/oauth/mcp/finalize

https://eu.dust.tt/oauth/mcp/finalize

n8n

https://oauth.n8n.cloud/oauth2/callback

Zapier

https://zapier.com/dashboard/auth/oauth/return/App222157CLIAPI/

If you would like to connect another AI system to Pigment’s MCP Server, follow the instructions in Connect custom MCP Client.