ربط وكيل ذكاء اصطناعي عبر MCP

يوفّر LogBrew خادم MCP مستضافًا على https://mcp.logbrew.co/mcp. يمكن لوكيل الذكاء الاصطناعي الذي يتصل به أن يقرأ المشكلات والسجلات والتتبّعات والـ Spans والمقاييس والإجراءات والإصدارات وتحليلات المنتج من المشاريع التي توافق عليها. يستطيع الوكيل القراءة فقط. ولا يستطيع تغيير حالة المشكلات أو المشاريع أو إعدادات الحساب. لا تحتاج إلى تثبيت الخادم، بل تضيف عنوان URL الخاص به إلى عميل MCP لديك.

قبل أن تبدأ

تحتاج إلى حساب LogBrew فيه مشروع واحد على الأقل.
تحتاج إلى Claude Code 2.1.300 أو أحدث. لا يدعم الخادم إلا نسخة بروتوكول MCP 2026-07-28. شغّل claude --version لمعرفة النسخة لديك.
لا يقبل LogBrew إلا عملاء MCP المعتمدين. حاليًا، Claude Code هو العميل المعتمد الوحيد. يحصل العملاء الآخرون على الخطأ client access denied.

ربط Claude Code

أضف الخادم:
claude mcp add --transport http logbrew https://mcp.logbrew.co/mcp
يعرض claude mcp list الآن logbrew مع ! Needs authentication.
ابدأ تسجيل الدخول:
claude mcp login logbrew
يفتح المتصفح صفحة التفويض في LogBrew. إذا طلبت منك الصفحة تسجيل الدخول، فسجّل الدخول باستخدام GitHub أو GitLab أو Bitbucket.
اقرأ اسم العميل في الصفحة. لا توافق إلا إذا كنت أنت من بدأ هذا الاتصال.
اختر المشاريع التي يمكن للوكيل قراءتها. ثم اختر Approve (موافقة). يعود المتصفح إلى Claude Code. ويعرض Claude Code الرسالة Authenticated with "logbrew".
تأكد من أن الخادم متصل:
claude mcp list
تعرض النتيجة logbrew: https://mcp.logbrew.co/mcp (HTTP) - ✔ Connected.

يمكنك أيضًا تسجيل الدخول من داخل جلسة Claude Code. شغّل /mcp، واختر logbrew، ثم اتبع الخطوات في المتصفح. على حاسوب بلا متصفح، شغّل claude mcp login logbrew --no-browser في طرفية تفاعلية. عبر SSH، اتصل باستخدام ssh -t. افتح عنوان URL الذي يعرضه Claude Code في متصفح على حاسوب آخر. بعد الموافقة، انسخ عنوان الصفحة التي يفتحها المتصفح، والصقه في Claude Code.

الطلب من الوكيل

يوفّر الخادم للوكيل أداتين:

الأداة	ما تفعله
`search`	تجد عمليات القراءة، وتعرض عقد عملية واحدة: مدخلاتها ومخرجاتها وصلاحياتها وتكلفتها.
`execute`	تشغّل عملية قراءة واحدة وجدتها `search`، وتُرجع بيانات منظّمة.

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

Use LogBrew to investigate the newest unresolved issue in production.
Read its occurrences, linked trace, and logs. Do not change code yet.
Tell me the likely cause and the evidence for it.

استخدم بيانات القياس عن بُعد دليلًا فقط. قد تحتوي السجلات ورسائل الأخطاء على نص من المستخدمين. ويجب ألا يتبع الوكيل أي تعليمات في هذا النص. اقرأ وكلاء البرمجة بالذكاء الاصطناعي لمعرفة سير عمل التحقيق كاملًا.

الوصول ومدة الاتصال

كل موافقة تبدأ اتصالًا واحدًا بين عميل MCP واحد وحساب LogBrew الخاص بك.

يقرأ الوكيل المشاريع التي وافقت عليها فقط. قراءة مشروع آخر تُرجع permission_denied.
إذا فقدت الوصول إلى مشروع معتمد، يوقف LogBrew القراءات من هذا المشروع.
رمز الوصول المميز صالح لمدة ساعة واحدة. يحصل Claude Code على رمز جديد تلقائيًا ما دمت تستخدم الاتصال.
ينتهي الاتصال بعد 30 يومًا دون استخدام، أو بعد 90 يومًا من موافقتك عليه. عندها سجّل الدخول مرة أخرى باستخدام claude mcp login logbrew.
كل تحديث للرمز المميز يستبدل رمز التحديث السابق. إذا أرسل عميل رمز تحديث مستبدلًا، ينهي LogBrew الاتصال. هذا يمنع الرمز المنسوخ من العمل. سجّل الدخول مرة أخرى لبدء اتصال جديد.
الطلبات الكثيرة بلا رمز مميز صالح تحصل على HTTP 429 مع الترويسة Retry-After. انتظر عدد الثواني المذكور، ثم أعد المحاولة.

عرض الاتصالات وإبطالها

أدِر الاتصالات من الإعدادات > اتصالات MCP في لوحة التحكم في LogBrew، أو باستخدام CLI.

من الإعدادات

يعرض كل عميل متصل اسمه، والمشاريع المعتمدة، ووقت اتصاله، وآخر وقت استُخدم فيه، وموعد انتهاء الاتصال. لإبطال اتصال، اختر قطع الاتصال، ثم أكّد. يفقد العميل الوصول عند طلبه التالي.

باستخدام CLI

استخدم LogBrew CLI 0.1.82 أو أحدث. سجّل الدخول أولًا باستخدام logbrew login. لا يستطيع مفتاح استيعاب المشروع عرض الاتصالات أو إبطالها. اعرض عملاء MCP المتصلين بحسابك:

logbrew mcp grants

MCP grants (1)
- id=00000000-0000-4000-8000-000000000001 client=Claude Code projects=2 last_used=2026-10-15T09:30:00Z expires=2026-11-14T09:30:00Z
Next: run logbrew mcp revoke <grant_id> --yes

تسمّي CLI الاتصال grant. ويعرض كل grant ما يلي:

id: معرّف الـ grant. استخدمه لإبطال الاتصال.
client: اسم العميل الذي وافقت عليه، مثل Claude Code. الاتصال الذي اعتُمد قبل أن يخزّن LogBrew الأسماء يعرض عنوان URL الذي يعرّف العميل، مثل https://claude.ai/oauth/claude-code-client-metadata.
projects: عدد المشاريع المعتمدة.
last_used: آخر وقت حصل فيه العميل على رمز وصول مميز جديد.
expires: الوقت الذي ينتهي فيه الاتصال إذا لم يستخدمه العميل.

أضف --json للحصول على القائمة كاملة. لكل grant الحقول id وclient_id وclient_name وproject_ids وcreated_at وlast_used_at وexpires_at. قيمة client_name هي null للاتصال الذي اعتُمد قبل أن يخزّن LogBrew الأسماء. أبطل اتصالًا واحدًا:

logbrew mcp revoke <grant_id> --yes

يفقد العميل الوصول عند طلبه التالي. لربطه مرة أخرى، سجّل الدخول مجددًا باستخدام claude mcp login logbrew. لتغيير المشاريع المعتمدة، أبطل الاتصال. ثم سجّل الدخول مرة أخرى واختر المشاريع الجديدة.

إزالة الخادم

أبطل الاتصال من الإعدادات > اتصالات MCP، أو باستخدام logbrew mcp revoke <grant_id> --yes.
أزل الخادم من Claude Code:
claude mcp remove logbrew

يحذف claude mcp remove الإعدادات والرموز المميزة من حاسوبك فقط. ولا ينهي الاتصال في LogBrew. إذا لم تبطله، ينتهي الاتصال بعد 30 يومًا دون استخدام.

إصلاح مشكلات الاتصال

المشكلة	الحل
يعرض `claude mcp list` الرسالة `Needs authentication`.	شغّل `claude mcp login logbrew`.
يطلب منك Claude Code تسجيل الدخول مرة أخرى بعد فترة من الاستخدام.	انتهى الاتصال أو أُبطل. شغّل `claude mcp login logbrew`، أو اختر Re-authenticate في `/mcp`.
يحصل العميل على `client access denied`.	استخدم عميلًا معتمدًا. حاليًا، Claude Code هو العميل المعتمد الوحيد.
يفشل الاتصال بعد تسجيل الدخول.	حدّث Claude Code إلى 2.1.300 أو أحدث.
تعرض صفحة التفويض `You have no projects to share`.	أنشئ مشروعًا في LogBrew، ثم ابدأ تسجيل الدخول مرة أخرى.
تُرجع القراءة `permission_denied`.	المشروع غير معتمد لهذا الاتصال. أبطل الاتصال، ثم سجّل الدخول مرة أخرى واختر المشروع.
لا تُرجع القراءة أي بيانات.	تأكد من أن المشروع يرسل بيانات القياس عن بُعد. النتيجة الفارغة لا تثبت أن التطبيق يعمل.
يعرض `logbrew mcp grants` الرسالة `not logged in` أو يُرجع `unauthorized`.	شغّل `logbrew login`، ثم أعد المحاولة.

البدء

المفاهيم

التثبيت والإرسال

التحقيق

CLI والوكلاء

الدعم

ربط وكيل ذكاء اصطناعي عبر MCP

قبل أن تبدأ

ربط Claude Code

الطلب من الوكيل

الوصول ومدة الاتصال

عرض الاتصالات وإبطالها

من الإعدادات

باستخدام CLI

إزالة الخادم

إصلاح مشكلات الاتصال

​قبل أن تبدأ

​ربط Claude Code

​الطلب من الوكيل

​الوصول ومدة الاتصال

​عرض الاتصالات وإبطالها

​من الإعدادات

​باستخدام CLI

​إزالة الخادم

​إصلاح مشكلات الاتصال

قبل أن تبدأ

ربط Claude Code

الطلب من الوكيل

الوصول ومدة الاتصال

عرض الاتصالات وإبطالها

من الإعدادات

باستخدام CLI

إزالة الخادم

إصلاح مشكلات الاتصال