/ الدليل / الملعب / Sentry MCP
← كل الخوادم ↗ GitHub
● رسمي getsentry 🔑 يتطلب مفتاحك

Sentry MCP

بواسطة getsentry · getsentry/sentry-mcp

خادم MCP الرسمي لـ Sentry — دع Claude يسحب الأخطاء المباشرة والتتبعات والإصدارات حتى يكون تصحيح الأخطاء مستنداً إلى بيانات الإنتاج لا التخمين.

يربط sentry-mcp Claude بمنظمة Sentry الخاصة بك. يكشف المشكلات والأحداث والإصدارات ومسارات breadcrumb والتتبعات والبيانات الوصفية للمشاريع كأدوات MCP. Claude يستطيع ربط تتبع المكدس بالنشر الذي تسبب فيه، وتجميع الأخطاء المتعلقة، واقتراح إصلاحات مرتبطة بإطارات المكدس الفعلية.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

sentry-mcp-getsentry.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "sentry-mcp-getsentry": {
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "sentry-mcp-getsentry",
      "command": "npx",
      "args": [
        "-y",
        "@sentry/mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "sentry-mcp-getsentry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@sentry/mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add sentry-mcp-getsentry -- npx -y @sentry/mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: Sentry MCP

تصحيح خطأ في الإنتاج من البداية إلى النهاية دون مغادرة Claude

👤 المطورون الذين يتعاملون مع تنبيهات المناوبة ⏱ ~20 min intermediate

متى تستخدمه: تنبيه Sentry يُطلق؛ تحتاج السبب الجذري الآن.

المتطلبات الأساسية
  • رمز مصادقة Sentry — User Settings → Auth Tokens → أنشئ مع 'project:read', 'event:read', 'org:read'
  • الرمز في المتغيرات البيئية — اضبط SENTRY_AUTH_TOKEN و SENTRY_HOST (sentry.io أو self-hosted)
الخطوات
  1. إيجاد المشكلة
    Use sentry-mcp. Find the most-firing issue in project 'web' from the last 6 hours.✓ تم النسخ
    → معرف المشكلة + العدد + أول/آخر ظهور
  2. جلب السياق الكامل
    Get the latest event for that issue — stack trace, breadcrumbs, request data.✓ تم النسخ
    → حمولة حدث كاملة مع إطارات + مسار إجراءات المستخدم
  3. الربط بالنشر
    What release was running when this first appeared? List the commits in that release.✓ تم النسخ
    → علامة الإصدار + قائمة commits
  4. اقتراح إصلاح
    Looking at the stack and the commits — which commit likely caused this? Draft a fix in the relevant file.✓ تم النسخ
    → ملف ومسطر محدد؛ تعديل ملموس

النتيجة: من التنبيه إلى إصلاح مرشح في دقائق، مع سلسلة أدلة كاملة.

المزالق
  • خرائط المصدر مفقودة — إطارات المكدس غير مفيدة — تحقق من رفع خريطة المصدر في إصدارات Sentry الخاصة بك؛ وإلا تعطي إطارات مضغوطة Claude لا شيء
اجمعها مع: github

فحص ما قبل الترقية قبل الترويج للإصدار

👤 مهندسو الإصدار وحراس النشر ⏱ ~15 min intermediate

متى تستخدمه: على وشك ترقية إصدار canary إلى 100%.

الخطوات
  1. مقارنة صحة الإصدار
    Use sentry-mcp. Compare crash-free rate of release 1.4.0 vs 1.3.9 over their respective canary windows.✓ تم النسخ
    → معدل خلو من الأعطال لكل إصدار، التبني، عدد الانحدارات
  2. فحص الأخطاء الجديدة
    List any issues unique to 1.4.0 (not seen in 1.3.9 or earlier).✓ تم النسخ
    → قائمة مشكلات جديدة مع أعدادها
  3. التوصية
    Given crash-free is X% and N net-new errors, recommend ship/halt with reason.✓ تم النسخ
    → توصية واضحة مع الحدود المذكورة

النتيجة: قرار ترقية/إيقاف مبني على البيانات لا الحدس.

المزالق
  • نسبة التبني منخفضة جداً لتكون ذات دلالة إحصائية — Claude يجب أن يُعلم بأن نوافذ التبني المنخفض غير قاطعة — لا يتظاهر بالمعرفة

التحقيق في انحدار الأداء باستخدام تتبعات المعاملات

👤 مهندسو الخوادم الذين يتتبعون زمن الاستجابة ⏱ ~25 min advanced

متى تستخدمه: قفز زمن استجابة p95 على /checkout بعد آخر نشر.

الخطوات
  1. جلب تتبع بطيء حديث
    Use sentry-mcp. Get a trace for transaction 'POST /checkout' with duration > 2s from the last hour.✓ تم النسخ
    → تتبع مع تفصيل span
  2. إيجاد الـ span الجديد
    Compare span list to a similar trace from last week. Which spans are new or longer?✓ تم النسخ
    → الفرق: استعلام DB جديد 'SELECT cart_items'، متوسط 1.4 ثانية
  3. الربط بالكود
    What commit added that query? Suggest an index or a query rewrite.✓ تم النسخ
    → Commit + اقتراح إصلاح ملموس

النتيجة: السبب الجذري لانحدار الأداء، مع اقتراح إصلاح على مستوى الكود.

المزالق
  • معدل أخذ عينات التتبع منخفض جداً — لا تتبع بطيء ملتقط — رفع معدل العينات مؤقتاً، أو اطلب من Claude استخدام endpoints الإحصاءات بدلاً من ذلك
اجمعها مع: github

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

sentry-mcp-getsentry + github

من إطار Sentry مباشرة إلى مسودة PR

Pull issue X from Sentry, find the offending commit via GitHub, draft a fix as a new branch + PR.✓ تم النسخ
sentry-mcp-getsentry + linear

إنشاء تذاكر هندسية تلقائياً من الانحدارات

For each new release-blocking issue in Sentry, create a Linear ticket with the stack + suggested owner.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
search_issues project, query, statsPeriod? تصفية المشكلات باستعلام Sentry 1 Sentry API call
get_issue issue_id نظرة عامة على مستوى مشكلة واحدة 1 API call
get_event event_id or 'latest' جلب حادثة محددة بسياقها الكامل 1 API call
list_releases project, version? المقارنة بين الإصدارات 1 API call
get_trace trace_id التحقيق في الأداء 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
حدود معدل API القياسية لـ Sentry — الطفرات قد تُعطي 429
الرموز لكل استدعاء
حمولة الحدث يمكن أن تكون 5–20 ألف رمز — اجلب بشكل انتقائي
التكلفة المالية
مجاني لخطة Sentry المطورة؛ الخطط المدفوعة لها حدود معدل أعلى
نصيحة
استخدم search_issues للتضييق أولاً؛ استدع get_event فقط على المرشحين — لا على قوائم نتائج كاملة

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: project:read event:read org:read
تخزين بيانات الاعتماد: متغير بيئة SENTRY_AUTH_TOKEN (استخدم رمزاً محدوداً بمشروع)
نقل البيانات الخارجي: جميع الاستدعاءات إلى مضيف Sentry الخاص بك (sentry.io أو self-hosted)
لا تمنح أبدًا: project:write أو org:write لعامل مُشغَّل بالمحادثة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Unauthorized

الرمز منتهي أو نطاقه خاطئ — أعد توليده بنطاقات القراءة المذكورة

تحقق: curl -H 'Authorization: Bearer $SENTRY_AUTH_TOKEN' $SENTRY_HOST/api/0/projects/
تتبع المكدس يُظهر إطارات مضغوطة فقط

تحقق من رفع خريطة المصدر في pipeline الإصدار؛ بدون خرائط لا يستطيع Claude تحليل الإطارات

تحقق: Sentry UI → Release → Artifacts
404 على مشكلة معروفة

المشكلة في مشروع لا يغطيه الرمز — أعد تحديد نطاق الرمز لذلك المشروع

Sentry self-hosted — الاتصال مرفوض

اضبط SENTRY_HOST صراحةً على URL المثيل الخاص بك مع البروتوكول

تحقق: curl $SENTRY_HOST/api/0/

البدائل

Sentry MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Datadog MCPفريقك يستخدم Datadog APM/error trackingتغطية مختلفة؛ APM أولاً، أقل تركيزاً على المشكلات
Honeycomb MCPأنت في متجر observability-first يستخدم الأحداث لا تتبعات المكدسلا تجميع مشكلات من الدرجة الأولى؛ تمحور حول التتبعات

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills