// Debug MCP servers with the official MCP Inspector UI and CLI. Use when an MCP server will not connect, auth fails, tools/resources/prompts are missing, or a tool call needs to be reproduced outside Codex/Claude.
Create a new Cloudflare app in this repo with the expected package scripts, Doppler shape, and CI workflow wiring.
Query and analyze Cloudflare Workers traces through the general Cloudflare API MCP server. Use when diagnosing Workers traces, distributed tracing spans, observability events, subrequest chains, or when an agent needs Cloudflare trace data programmatically.
Drizzle ORM database migration workflow for packages that still use Drizzle (agents, example). Do NOT use for apps/os — that app uses sqlfu/D1.
Monitoring workflow for architect: Cloudflare Worker checks, task updates, and Slack escalation.
Debug failures in the Cloudflare OS worker using the Cloudflare MCP server. Use when diagnosing 500s, missing logs, or request-level regressions in production or preview.
PostHog alert responder workflow with required Slack deep-links and escalation rules.
| name | debug-mcp-server |
| description | Debug MCP servers with the official MCP Inspector UI and CLI. Use when an MCP server will not connect, auth fails, tools/resources/prompts are missing, or a tool call needs to be reproduced outside Codex/Claude. |
Use the official MCP Inspector first. It supports stdio, SSE, and Streamable HTTP,
and has both a browser UI and a scriptable --cli mode.
Docs:
List tools on a local stdio server:
npx -y @modelcontextprotocol/inspector --cli node build/index.js --method tools/list
List tools on a remote Streamable HTTP server:
npx -y @modelcontextprotocol/inspector --cli https://example.com/mcp \
--transport http \
--method tools/list
Pass headers without committing secrets:
doppler run --project os --config preview_2 -- sh -lc '
npx -y @modelcontextprotocol/inspector --cli https://mcp.cloudflare.com/mcp \
--transport http \
--method tools/list \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
'
Call a tool:
npx -y @modelcontextprotocol/inspector --cli node build/index.js \
--method tools/call \
--tool-name mytool \
--tool-arg key=value \
--tool-arg 'options={"format":"json"}'
Run:
npx -y @modelcontextprotocol/inspector
Open the printed localhost URL with its proxy token. Do not disable proxy auth. Use the UI to inspect initialization, auth, tools/resources/prompts, schemas, request history, errors, and notifications.
tools/list before calling a tool.tools/list works but a tool fails, call the smallest failing tool input.Use the general Cloudflare API MCP server at https://mcp.cloudflare.com/mcp.
Avoid configuring a separate product-specific observability endpoint.
Cloudflare's execute tool accepts account_id as a tool argument. Do not append
it to the MCP URL. If a bearer token is rejected before initialization because it
has access to multiple accounts, use normal MCP OAuth login or a narrower token.