@sentry/mcp-server
The Sentry MCP server for stdio clients, as a single file with no runtime
dependencies. Works with sentry.io and self-hosted Sentry.
Prefer sentry mcp. The Sentry CLI runs the
same server as sentry mcp, using your CLI login, so the MCP config needs
no token:
curl https://cli.sentry.dev/install -fsS | bash
sentry auth login
claude mcp add sentry -- sentry mcp
Other clients take {"command": "sentry", "args": ["mcp"]}. See the
sentry mcp docs and
https://mcp.sentry.dev/?transport=cli. This package remains for clients
that launch the server through npx.
{
"command": "npx",
"args": ["-y", "@sentry/mcp-server@latest"]
}
Requires Node.js 22.15 or later.
Authentication
-
npx -y @sentry/mcp-server auth login signs in once. The login is shared
with the sentry CLI, so an existing
sentry auth login works too.
-
To use a token instead, set SENTRY_AUTH_TOKEN in the client's env. It
wins over a stored login:
{
"command": "npx",
"args": ["-y", "@sentry/mcp-server@latest"],
"env": {
"SENTRY_AUTH_TOKEN": "sntryu_..."
}
}
-
--access-token / SENTRY_ACCESS_TOKEN are deprecated. They still work, as
SENTRY_AUTH_TOKEN, and print a warning on stderr.
-
Each server process uses one account. The package runs the CLI's own
auth commands, so npx -y @sentry/mcp-server auth status|list|switch|logout
manages the same login.
-
npx -y @sentry/mcp-server cli defaults and cli fix are the CLI's own
commands too: they set the defaults (such as ca-cert for a corporate TLS
proxy) and repair the local database the server shares with the CLI.
Options
Starting the server is the default command, so npx -y @sentry/mcp-server
and npx -y @sentry/mcp-server mcp are the same. Run
npx -y @sentry/mcp-server mcp --help for the flags and environment
variables. For self-hosted Sentry, set SENTRY_HOST / SENTRY_URL (with
SENTRY_AUTH_TOKEN, only these scope the token to your server). See
stdio authentication.
Development
The source lives in packages/cli: packages/cli/src/mcp-server.ts runs the
CLI's runner with an application of four commands, mcp, auth, cli
(defaults and fix only), and help (packages/cli/src/mcp-server-app.ts).
pnpm run bundle builds dist/sentry-mcp.cjs from it, and
pnpm run test:bundle smoke-tests the result.