الأدوات

عندما تكتب رسالة إلى ذكاء اصطناعي، يولّد نصًا. هذا كل شيء — بمفرده، لا يستطيع إلا إنتاج كلمات. لكن الكلمات لا تكفي دائمًا. أحيانًا تحتاج إلى أن يفعل الذكاء الاصطناعي شيئًا فعليًا: يبحث عن طقس اليوم، أو يبحث في الويب، أو يقرأ ملفًا، أو يستدعي API.

هذا هو دور الأدوات. الأداة دالة يستدعيها الذكاء الاصطناعي عندما يقرر أنها مطلوبة — يتعرّف على الموقف، ويختار الأداة المناسبة، ويشغّلها، ويستخدم النتيجة ليعطيك إجابة أفضل. يُسمّى هذا أحيانًا “function calling” أو “tool use.”

يأتي OpenCode بأدوات مدمجة لأشياء مثل قراءة الملفات وتحرير التعليمات البرمجية وتشغيل أوامر الصدفة. لكن يمكنك توسيعه بأدوات خارجية أيضًا، باستخدام معيار يُسمّى MCP (Model Context Protocol). خادم MCP برنامج صغير يتيح أدوات للذكاء الاصطناعي — مثل البحث في تقويمك، أو الاستعلام من قاعدة بيانات، أو جلب بيانات حيّة من الويب. تربط خادم MCP بـ OpenCode مرة واحدة، فتصبح تلك الأدوات متاحة في كل جلسة.

نوعان من خوادم MCP

الخوادم المحلية تعمل كعملية على جهازك. يبدأها OpenCode تلقائيًا عند التشغيل باستخدام أمر تحدده في إعداداتك — عادة npx متبوعًا باسم حزمة. الخوادم المحلية شائعة للأدوات التي تحتاج وصولًا إلى نظام ملفاتك أو بيئتك المحلية.

الخوادم البعيدة تعمل في السحابة. تتصل بها عبر URL — دون الحاجة إلى عملية محلية. تنشر خدمات كثيرة خوادم MCP بعيدة حتى تمنح وكيلك وصولًا إلى منصتها دون تثبيت أي شيء.

عامة مقابل تتطلب مصادقة

الخوادم العامة لا تتطلب بيانات اعتماد. تضيفها إلى إعداداتك وتعمل فورًا.

الخوادم المصادق عليها برمز تتطلب مفتاح API. تضيف المفتاح إلى إعداداتك، عادة عبر متغير بيئة حتى لا يُخزَّن كنص واضح.

خوادم OAuth تفتح متصفحًا لتسجيل الدخول إلى الخدمة. يتولى OpenCode تدفق OAuth تلقائيًا — يكتشف متى تكون المصادقة مطلوبة ويطلب منك إكمالها.

أضف خادم MCP للطقس

لنثبّت خادم MCP محليًا يجلب بيانات الطقس الحيّة من Open-Meteo — وهو API طقس مجاني وعام لا يتطلب حسابًا ولا مفتاح API.

رغم أن خوادم MCP تُدار في إعدادات OpenCode العامة، فلست مضطرًا إلى تعديل الملف بنفسك — يمكنك أن تطلب من OpenCode فعل ذلك. جرّب أن تطلب منه إضافة ما يلي إلى ~/.config/opencode/opencode.json:

"mcp": {
  "open-meteo": {
    "type": "local",
    "command": ["npx", "-y", "-p", "open-meteo-mcp-server", "open-meteo-mcp-server"]
  }
}

هذا يخبر OpenCode بتشغيل حزمة open-meteo-mcp-server عبر npx في كل مرة يبدأ فيها. يعمل الخادم محليًا على جهازك ويتصل بـ API الخاصة بـ Open-Meteo عندما تُستدعى أداة طقس.

يتطلب هذا Node.js 22 أو أحدث. إن لم يكن مثبتًا لديك، اطلب من OpenCode مساعدتك في تثبيته لنظام تشغيلك.

تحقّق باستخدام /mcp

بعد إضافة خادم، اكتب /mcp في OpenCode لرؤية قائمة بخوادم MCP المضبوطة وحالة اتصالها. هذه عادة جيدة — افتحها بعد تثبيت خادم جديد للتأكد من أنه متصل، وإن لزم الأمر، مصادق عليه.

أعد تشغيل OpenCode

تتصل خوادم MCP عند بدء التشغيل. أغلق OpenCode Desktop وأعد فتحه، ثم استخدم الموجّه أدناه للمتابعة.

جرّبه

بعد العودة، اسأل OpenCode شيئًا مثل:

ما توقعات الطقس لطوكيو هذا الأسبوع؟

راقب الواجهة بينما يرد OpenCode — يفترض أن ترى استدعاء أداة إلى خادم الطقس، وجلب البيانات، واستخدام النتيجة في إجابته. هذا هو الذكاء الاصطناعي وهو يقرر أن أداة مطلوبة، ويستدعيها، ويعمل بما يعود. هذا ما يميّز الوكيل عن روبوت المحادثة.

إذا كانت لديك عدة أدوات متاحة، فقد لا يختار النموذج دائمًا تلك التي تتوقعها. يمكنك توجيهه بذكر الأداة بالاسم — مثل: «استخدم خادم open-meteo MCP للتحقق من الطقس في طوكيو.» هذا يجعل النموذج أكثر ميلًا إلى تلك الأداة تحديدًا بدلًا من الإجابة من بيانات تدريبه أو اختيار أداة أخرى.

ملاحظة حول السياق

كل خادم MCP تضيفه يسجّل أدواته لدى النموذج في بداية كل جلسة. مع تفعيل خوادم كثيرة، يمكن أن تأخذ أوصاف تلك الأدوات جزءًا ملحوظًا من نافذة السياق. توصي وثائق OpenCode بأن تكون انتقائيًا — فعّل فقط الخوادم التي تستخدمها بانتظام.

اعثر على مزيد من خوادم MCP

تتضمن وثائق OpenCode حول MCP أمثلة إعدادات جاهزة للاستخدام لـ Sentry وContext7 وGrep. للاكتشاف الأوسع، يفهرس سجل MCP الرسمي آلاف الخوادم عبر فئات مثل قواعد البيانات وأدوات المطوّرين والإنتاجية — بدعم من Anthropic وGitHub وMicrosoft.

يمكنك أيضًا أن تطلب من OpenCode العثور على خوادم MCP وتثبيتها نيابة عنك — صف ما تحتاجه، ويمكنه البحث عن خادم وإضافته إلى إعداداتك.

إعادة ربط الخوادم المصادق عليها

بعض خوادم MCP تتطلب مصادقة لتعمل. قد تنتهي صلاحية ذلك الاتصال، وعندما يحدث ذلك يتوقف الخادم عن العمل بصمت. قد يصعب تذكّر الأوامر الدقيقة لإعادة المصادقة.

هذا استخدام جيد لملف ~/.config/opencode/AGENTS.md العام: أضف تعليمات منظّمة تذكّر OpenCode كيف يعيد الاتصال. اطلب من OpenCode إضافة قسم “MCP authentication” إلى AGENTS.md العام بإرشادات مثل:

• عند استكشاف مشكلات اتصال MCP، اقرأ إعدادات OpenCode للعثور على أسماء الخوادم، ثم أعطني الأوامر الدقيقة للتشغيل (مثل opencode mcp auth sentry، وليس opencode mcp auth <server-name>).
• أوامر ذات صلة: opencode mcp auth <name> وopencode mcp auth list وopencode mcp logout <name> وopencode mcp debug <name>.

بمجرد أن تكون في AGENTS.md، سيعرف OpenCode كيف يساعدك على إعادة الاتصال في أي وقت ينقطع فيه خادم.