MCP Directory

How to add Sentry MCP Server (remote) to Windsurf

Official hosted Sentry MCP for investigating issues, errors, traces and performance data. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 15, 2026 · 1.1k★ · http · oauth · official

Windsurf config for Sentry MCP Server (remote)

Connect client to https://mcp.sentry.dev/mcp and complete OAuth
{
  "mcpServers": {
    "sentry-mcp-server-remote": {
      "serverUrl": "https://mcp.sentry.dev/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Sentry MCP Server (remote) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Sentry MCP Server (remote)'s tools become available to Cascade.

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 Windsurf

find_organizations

List the Sentry organizations the user can access

find_projects

List projects within an organization

get_issue_details

Fetch full details for a specific issue by ID or URL

search_issues

Natural-language search that resolves to Sentry issue queries

search_events

Natural-language search over events/errors/spans

get_trace_details

Retrieve a distributed trace by ID

analyze_issue_with_seer

Run Sentry's Seer agent for AI root-cause analysis on an issue

update_issue

Change 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) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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.

View repo Full Sentry MCP Server (remote) page