|docs

For AI agents and assistants: visit https://docs.pagerduty.com/llms.txt for the index.

AI & Automation

MCP CIMD Clients

MCP clients that can connect to the PagerDuty MCP Server with Client ID Metadata Documents (CIMD), and how to install them in your account.

View as Markdown

The PagerDuty-hosted MCP server supports Client ID Metadata Documents (CIMD) for a set of MCP clients. With CIMD, the client identifies itself to PagerDuty with a URL that points to its own metadata. You do not need to create an OAuth client or copy a client ID and secret into the MCP client.

Supported Clients

CIMD is supported for the clients below. Each client has a PagerDuty app, which an admin must install in your account before users can connect.

ClientInstallation page
ChatGPTInstall ChatGPT
ClaudeInstall Claude
Claude CodeInstall Claude Code
Visual Studio CodeInstall Visual Studio Code
CodexInstall Codex
GitHub Copilot CLIInstall GitHub Copilot CLI

Other clients cannot use CIMD at this time. For those, see Choose an Authorization Method.

Install a Client

  1. As a PagerDuty account admin, open the installation page for the client from the table above.
  2. Review the app and install it in your account.

This is a one-time step for each client. If the app is not installed, the authorization flow fails for users in your account.

Connect

After the app is installed, each user can connect:

  1. Add the PagerDuty MCP server URL, https://mcp.pagerduty.com/mcp, to the MCP client. Do not provide a client ID or client secret.
    • GitHub Copilot CLI may ask for a client ID. If it does, enter https://github.com/copilot/cli/client-metadata.json. This starts the CIMD flow.
  2. Start the connection. The client opens the PagerDuty authorization page.
  3. Log in to PagerDuty and approve the request.

For client configuration examples, see Configure Your MCP Client.

Restrict Scopes

The CIMD apps request all scopes. If you want to limit a client to certain scopes, do not use CIMD. Instead, create your own Scoped OAuth client and provide its credentials to the MCP client, as described in PagerDuty MCP Server.