Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 13 additions & 10 deletions docs/ai/mcp.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Or add it manually to your client's MCP configuration:
```json
{
"mcpServers": {
"Sentry": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
Expand All @@ -50,6 +50,8 @@ Or add it manually to your client's MCP configuration:

When you first connect, you'll be prompted to log in with your Sentry organization and grant access. During authentication, you select which tool groups to expose — this keeps the context window focused on the tools you actually need.

The Cloud transport requires your client to support OAuth and Streamable HTTP. All clients listed under [Client Instructions](#client-instructions) support this natively — if yours doesn't, use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge or the [Stdio Transport](#stdio-transport) instead.

![Available Sentry MCP Tools](./img/mcp-tools.png)

See [Client Instructions](#client-instructions) for setup steps specific to your editor or IDE.
Expand Down Expand Up @@ -78,7 +80,7 @@ Add the server to your client's MCP configuration:
```json
{
"mcpServers": {
"Sentry": {
"sentry": {
"command": "npx",
"args": ["@sentry/mcp-server@latest"]
}
Expand Down Expand Up @@ -141,7 +143,7 @@ JSON config for clients that support it:
```json
{
"mcpServers": {
"Sentry": {
"sentry": {
"command": "npx",
"args": [
"@sentry/mcp-server@latest",
Expand Down Expand Up @@ -208,7 +210,7 @@ You can also edit your `mcp.json` directly:
```json
{
"mcpServers": {
"Sentry": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
Expand All @@ -226,7 +228,7 @@ Open `CMD + ,` → `Developer` → `Edit Config`, then add to `claude_desktop_co
```json
{
"mcpServers": {
"Sentry": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
Expand Down Expand Up @@ -293,7 +295,7 @@ Go to `Settings` → `MCP Servers` → `+ Add` → **Streamable HTTP or SSE Serv

```json
{
"Sentry": {
"sentry": {
"url": "https://mcp.sentry.dev/mcp"
}
}
Expand Down Expand Up @@ -335,7 +337,7 @@ Open the MCP menu with `/mcp` → `Add MCP Server from Registry` → search for

<Expandable title="Setup Instructions" group="clients">

In the [v0.app](https://v0.app) UI: `Prompt Tools` → `Add MCP` → select Sentry.
In the [v0.app](https://v0.app) UI: `Account Settings` → `Integrations` → under **MCP Connections** click `Add MCP` → search for Sentry.

</Expandable>

Expand Down Expand Up @@ -388,14 +390,15 @@ The [Sentry MCP page](https://mcp.sentry.dev) has a web interface where you can

**OAuth Authentication Problems**

- Ensure your client supports OAuth
- Ensure your client supports OAuth and Streamable HTTP — if it doesn't, use the [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) bridge or the [Stdio Transport](#stdio-transport)
- Check that you have the right permissions in your Sentry organization
- Verify the URL is exactly `https://mcp.sentry.dev/mcp`
- Try reauthenticating (see below)

**Reauthenticating in Claude Code**

1. Type `/mcp` in the Claude Code prompt
2. Select the **Sentry** server
2. Select the **sentry** server
3. Choose **"Clear authentication"** or **"Authenticate"** to re-trigger OAuth

**Reauthenticating in OpenCode**
Expand All @@ -406,7 +409,7 @@ The [Sentry MCP page](https://mcp.sentry.dev) has a web interface where you can

**Reauthenticating in Factory Droid**

1. Type `/mcp` → select **Sentry** → **"Reauthenticate"**
1. Type `/mcp` → select **sentry** → **"Reauthenticate"**

**Connection Issues**

Expand Down
Loading