
How to add Sentry MCP Server (remote) to Claude Desktop
Official hosted Sentry MCP for investigating issues, errors, traces and performance data. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 15, 2026 ยท 1.1kโ ยท http ยท oauth ยท official
Claude Desktop config for Sentry MCP Server (remote)
Connect client to https://mcp.sentry.dev/mcp and complete OAuth{
"mcpServers": {
"sentry-mcp-server-remote": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.sentry.dev/mcp"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
Setup steps
- 1Open Claude Desktop โ Settings โ Developer โ Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Sentry MCP Server (remote) config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm Sentry MCP Server (remote)'s tools appear under the ๐ tools menu.
Before you start
- A Sentry account (SaaS or self-hosted) with access to the org/projects you want to query
- For the hosted server: an MCP client that supports remote MCP over HTTP with OAuth (the OAuth flow runs in your browser)
- For the local stdio variant: Node.js plus a Sentry User Auth Token with scopes such as org:read, project:read/write, team:read/write, and event:write
- Seer must be enabled on your Sentry org to use the AI root-cause analysis tool
What Sentry MCP Server (remote) can do in Claude Desktop
find_organizationsList the Sentry organizations the user can access
find_projectsList projects within an organization
get_issue_detailsFetch full details for a specific issue by ID or URL
search_issuesNatural-language search that resolves to Sentry issue queries
search_eventsNatural-language search over events/errors/spans
get_trace_detailsRetrieve a distributed trace by ID
analyze_issue_with_seerRun Sentry's Seer agent for AI root-cause analysis on an issue
update_issueChange an issue's status or assignment
Security
The OAuth grant exposes your Sentry org's error and trace data, which can contain PII captured in events; review scopes before approving. For the stdio fallback, treat SENTRY_ACCESS_TOKEN as a secret.
Sentry MCP Server (remote) + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Sentry MCP Server (remote) config there under the "mcpServers" key and restart the client.
Is Sentry MCP Server (remote) safe to use with Claude Desktop?
The OAuth grant exposes your Sentry org's error and trace data, which can contain PII captured in events; review scopes before approving. For the stdio fallback, treat SENTRY_ACCESS_TOKEN as a secret.
Is the Sentry MCP server official?
Yes. It is built and maintained by Sentry (getsentry/sentry-mcp) and is licensed Apache-2.0.
Do I need an API key for the hosted server?
No. The hosted server at mcp.sentry.dev uses OAuth, so you authenticate in the browser rather than pasting a token. A user auth token is only needed for the local stdio variant.
Remote vs local: which should I use?
Use the hosted remote server for the simplest setup and OAuth auth. Use the local @sentry/mcp-server stdio variant if your client lacks remote-OAuth support or you want a self-contained process.