Sentry MCP

आधिकारिक

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

GitHub
934

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

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

होस्ट किया गया MCP सर्वर

npx add-mcp 'https://mcp.sentry.dev/mcp'

Claude Code, Codex, Cursor और अन्य में इंस्टॉल होता है

दस्तावेज़

सेंट्री टूलकिट

इस रिपॉजिटरी में सेंट्री CLI, सेंट्री MCP सर्वर और साझा पैकेज शामिल हैं। CLI के लिए, CLI गाइड और https://cli.sentry.dev/ पर प्रकाशित दस्तावेज़ देखें। दस्तावेज़ अनुक्रमणिका दोनों उत्पादों और साझा योगदानकर्ता मार्गदर्शन को कवर करती है।

सेंट्री MCP

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

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

आरंभ करना

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

https://mcp.sentry.dev

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

Claude Code प्लगइन

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

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

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

आगे की ओर देखने वाले टूल वेरिएंट और सुविधाओं के लिए:

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

Stdio बनाम रिमोट

जबकि यह रिपॉजिटरी MCP सेवा के रूप में कार्य करने पर केंद्रित है, हम stdio ट्रांसपोर्ट का भी समर्थन करते हैं। यह अभी भी कार्य प्रगति पर है, लेकिन स्व-होस्टेड सेंट्री इंस्टॉलेशन के खिलाफ MCP चलाने का सबसे आसान तरीका है।

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

stdio ट्रांसपोर्ट का उपयोग करने के लिए, आपको आवश्यक स्कोप के साथ सेंट्री में एक उपयोगकर्ता प्रमाणीकरण टोकन बनाना होगा। लिखने के समय यह है:

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

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

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

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

Seer स्व-होस्टेड सेंट्री का हिस्सा नहीं है, इसलिए seer कौशल डिफ़ॉल्ट कौशल सेट से बाहर रखा गया है जब भी --host एक गैर-sentry.io होस्ट की ओर इशारा करता है। यदि आपकी स्व-होस्टेड तैनाती Seer चलाती है, तो स्पष्ट रूप से फिर से ऑप्ट इन करें:

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

आप किसी भी अन्य कौशल को अक्षम भी कर सकते हैं ताकि असमर्थित उपकरणों को उजागर होने से रोका जा सके:

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

TLS के बिना स्व-होस्टेड इंस्टेंस के लिए:

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

स्पष्ट सेंट्री टोकन के साथ रिमोट

कस्टम HTTP हेडर का समर्थन करने वाले रिमोट क्लाइंट अपस्ट्रीम सेंट्री 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 के साथ, वर्कर अपस्ट्रीम टोकन को संग्रहीत, सत्यापित, विनिमय या रीफ्रेश नहीं करता है। यह टोकन को OAuth-समर्थित सत्रों द्वारा उपयोग किए जाने वाले समान सेंट्री API कॉल के माध्यम से आगे भेजता है, और क्लाइंट या अपस्ट्रीम प्रदाता टोकन जीवनकाल और रीफ्रेश के लिए जिम्मेदार रहता है।

प्रत्यक्ष रिमोट प्रमाणीकरण डिफ़ॉल्ट रूप से सभी सक्रिय MCP कौशल के लिए होता है। आप ?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 (drops 'seer' from the default skills)
MCP_SKILLS=                  # Grant specific skills (comma-separated, e.g. 'inspect,seer')
MCP_DISABLE_SKILLS=          # Disable specific skills (comma-separated, e.g. 'project-management')

महत्वपूर्ण: अपने LLM प्रदाता को स्पष्ट रूप से निर्दिष्ट करने के लिए हमेशा EMBEDDED_AGENT_PROVIDER सेट करें। केवल API कुंजियों पर आधारित स्वचालित पहचान अप्रचलित है और भविष्य के रिलीज़ में हटा दी जाएगी। विस्तृत कॉन्फ़िगरेशन विकल्पों के लिए 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 स्वचालित रूप से सेंट्री SaaS सेवा को लक्षित करता है। केवल तभी ओवरराइड सेट करें जब आप स्व-होस्टेड सेंट्री संचालित करते हैं।

SENTRY_HOST को स्व-होस्टेड होस्ट पर सेट करना भी डिफ़ॉल्ट सेट से seer कौशल को हटा देता है, क्योंकि Seer स्व-होस्टेड सेंट्री पर उपलब्ध नहीं है। एक स्व-होस्टेड तैनाती के लिए जो Seer चलाती है, MCP_SKILLS के साथ ऑप्ट इन करें:

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

MCP इंस्पेक्टर

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

pnpm inspector

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

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

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

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

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

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

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

    npx @sentry/dotagents install

  2. सेंट्री में एक OAuth ऐप बनाएं (सेटिंग्स => API => एप्लिकेशन):

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

  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

स्थानीय सर्वर का परीक्षण करने के लिए, इंस्पेक्टर में http://localhost:5173/mcp दर्ज करें और कनेक्ट दबाएं। एक बार जब आप संकेतों का पालन करते हैं, तो आप "टूल सूचीबद्ध करें" करने में सक्षम होंगे।

परीक्षण

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

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

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 कार्यान्वयन (IDE, MCP इंस्पेक्टर) के निर्माण, चलाने और परीक्षण के लिए पूर्ण गाइड के लिए docs/testing/stdio.md देखें
  • रिमोट परीक्षण: रिमोट सर्वर (OAuth, वेब UI, CLI क्लाइंट) के परीक्षण के लिए पूर्ण गाइड के लिए docs/testing/remote.md देखें

विकास नोट्स

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

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

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

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

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

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

योगदान करना चाहते हैं? CLI, MCP और साझा गाइड के लिए टूलकिट दस्तावेज़ अनुक्रमणिका से शुरू करें। रिपॉजिटरी नियमों के लिए AGENTS.md और CLI-विशिष्ट नियमों के लिए packages/cli/AGENTS.md देखें।