MCP Sentry para Cursor

Instructions

Implementation Reference

• src/index.ts:1252-1277 (handler)

  The main handler for the 'sentry_get_issue' tool within the MCP server request handler switch statement. It validates the API client, extracts the issueId from arguments, fetches the issue using apiClient.getIssue, and formats a detailed text response with key issue properties.

  case "sentry_get_issue": {
    if (!apiClient) {
      throw new Error("Sentry API client not initialized. Provide auth token.");
    }
    
    const { issueId } = args as any;
    const issue = await apiClient.getIssue(issueId);
    
    return {
      content: [
        {
          type: "text",
          text: `Issue ${issueId} details:\n` +
            `- Title: ${issue.title}\n` +
            `- Short ID: ${issue.shortId}\n` +
            `- Status: ${issue.status}\n` +
            `- Level: ${issue.level}\n` +
            `- Platform: ${issue.platform || 'N/A'}\n` +
            `- First seen: ${issue.firstSeen}\n` +
            `- Last seen: ${issue.lastSeen}\n` +
            `- Event count: ${issue.count}\n` +
            `- User count: ${issue.userCount}`,
        },
      ],
    };
  }

• src/index.ts:616-628 (schema)

  Input schema definition for the 'sentry_get_issue' tool, specifying a required 'issueId' string parameter. This is part of the tools array used for MCP tool registration.

    name: "sentry_get_issue",
    description: "Retrieve and analyze a Sentry issue. Accepts issue URL or ID.",
    inputSchema: {
      type: "object",
      properties: {
        issueId: {
          type: "string",
          description: "Issue ID or URL",
        },
      },
      required: ["issueId"],
    },
  },

• src/index.ts:615-690 (registration)

  The 'sentry_get_issue' tool is registered in the MCP server's tools array, which is passed to the server for tool discovery and invocation.

      {
        name: "sentry_get_issue",
        description: "Retrieve and analyze a Sentry issue. Accepts issue URL or ID.",
        inputSchema: {
          type: "object",
          properties: {
            issueId: {
              type: "string",
              description: "Issue ID or URL",
            },
          },
          required: ["issueId"],
        },
      },
      {
        name: "sentry_list_organization_replays",
        description: "List replays from a Sentry organization. Monitor user sessions, interactions, errors and experience issues.",
        inputSchema: {
          type: "object",
          properties: {
            project: {
              type: "string",
              description: "Project ID or slug",
            },
            limit: {
              type: "number",
              description: "Number of replays to return",
              default: 50,
            },
            query: {
              type: "string",
              description: "Search query",
            },
          },
          required: [],
        },
      },
      {
        name: "sentry_setup_project",
        description: "Set up Sentry for a project returning a DSN and instructions for setup.",
        inputSchema: {
          type: "object",
          properties: {
            projectSlug: {
              type: "string",
              description: "Project slug/identifier",
            },
            platform: {
              type: "string",
              description: "Platform for installation instructions",
              default: "javascript",
            },
          },
          required: ["projectSlug"],
        },
      },
      {
        name: "sentry_search_errors_in_file",
        description: "Search for Sentry errors occurring in a specific file. Find all issues related to a particular file path or filename.",
        inputSchema: {
          type: "object",
          properties: {
            projectSlug: {
              type: "string",
              description: "Project slug/identifier",
            },
            filename: {
              type: "string",
              description: "File path or filename to search for",
            },
          },
          required: ["projectSlug", "filename"],
        },
      },
    ],
  };

• src/sentry-api-client.ts:60-62 (helper)

  Helper method in SentryAPIClient that performs the HTTP GET request to retrieve Sentry issue details by ID via the generic request method.

  async getIssue(issueId: string) {
    return this.request(`/issues/${issueId}/`);
  }

• src/sentry-api-client.ts:20-36 (helper)

  Generic private request method used by all API client methods, including getIssue, to make authenticated HTTP requests to Sentry API.

  private async request(endpoint: string, options: any = {}) {
    const url = `${this.baseUrl}${endpoint}`;
    const response = await fetch(url, {
      ...options,
      headers: {
        'Authorization': `Bearer ${this.authToken}`,
        'Content-Type': 'application/json',
        ...options.headers,
      },
    });
  
    if (!response.ok) {
      throw new Error(`Sentry API error: ${response.status} ${response.statusText}`);
    }
  
    return response.json();
  }