Configuration

Pipeline Doctor is available through the MCPize marketplace.

GitHub Token

Pipeline Doctor needs a GitHub Personal Access Token to read your workflows and logs.

Classic PAT: enable the repo scope (covers Actions access for private repositories).

Fine-grained PAT: grant these repository permissions:

• Actions: Read-only
• Contents: Read-only
• Metadata: Read-only (selected automatically)

Provide the token via the USER_GITHUB_TOKEN header (MCPize convention). MCP clients support ${GITHUB_TOKEN} env var expansion so the token is never stored in config files.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "pipeline-doctor": {
      "type": "http",
      "url": "https://pipeline-doctor.mcpize.run",
      "headers": {
        "USER_GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Claude Code

{
  "mcpServers": {
    "pipeline-doctor": {
      "type": "http",
      "url": "https://pipeline-doctor.mcpize.run",
      "headers": {
        "USER_GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "pipeline-doctor": {
      "type": "http",
      "url": "https://pipeline-doctor.mcpize.run",
      "headers": {
        "USER_GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project root:

{
  "servers": {
    "pipeline-doctor": {
      "type": "http",
      "url": "https://pipeline-doctor.mcpize.run",
      "headers": {
        "USER_GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Default Repository

When using Pipeline Doctor, the MCP client infers the repository from your working directory context — no server-side configuration needed. All tools also accept an explicit repo parameter in owner/repo format.

Support

• Contact: contact@rajibdey.dev