Sentry MCP

आधिकारिक

Sentry MCP का आधिकारिक सर्वर, जो AI कोडिंग एजेंटों से समस्याओं, त्रुटि रिपोर्ट, ट्रेस और प्रदर्शन निगरानी डेटा की जांच करने के लिए है।

GitHub
837
इस MCP को आज़माएँप्रायोजित

Sentry MCP के साथ आप क्या कर सकते हैं?

  • त्रुटियों और समस्याओं की जाँच करें — अपने सहायक से कोडिंग सत्रों के दौरान डिबगिंग के लिए Sentry त्रुटि विवरण, स्टैक ट्रेस और समस्या संदर्भ प्राप्त करने को कहें।
  • प्रदर्शन समस्याओं का पता लगाएँ — अपने सहायक से वितरित ट्रेस और प्रदर्शन डेटा का विश्लेषण करवाकर धीमे लेन-देन या बाधाओं की पहचान करें।
  • प्राकृतिक भाषा में इवेंट खोजें — search_events का उपयोग करके अपने सहायक को सादे अंग्रेज़ी प्रश्नों को Sentry की खोज सिंटैक्स में अनुवाद करने दें, ताकि प्रासंगिक इवेंट मिल सकें।
  • समस्याओं को ट्रायेज और प्रबंधित करें — अपने सहायक को निर्देश दें कि वह आपके कोडिंग वर्कफ़्लो से सीधे समीक्षा, असाइन या स्थिति अपडेट करे।
  • प्रोजेक्ट और टीम जानकारी क्वेरी करें — डिबगिंग के दौरान स्वामित्व और दायरे को समझने के लिए Sentry संगठन, प्रोजेक्ट और टीम मेटाडेटा प्राप्त करें।

दस्तावेज़

sentry-mcp

Sentry की MCP सेवा मुख्य रूप से human-in-the-loop कोडिंग एजेंटों के लिए डिज़ाइन की गई है। हमारे टूल चयन और प्राथमिकताएँ डेवलपर वर्कफ़्लो और डिबगिंग उपयोग-मामलों पर केंद्रित हैं, न कि सभी Sentry कार्यक्षमता के लिए एक सामान्य-उद्देश्य वाला MCP सर्वर प्रदान करने पर।

यह रिमोट MCP सर्वर अपस्ट्रीम Sentry API के लिए मिडलवेयर के रूप में कार्य करता है, जो Cursor, Claude Code, और समान डेवलपमेंट टूल जैसे कोडिंग सहायकों के लिए अनुकूलित है। यह Cloudflare के रिमोट MCP की दिशा में काम पर आधारित है।

आरंभ करना

प्रोडक्शन में तैनात सेवा पर जाकर आपको वह सब कुछ मिलेगा जो आपको जानना आवश्यक है:

https://mcp.sentry.dev

यदि आप योगदान देना चाहते हैं, यह जानना चाहते हैं कि यह कैसे काम करता है, या इसे self-hosted Sentry के लिए चलाना चाहते हैं, तो नीचे जारी रखें।

Claude Code प्लगइन

स्वचालित सबएजेंट प्रतिनिधिमंडल के लिए Claude Code प्लगइन के रूप में इंस्टॉल करें:

claude plugin marketplace add getsentry/sentry-mcp
claude plugin install sentry-mcp@sentry-mcp

यह एक sentry-mcp सबएजेंट प्रदान करता है जिसे Claude स्वचालित रूप से सौंपता है जब आप Sentry त्रुटियों, issues, traces, या performance के बारे में पूछते हैं।

भविष्य-उन्मुख टूल वेरिएंट और सुविधाओं के लिए:

claude plugin install sentry-mcp@sentry-mcp-experimental

Stdio बनाम Remote

जबकि यह रिपॉज़िटरी MCP सेवा के रूप में कार्य करने पर केंद्रित है, हम stdio ट्रांसपोर्ट का भी समर्थन करते हैं। यह अभी भी कार्य प्रगति पर है, लेकिन self-hosted Sentry इंस्टॉलेशन के विरुद्ध MCP चलाने के लिए यह सबसे आसान तरीका है।

नोट: AI-संचालित खोज टूल (search_events, search_issues, आदि) के लिए एक LLM प्रदाता (OpenAI, Azure OpenAI, Anthropic, या OpenRouter) आवश्यक है। ये टूल क्वेरी को Sentry की क्वेरी सिंटैक्स में अनुवाद करने के लिए प्राकृतिक भाषा प्रोसेसिंग का उपयोग करते हैं। कॉन्फ़िगर किए गए प्रदाता के बिना, ये विशिष्ट टूल अनुपलब्ध होंगे, लेकिन अन्य सभी टूल सामान्य रूप से कार्य करेंगे।

stdio ट्रांसपोर्ट का उपयोग करने के लिए, आपको Sentry में आवश्यक scopes के साथ एक User Auth Token बनाना होगा। लिखने के समय यह है:

org:read
project:read
project:write
team:read
team:write
event:write

ट्रांसपोर्ट लॉन्च करें:

npx @sentry/mcp-server@latest --access-token=sentry-user-token

self-hosted डिप्लॉयमेंट से कनेक्ट करने की आवश्यकता है? कमांड चलाते समय --host जोड़ें (केवल होस्टनाम, जैसे --host=sentry.example.com)। केवल सादा HTTP उजागर करने वाले अलग-थलग आंतरिक डिप्लॉयमेंट के लिए, यह भी जोड़ें --insecure-http।

कुछ सुविधाएँ (जैसे Seer) self-hosted इंस्टेंस पर उपलब्ध नहीं हो सकती हैं। आप असमर्थित टूल को उजागर होने से रोकने के लिए विशिष्ट skills को अक्षम कर सकते हैं:

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.example.com --disable-skills=seer

TLS के बिना self-hosted इंस्टेंस के लिए:

npx @sentry/mcp-server@latest --access-token=TOKEN --host=sentry.internal:9000 --insecure-http

स्पष्ट Sentry टोकन के साथ Remote

कस्टम HTTP हेडर का समर्थन करने वाले रिमोट क्लाइंट अपस्ट्रीम Sentry API टोकन को सीधे Cloudflare ट्रांसपोर्ट पर पास कर सकते हैं:

{
  "mcpServers": {
    "sentry": {
      "url": "https://mcp.sentry.dev/mcp",
      "headers": {
        "Authorization": "Sentry-Bearer ${SENTRY_ACCESS_TOKEN}"
      }
    }
  }
}

Sentry-Bearer जानबूझकर Bearer से अलग है: Bearer आरक्षित है MCP OAuth एक्सेस टोकन के लिए। Sentry-Bearer के साथ, worker अपस्ट्रीम टोकन को संग्रहीत, सत्यापित, विनिमय या रीफ़्रेश नहीं करता है। यह टोकन को OAuth-समर्थित सत्रों द्वारा उपयोग किए जाने वाले समान Sentry API कॉल के माध्यम से आगे भेजता है, और क्लाइंट या अपस्ट्रीम प्रदाता टोकन जीवनकाल और रीफ़्रेश के लिए ज़िम्मेदार रहता है।

डायरेक्ट रिमोट प्रमाणीकरण डिफ़ॉल्ट रूप से सभी सक्रिय MCP skills तक पहुँचता है। आप उजागर टूल को ?skills=inspect,triage या ?disable-skills=seer के साथ सीमित कर सकते हैं।

पर्यावरण चर

SENTRY_ACCESS_TOKEN=         # Required: Your Sentry auth token

# LLM Provider Configuration (required for AI-powered search tools)
EMBEDDED_AGENT_PROVIDER=     # Required when multiple provider keys are set: 'openai', 'azure-openai', 'anthropic', or 'openrouter'
OPENAI_API_KEY=              # Required if using OpenAI
ANTHROPIC_API_KEY=           # Required if using Anthropic
OPENROUTER_API_KEY=          # Required if using OpenRouter
OPENROUTER_MODEL=            # Optional OpenRouter model, defaults to 'openai/gpt-5.6-luna'
OPENROUTER_REASONING_EFFORT= # Optional OpenRouter reasoning effort, defaults to 'high'

# Optional overrides
SENTRY_HOST=                 # For self-hosted deployments
MCP_DISABLE_SKILLS=          # Disable specific skills (comma-separated, e.g. 'seer')

महत्वपूर्ण: अपने LLM प्रदाता को स्पष्ट रूप से निर्दिष्ट करने के लिए हमेशा EMBEDDED_AGENT_PROVIDER सेट करें। केवल API कुंजियों पर आधारित स्वतः-पहचान deprecated है और भविष्य के रिलीज़ में हटा दी जाएगी। विस्तृत कॉन्फ़िगरेशन विकल्पों के लिए docs/operations/embedded-agents.md देखें।

उदाहरण MCP कॉन्फ़िगरेशन

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "EMBEDDED_AGENT_PROVIDER": "openai",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

यदि आप होस्ट वेरिएबल को अनसेट छोड़ते हैं, तो CLI स्वचालित रूप से Sentry SaaS सेवा को लक्षित करता है। केवल तभी ओवरराइड सेट करें जब आप self-hosted Sentry संचालित करते हैं।

Seer का समर्थन नहीं करने वाले self-hosted इंस्टेंस के लिए:

{
  "mcpServers": {
    "sentry": {
      "command": "npx",
      "args": ["@sentry/mcp-server"],
      "env": {
        "SENTRY_ACCESS_TOKEN": "your-token",
        "SENTRY_HOST": "sentry.example.com",
        "MCP_DISABLE_SKILLS": "seer"
      }
    }
  }
}

MCP Inspector

MCP में सेवा का आसानी से परीक्षण करने के लिए एक Inspector शामिल है:

pnpm inspector

MCP सर्वर URL (http://localhost:5173) दर्ज करें और connect दबाएँ। यह आपके लिए प्रमाणीकरण प्रवाह को ट्रिगर करेगा।

नोट: यदि आपको 127.0.0.1 पर inspector तक पहुँचते समय अपने OAuth प्रवाह में समस्या होती है, तो http://localhost:6274 पर जाकर localhost का उपयोग करने का प्रयास करें।

स्थानीय विकास

परिवर्तनों में योगदान करने के लिए, आपको अपना स्थानीय वातावरण सेट करना होगा:

  1. पर्यावरण और एजेंट skills सेट करें:

    make setup-env  # Creates .env files and installs shared agent skills

    यह getsentry/skills से साझा skills को .agents/skills/ में इंस्टॉल करने के लिए npx @sentry/dotagents install भी चलाता है (.claude/skills और .cursor/skills में symlink किया गया)। यदि आपको बाद में skills अपडेट करने की आवश्यकता है, तो इसे सीधे चलाएँ:

    npx @sentry/dotagents install

  2. Sentry में एक OAuth ऐप बनाएँ (Settings => API => Applications):

    • होमपेज URL: http://localhost:5173
    • अधिकृत रीडायरेक्ट URI: http://localhost:5173/oauth/callback
    • अपना Client ID नोट करें और एक Client secret उत्पन्न करें

  3. अपनी क्रेडेंशियल्स कॉन्फ़िगर करें:

    • रूट निर्देशिका में .env संपादित करें और OPENAI_API_KEY या OPENROUTER_API_KEY जोड़ें
    • packages/mcp-cloudflare/.env संपादित करें और जोड़ें:
      • SENTRY_CLIENT_ID=your_development_sentry_client_id
      • SENTRY_CLIENT_SECRET=your_development_sentry_client_secret
      • COOKIE_SECRET=my-super-secret-cookie

  4. डेवलपमेंट सर्वर प्रारंभ करें:

    pnpm dev

सत्यापित करें

सर्वर को स्थानीय रूप से चलाएँ ताकि यह http://localhost:5173 पर उपलब्ध हो

pnpm dev

स्थानीय सर्वर का परीक्षण करने के लिए, Inspector में http://localhost:5173/mcp दर्ज करें और connect दबाएँ। एक बार जब आप संकेतों का पालन करते हैं, तो आप "List Tools" कर पाएँगे।

परीक्षण

तीन परीक्षण सूट शामिल हैं: यूनिट परीक्षण, मूल्यांकन, और मैन्युअल परीक्षण।

यूनिट परीक्षण इसका उपयोग करके चलाए जा सकते हैं:

pnpm test

मूल्यांकन के लिए प्रोजेक्ट रूट में कुछ कॉन्फ़िगरेशन के साथ एक .env फ़ाइल की आवश्यकता होती है:

# .env (in project root)
OPENAI_API_KEY=      # Use OpenAI-backed AI-powered tools
OPENROUTER_API_KEY=  # Or use OpenRouter-backed AI-powered tools

नोट: रूट .env फ़ाइल सभी पैकेजों के लिए डिफ़ॉल्ट प्रदान करती है। व्यक्तिगत पैकेजों में विकास के दौरान इन डिफ़ॉल्ट को ओवरराइड करने के लिए अपनी स्वयं की .env फ़ाइलें हो सकती हैं।

एक बार ऐसा हो जाने पर आप इन्हें इसका उपयोग करके चला सकते हैं:

pnpm eval

मैन्युअल परीक्षण (MCP परिवर्तनों के परीक्षण के लिए पसंदीदा):

# Test with local dev server (default: http://localhost:5173)
pnpm -w run cli "who am I?"

# Test against production
pnpm -w run cli --mcp-host=https://mcp.sentry.dev "query"

# Test with local stdio mode (requires SENTRY_ACCESS_TOKEN)
pnpm -w run cli --access-token=TOKEN "query"

नोट: CLI डिफ़ॉल्ट रूप से http://localhost:5173 है। --mcp-host के साथ ओवरराइड करें या MCP_URL पर्यावरण चर सेट करें।

व्यापक परीक्षण प्लेबुक:

  • Stdio परीक्षण: stdio कार्यान्वयन (IDEs, MCP Inspector) के निर्माण, चलाने और परीक्षण के लिए पूर्ण गाइड के लिए docs/testing/stdio.md देखें
  • Remote परीक्षण: रिमोट सर्वर (OAuth, वेब UI, CLI क्लाइंट) के परीक्षण के लिए पूर्ण गाइड के लिए docs/testing/remote.md देखें

विकास नोट्स

स्वचालित कोड समीक्षा

यह रिपॉज़िटरी पुल रिक्वेस्ट में संभावित समस्याओं की पहचान करने में सहायता के लिए स्वचालित कोड समीक्षा टूल (जैसे Cursor BugBot) का उपयोग करती है। ये टूल सहायक प्रतिक्रिया और सुझाव प्रदान करते हैं, लेकिन हम अनुशंसा नहीं करते कि इन जाँचों को अनिवार्य बनाया जाए क्योंकि सटीकता अभी भी विकसित हो रही है और गलत सकारात्मक परिणाम उत्पन्न कर सकती है।

स्वचालित समीक्षाओं को इस प्रकार माना जाना चाहिए:

  • ✅ सहायक सुझाव जिन पर कोड समीक्षा के दौरान विचार किया जाए
  • ✅ चर्चा और सुधार के लिए प्रारंभिक बिंदु
  • ❌ PR विलय के लिए अवरोधक आवश्यकताएँ नहीं
  • ❌ मानव कोड समीक्षा के विकल्प नहीं

स्वचालित प्रतिक्रिया को संबोधित करते समय, हर सुझाव का सख्ती से पालन करने के बजाय अंतर्निहित चिंताओं पर ध्यान केंद्रित करें।

योगदानकर्ता दस्तावेज़ीकरण

योगदान करना चाहते हैं या पूर्ण दस्तावेज़ीकरण मानचित्र का अन्वेषण करना चाहते हैं? योगदानकर्ता वर्कफ़्लो और पूर्ण docs अनुक्रमणिका के लिए CLAUDE.md देखें (AGENTS.md के रूप में भी उपलब्ध)। docs/ फ़ोल्डर में विषय-वार गाइड और टूल-एकीकृत .md फ़ाइलें शामिल हैं।