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.
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.
| Client | Installation page |
|---|---|
| ChatGPT | Install ChatGPT |
| Claude | Install Claude |
| Claude Code | Install Claude Code |
| Visual Studio Code | Install Visual Studio Code |
| Codex | Install Codex |
| GitHub Copilot CLI | Install GitHub Copilot CLI |
Other clients cannot use CIMD at this time. For those, see Choose an Authorization Method.
Install a Client
- As a PagerDuty account admin, open the installation page for the client from the table above.
- 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:
- 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.
- GitHub Copilot CLI may ask for a client ID. If it does, enter
- Start the connection. The client opens the PagerDuty authorization page.
- 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.