View as Markdown

Sentry Integration

Monitor Sentry errors, issues, releases, and projects

The Sentry integration provides access to monitor Sentry errors, issues, releases, and projects through the Integrate MCP server.

Installation

The Sentry integration is included with the SDK:

import { sentryIntegration } from "integrate-sdk/server";

Setup

1. Create a Sentry OAuth App

  1. Go to Sentry Developer Portal
  2. Create a new OAuth application
  3. Configure your redirect URI
  4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Sentry integration to your server configuration. The integration automatically reads SENTRY_CLIENT_ID and SENTRY_CLIENT_SECRET from your environment variables:

import { createMCPServer, sentryIntegration } from "integrate-sdk/server";
 
export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    sentryIntegration({
      scopes: ["org:read", "project:read", "team:read", "member:read", "event:read", "event:write", "project:releases"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

sentryIntegration({
  clientId: process.env.CUSTOM_SENTRY_ID,
  clientSecret: process.env.CUSTOM_SENTRY_SECRET,
      scopes: ["org:read", "project:read", "team:read", "member:read", "event:read", "event:write", "project:releases"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";
 
await client.authorize("sentry");
const result = await client.sentry.getOrganization({
  org_slug: "value",
});
 
console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, sentryIntegration } from "integrate-sdk";
 
const customClient = createMCPClient({
  integrations: [sentryIntegration()],
});

Configuration Options

export interface SentryIntegrationConfig {
  /** Sentry OAuth client ID (defaults to SENTRY_CLIENT_ID env var) */
  clientId?: string;

Default Scopes

These defaults are applied unless you override scopes in the integration config:

  • org:read
  • project:read
  • team:read
  • member:read
  • event:read
  • event:write
  • project:releases

Tools

sentry_get_organization

Get organization

export interface SentryGetOrganizationParams { org_slug: string }

sentry_list_org_projects

List org projects

export interface SentryListOrgProjectsParams { org_slug: string;

sentry_list_org_members

List org members

export interface SentryListOrgMembersParams { org_slug: string;

sentry_get_project

Get project

export interface SentryGetProjectParams { org_slug: string;

sentry_list_issues

List issues

export interface SentryListIssuesParams { org_slug: string;

sentry_get_issue

Get issue

export interface SentryGetIssueParams { issue_id: string }

sentry_update_issue

Update issue

export interface SentryUpdateIssueParams { issue_id: string;

sentry_list_issue_events

List issue events

export interface SentryListIssueEventsParams { issue_id: string;

sentry_list_project_events

List project events

export interface SentryListProjectEventsParams { org_slug: string;

sentry_list_releases

List releases

export interface SentryListReleasesParams { org_slug: string;

sentry_get_release

Get release

export interface SentryGetReleaseParams { org_slug: string;

sentry_create_release

Create release

export interface SentryCreateReleaseParams { org_slug: string;

sentry_list_release_commits

List release commits

export interface SentryListReleaseCommitsParams { org_slug: string;

sentry_resolve_short_id

Resolve short id

export interface SentryResolveShortIdParams { org_slug: string;

Notes

  • Category: Engineering
  • Authentication mode: OAuth