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

Sentry

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

اترك عاملك الذكي يقوم بأول 5 دقائق من كل تحقيق في Sentry — ابحث عن المشكلة، واسحب stacktrace، وحدد الإصدار السيء.

خادم MCP رسمي من Sentry. اسحب المشاكل حسب الحداثة والإصدار والبيئة، احصل على stacktraces كاملة والخطوات السابقة، قارن مع الإصدارات. يحول إشعار Slack 'حدث خطأ ما' إلى حادثة مفحوصة في أقل من دقيقة.

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

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

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

عرض مباشر

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

sentry.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

فحص حادثة إنتاجية جديدة في 5 دقائق

👤 مهندسو الخدمة الفورية ⏱ ~5 min intermediate

متى تستخدمه: PagerDuty للتو أيقظتك. Sentry تقول أن الأخطاء تتصاعد. تحتاج معرفة ماذا انكسر ولماذا وهل تسترجع — بسرعة.

المتطلبات الأساسية
  • رمز منظمة Sentry + رمز المشروع — انظر إلى أي عنوان Sentry: sentry.io/organizations/<ORG>/issues/?project=<ID>
  • رمز مصادقة مستخدم Sentry مع event:read و project:read — sentry.io/settings/account/api/auth-tokens/
الخطوات
  1. ابحث عن أهم مشكلة جديدة في الساعة الماضية
    ما هي أهم مشكلة جديدة في مشروعنا web-prod في الساعة الماضية، مرتبة حسب عدد الأحداث؟✓ تم النسخ
    → مشكلة واحدة مع العنوان وعدد الأحداث والمستخدمين المتأثرين ووقت الاكتشاف الأول
  2. اسحب أحدث حدث مع stacktrace كامل + الخطوات السابقة
    احصل على أحدث حدث لتلك المشكلة. اعرض لي stacktrace والإصدار وآخر 5 خطوات قبل التعطل.✓ تم النسخ
    → الملف:السطر للدالة التي تسبب الخطأ + تسلسل إجراءات المستخدم قبل الخطأ
  3. حدد الإصدار الذي أدخل المشكلة
    هل اكتُشفت هذه المشكلة لأول مرة في نفس الإصدار الذي ظهرت فيه، أم أنها استمرت من قبل؟ قارن رمز الإصدار.✓ تم النسخ
    → نعم/لا مع ثقة — يدفع قرار الاسترجاع

النتيجة: ملخص حادثة من 3 أسطر يمكنك لصقه في Slack: ما الذي انكسر، من تأثر، أي إصدار تسبب فيه، الإجراء الموصى به.

المزالق
  • إذا لم تكن علامات الإصدار متصلة، فلن تتمكن من معرفة أي نشر أدخل الخطأ — قم بإعداد sentry-cli releases في CI قبل الاعتماد على هذا — بدونه، تخمن فقط
  • stacktrace في JavaScript مضغوط وغير قابل للقراءة — تحقق من تحميل خرائط المصدر — يجب أن يكون sentry-cli sourcemaps upload في أنابيب البناء الخاصة بك
اجمعها مع: github · linear

ربط أخطاء Sentry مع التزامات GitHub التي تسببت فيها

👤 المهندسون الكبار الذين يصححون المشاكل المتكررة ⏱ ~30 min advanced

متى تستخدمه: الخطأ يعود دائماً بعد كل إصدار. تشك في مسار كود معين لكن تريد التأكد.

المتطلبات الأساسية
  • كلا من Sentry MCP و GitHub MCP مثبتان — انظر إلى دليل GitHub للإعداد
  • الإصدارات المميزة برمز git SHA في Sentry — استخدم sentry-cli releases new $SHA في CI
الخطوات
  1. ادرج سجل المشكلة عبر الإصدارات
    بالنسبة لمشكلة Sentry WEB-3a91، ادرج كل إصدار حدثت فيه وعدد الأحداث لكل إصدار.✓ تم النسخ
    → جدول يظهر المشكلة ترتفع بعد نشرات معينة
  2. بالنسبة لكل ارتفاع، احصل على الفرق
    بالنسبة للإصدارات الثلاثة ذات أعلى عدد أحداث، استخدم GitHub MCP للحصول على فرق التزام. ما الملفات التي غيّر كل إصدار؟✓ تم النسخ
    → الملفات المشتركة عبر الارتفاعات — البرهان القاطع
  3. صيغة فرضية السبب الجذري
    بناءً على تلك الفروقات، ما السبب الأكثر احتمالاً؟ كن محدداً — أشر إلى السطر(الأسطر).✓ تم النسخ
    → نظرية على مستوى السطر يمكنك التحقق منها بفحص الكود

النتيجة: فرضية محددة على مستوى الكود مع أدلة من أحداث Sentry وفروقات GitHub.

المزالق
  • التزامات متعددة في الإصدار — من الصعب عزل أيها مسؤول — استخدم أسلوب git bisect: انشر نسخة بنصف الالتزامات فقط وتحقق مما إذا كان معدل الخطأ ينخفض
اجمعها مع: github

توليد تقرير جودة هندسة أسبوعي من بيانات Sentry

👤 مديرو الهندسة ⏱ ~20 min intermediate

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

المتطلبات الأساسية
  • إمكانية القراءة على جميع مشاريعك في Sentry — رمز محدود ب org:read + project:read + event:read
الخطوات
  1. اسحب أرقام الأخطاء والجلسات الخالية من الأعطال للأسبوع
    بالنسبة لمنظمتنا، أعطني نسبة الجلسات الخالية من الأعطال لكل مشروع هذا الأسبوع مقابل الأسبوع الماضي. علّم أي مشروع انخفضت نسبته.✓ تم النسخ
    → مقارنة لكل مشروع مع التغييرات
  2. حدد أكبر المساهمين في حجم الأخطاء
    ما هي المشاكل الـ 5 المسؤولة عن معظم الأحداث هذا الأسبوع، عبر جميع المشاريع؟✓ تم النسخ
    → قائمة مشاكل محددة مع عدد الأحداث والروابط
  3. اقترح التركيز للأسبوع القادم
    بناءً على هذه البيانات، ماذا يجب على الفريق أن يركز على إصلاحه الأسبوع القادم؟ خذ بعين الاعتبار كلا من الحجم وتأثر المستخدمين.✓ تم النسخ
    → 3 توصيات مرتبة بالأولوية مع الأسباب

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

المزالق
  • مقاييس الحجم يهيمن عليها مشكلة واحدة صاخبة، مما يخفي كل شيء آخر — صفّ تلك المشكلة واعد الترتيب — أحياناً الأصخب ليس الأهم
اجمعها مع: linear · notion

قيّس تأثر المستخدمين بخطأ معروف قبل اتخاذ قرار الإصلاح

👤 مديرو المنتج ورؤساء الفنيين الذين يفحصون قائمة الانتظار ⏱ ~15 min beginner

متى تستخدمه: هناك خطأ معروف والفريق يناقش الأولوية. تحتاج لبيانات، لا آراء.

الخطوات
  1. اسحب إحصائيات تأثر المستخدمين للمشكلة
    بالنسبة لمشكلة Sentry WEB-3a91، كم عدد المستخدمين الفريدين الذين واجهوها في آخر 30 يوماً، وما نسبتهم من إجمالي المستخدمين النشطين؟✓ تم النسخ
    → العدد المطلق + النسبة المئوية
  2. قسّم المستخدمين المتأثرين
    بين المستخدمين المتأثرين، ما التوزيع حسب المتصفح ونظام التشغيل ومستوى الحساب (مدفوع مقابل مجاني)؟✓ تم النسخ
    → توزيع يكشف ما إذا كانت قضية حدية أم قضية تدفق أساسي
  3. قارن مع المشاكل المفتوحة الأخرى
    صنّف أفضل 10 أخطاء مفتوحة لدينا حسب عدد المستخدمين المتأثرين هذا الشهر. أين تقف هذه؟✓ تم النسخ
    → السياق للتقديم بالأولوية

النتيجة: توصية أولوية مبنية على البيانات: أصلح الآن، أصلح هذا الأسبوع، أو أرجِ.

التركيبات

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

sentry + github

Sentry → حدد الإصدار السيء → GitHub → ابحث عن الالتزام الذي أدخله → قم بصياغة PR استرجاع

مشكلة WEB-3a91 ارتفعت بعد الإصدار [email protected]. ابحث عن الالتزامات في ذلك الإصدار على GitHub، وحدد المسؤول الأكثر احتمالاً، وقم بصياغة PR استرجاع.✓ تم النسخ
sentry + linear

إنشاء تلقائي لمشاكل Linear من مشاكل Sentry الجديدة التي تتجاوز حد الأحداث

ابحث عن أي مشاكل Sentry جديدة من آخر 24 ساعة بـ >100 حدث. بالنسبة لكل واحدة، أنشئ تذكرة خطأ Linear معينة لمهندس الخدمة الفورية.✓ تم النسخ
sentry + notion

تقرير جودة هندسة أسبوعي منشور في Notion

اسحب إحصائيات Sentry لهذا الأسبوع وأنشئ صفحة Notion في قاعدة البيانات Engineering / Weekly Reports.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_issues organization, project, query?, sort?, limit? ابحث عن مجرى المشاكل حسب الحالة/الإصدار/البيئة/العمر 1 API call
get_issue issue_id احصل على البيانات الكاملة لمشكلة محددة بما فيها نطاق الإصدار 1 API call
get_event issue_id, event_id? اسحب stacktrace الفعلي والخطوات السابقة للتصحيح 1 API call
list_releases organization, project انظر إلى خط زمني للنشر وأي إصدار أدخل ماذا 1 API call
list_projects organization اكتشف ما المشاريع الموجودة في منظمتك 1 API call

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

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

حصة API
Sentry: 40 طلب/ثانية لكل رمز (سخي جداً). لا حد يومي على API نفسه.
الرموز لكل استدعاء
200–1000 رمز لكل استجابة مشكلة/حدث؛ stacktraces الكبيرة يمكن أن تصل إلى 5k
التكلفة المالية
الطبقة المجانية: 5000 خطأ/شهر. الخطط المدفوعة تفرض بناءً على حجم الحدث، وليس استخدام API.
نصيحة
API مجاني؛ ما تدفعه فعلاً هو استهلاك الأحداث. استخدم قواعد العينات في Sentry نفسه لإبقاء تكاليف الاستهلاك متنبأ بها.

الأمان

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

الحد الأدنى من الصلاحيات: org:read project:read event:read
تخزين بيانات الاعتماد: رمز مصادقة مستخدم Sentry في متغير البيئة SENTRY_AUTH_TOKEN
نقل البيانات الخارجي: جميع الاتصالات بمثيل Sentry الخاص بك (sentry.io أو موجود محلياً)
لا تمنح أبدًا: org:write project:admin member:write

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

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

401 Invalid token

انتهت صلاحية الرمز أو لا يملك الصلاحيات المطلوبة. أعد الإنشاء في sentry.io/settings/account/api/auth-tokens/

تحقق: curl -H "Authorization: Bearer $SENTRY_AUTH_TOKEN" https://sentry.io/api/0/organizations/
404 Project not found

رمز المشروع حساس لحالة الأحرف ويجب أن يطابق عنوان URL تماماً. تحقق في sentry.io/settings/projects/

Empty stacktrace

خرائط المصدر غير مرفوعة. شغّل sentry-cli sourcemaps upload كجزء من خط أنابيب البناء الخاص بك.

البدائل

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

البديلمتى تستخدمهاالمقايضة
Datadog APM MCPأنت بالفعل على Datadog وتريد APM موحد + أخطاءأكثر تكلفة، وأقل تركيزاً على الأخطاء على وجه التحديد
Rollbar / Bugsnag MCPأنت تدفع بالفعل لهمنظام بيئي أصغر لـ MCP مبني بواسطة المجتمع

المزيد

الموارد

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

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

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