You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/product/sentry-mcp/index.mdx
+48-18Lines changed: 48 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,8 +5,10 @@ description: "Enable secure connectivity between Sentry issues and debugging dat
5
5
---
6
6
7
7
<Alert>
8
-
The Sentry MCP Server has been released for production, however MCP is a developing technology and changes should be expected. There will be bugs. Please reach out on
9
-
[GitHub](https://github.com/getsentry/sentry-mcp/issues) if you have any feedback or concerns.
8
+
The Sentry MCP Server has been released for production, however MCP is a
9
+
developing technology and changes should be expected. There will be bugs.
10
+
Please reach out on [GitHub](https://github.com/getsentry/sentry-mcp/issues)
11
+
if you have any feedback or concerns.
10
12
</Alert>
11
13
12
14
## Overview
@@ -45,18 +47,21 @@ For clients that support OAuth, you can use the streamlined configuration that p
45
47
```
46
48
47
49
This configuration:
50
+
48
51
- Enables OAuth authentication with your Sentry organization
49
52
- Uses Streamable HTTP transport with automatic SSE fallback
50
53
- Provides access to all 16+ available tools
51
54
- Automatically handles authentication and session management
52
55
53
56
With OAuth configuration, you'll be prompted to:
57
+
54
58
1. Accept the OAuth authorization
55
59
2. Login via your existing Sentry organization
56
60
3. Grant access to the necessary permissions
57
61
58
62
<Alert>
59
-
If you've joined a new Sentry organization, log out of your LLM's MCP integration and log back in to refresh access.
63
+
If you've joined a new Sentry organization, log out of your LLM's MCP
64
+
integration and log back in to refresh access.
60
65
</Alert>
61
66
62
67
Once authenticated, you'll see the tools become available in your MCP client.
@@ -72,11 +77,7 @@ For clients that don't support OAuth, you can continue using the existing Remote
@@ -87,6 +88,7 @@ For clients that don't support OAuth, you can continue using the existing Remote
87
88
Alternatively, if you don't want the Remote-MCP server, you can run the MCP Server locally in STDIO mode by following the instructions in the [README](https://github.com/getsentry/sentry-mcp). This is particularly useful for self-hosted Sentry installations.
88
89
89
90
To use STDIO mode, you'll need a Sentry User Auth Token with the following scopes:
The [Sentry MCP page](https://mcp.sentry.dev) provides a simple way to configure and test the MCP server. From this web client you can authenticate with your Sentry organization and access a hosted MCP server for testing.
114
+
The [Sentry MCP page](https://mcp.sentry.dev) provides a simple way to configure and test the MCP server. From this web client you can authenticate with your Sentry organization and access a hosted MCP server for testing.
112
115
113
116

114
117
@@ -117,18 +120,21 @@ The [Sentry MCP page](https://mcp.sentry.dev) provides a simple way to configure
117
120
The Sentry MCP Server provides comprehensive tools for interacting with Sentry data:
118
121
119
122
### Core Tools
123
+
120
124
-**Organizations**: List and query organization information
121
125
-**Projects**: Find, list, and create projects
122
126
-**Teams**: Manage and query team information
123
127
-**Issues**: Access issue details, search, and analyze problems
124
128
-**DSNs**: List and create Data Source Names for projects
125
129
126
130
### Analysis Tools
131
+
127
132
-**Error Searching**: Find errors in specific files or across projects
128
133
-**Issue Analysis**: Detailed issue investigation with context
129
134
-**Seer Integration**: Invoke Sentry's AI agent for root cause analysis and automated fixes
130
135
131
136
### Advanced Features
137
+
132
138
-**Release Management**: Query and analyze release information
133
139
-**Performance Monitoring**: Access transaction and performance data
134
140
-**Custom Queries**: Execute complex searches across Sentry data
@@ -147,41 +153,63 @@ Here are some example prompts you can use with the Sentry MCP:
147
153
148
154

149
155
150
-
## Verified Clients
156
+
## Verified Clients
151
157
152
-
The Sentry MCP Server has been verified to work in:
158
+
The Sentry MCP Server has been verified to work in:
153
159
154
-
### Claude for Desktop
160
+
### Claude for Desktop
155
161
156
162
Access developer tools via `CMD + ,` → `Developer` → `Edit Config` → edit the `claude_desktop_config.json` file
157
163
158
-
### Claude.ai
164
+
### Claude.ai
159
165
160
166
Navigate to `Settings` → `Profile` → Scroll to `Integrations`, select `Add More`, and add the Sentry MCP server URL `https://mcp.sentry.dev/mcp`
161
167
162
-
### Claude Code
168
+
### Claude Code
169
+
170
+
Since recently reaching 1.0, Claude Code has native support for remote hosted MCP servers. From your CLI enter `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` and then access Claude Code with `claude`.
171
+
172
+
Once in, you'll be prompted to authenticate with OAuth to Sentry.
163
173
164
-
Since recently reaching 1.0, Claude Code has native support for remote hosted MCP servers. From your cli enter `claude mcp add --transport http sentry https://mcp.sentry.dev/mcp` and then access Claude Code with `claude`.
174
+
### Codex
165
175
166
-
Once in, you'll be prompted to authenticate with OAuth to Sentry.
176
+
From your CLI, enter `codex mcp add sentry -- npx -y mcp-remote@latest https://mcp.sentry.dev/mcp` and then access Codex with `codex`.
177
+
178
+
Once in, you'll be prompted to authenticate with Sentry using OAuth.
167
179
168
180
### Cursor
169
181
170
182
Available via `Cursor` → `Settings` → `Cursor Settings` → `MCP` following the promps to configure Sentry MCP. Cursor 1.0+ includes enhanced MCP support with OAuth and Streamable HTTP.
171
183
172
-
You can still edit the `mcp.json` file manually if you prefer.
184
+
You can still edit the `mcp.json` file manually if you prefer.
173
185
174
186
### VS Code and GitHub Copilot
175
187
176
188
Add the server using `CMD+Shift+P` and selecting `MCP: Add Server`
177
189
190
+
### Warp
191
+
192
+
Available via `Settings` -> `MCP Servers` -> `Manage MCP Servers` -> `Add MCP Server` -> `Sentry` -> `https://mcp.sentry.dev/mcp`.
0 commit comments