sentry-mcp — Claude Code MCP server: Sentry errors in chat
Wires Sentry into your coding assistant so you can dig into errors, traces and performance without leaving the editor. Handy when a bug needs chasing.
claude mcp add --transport http sentry-mcp https://mcp.sentry.dev/mcpWhat sentry-mcp does
The server sits between your assistant and the Sentry API. It targets debugging workflows where a human stays in the loop: the assistant pulls errors, traces and logs, and you decide what to do with them. In Claude it ships as a plugin that adds a sentry-mcp subagent, which picks up questions about errors and performance on its own.
Two transports are available. The remote one connects to https://mcp.sentry.dev/mcp with no local process. The stdio transport runs through npx @sentry/mcp-server@latest and mainly serves self-hosted Sentry: add --host, and for internal deployments without TLS also --insecure-http. You need a Sentry user auth token with scopes for reading org and projects, writing projects and teams, plus event:write.
The search tools for errors, traces and logs turn a plain-language query into Sentry's query syntax using an LLM. Without a configured provider those tools stay unavailable; everything else keeps working. Set the provider in EMBEDDED_AGENT_PROVIDER, since picking one from API keys alone is deprecated. Point --host at a non-sentry.io host and the seer skill drops out of the default set, because Seer isn't part of self-hosted Sentry; opt back in with --skills=inspect,seer.
What it helps with
- read a Sentry stack trace without opening the web UI
- find which errors fire most often in production
- inspect a slow request trace and its timings
- tie a crash to a specific release or environment
- pull the open issue list for a project
Example prompts for the agent
- Show me the latest errors from my Sentry project
- Find the trace for this request and tell me where it's slow
- Which Sentry issues grew after the last release?
How to install sentry-mcp
1Platform CLI: remote server
claude mcp add --transport http sentry-mcp https://mcp.sentry.dev/mcp2Platform CLI
claude mcp add --env SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> --transport stdio mcp-server -- npx -y @sentry/mcp-serverReplace <…> with your own values
1Platform CLI: remote server
codex mcp add mcp-server --url https://mcp.sentry.dev/mcp2Platform CLI
codex mcp add mcp-server --env SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> -- npx -y @sentry/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.sentry.dev/mcp"
}
}
}{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@sentry/mcp-server"
],
"env": {
"SENTRY_ACCESS_TOKEN": "<SENTRY_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.sentry.dev/mcp"
}
}
}{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sentry/mcp-server"
],
"env": {
"SENTRY_ACCESS_TOKEN": "<SENTRY_ACCESS_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http mcp-server https://mcp.sentry.dev/mcp2Platform CLI
gemini mcp add -e SENTRY_ACCESS_TOKEN=<SENTRY_ACCESS_TOKEN> mcp-server npx -y @sentry/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about sentry-mcp
How do I install sentry-mcp in Claude Code?
Add the marketplace with claude plugin marketplace add getsentry/sentry-mcp, then install the plugin with claude plugin install sentry-mcp@sentry-mcp. That gives you the sentry-mcp subagent.
What does sentry-mcp do?
It gives your assistant access to Sentry errors, issues, traces and logs. In Claude, Sentry questions are delegated to the sentry-mcp subagent automatically.
Why are the error and log search tools missing?
They need an LLM provider; without one those tools are unavailable while the rest still work. Set the provider in EMBEDDED_AGENT_PROVIDER.
