دليل · نحو 3 دقائق

كيف تربط Onplana بـGemini CLI وCode Assist

تثبيت في سطر واحد. يتضمن Onplana بيان امتداد Gemini في جذر المستودع، فالإعداد كله هو:gemini extensions install <repo>.

بعدها يمكنك أن تطلب من Gemini أشياء مثل "لخّص مهامي المتأخرة في Onplana"، أو "أنشئ خطة مشروع لإطلاق Q3 مع 5 معالم أسبوعية"، أو "اعرض أعضاء فريقي في مشروع منصة البيانات"، فينفذ Gemini ذلك مباشرة في Onplana.

افتح Onplana ← الإعدادات ← الوكلاء Gemini CLI على GitHub

باختصار: ثلاثة أوامر

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

الخطوات المفصلة أدناه.

الخطوات الخمس بالتفصيل

  1. 1

    ثبّت Gemini CLI (إن لم يكن لديك)

    على macOS / Linux: npm install -g @google/gemini-cli. وعلى Windows: الأمر نفسه في وحدة تحكم فيها Node. تحقق بـ`gemini --version`. إن كنت تستخدم Gemini Code Assist في VS Code أو JetBrains، فلديك ما تحتاج إليه: يشارك Code Assist ملف الإعداد مع سطر الأوامر.

  2. 2

    أنشئ رمز اتصال من Onplana

    سجّل الدخول إلى Onplana على app.onplana.com. اذهب إلى الإعدادات ← الوكلاء ← ربط وكيل، واختر مربع Gemini CLI + Code Assist، ثم رمز وصول شخصي، ثم إنشاء رمز وعرض مقتطف الارتباط. انسخ رمز الوصول الشخصي (يبدأ بـ`pat_`). اضبطه متغير بيئة: export ONPLANA_PAT=pat_your-token-here (أضف السطر إلى ~/.bashrc أو ~/.zshrc ليبقى).

  3. 3

    ثبّت امتداد Gemini من Onplana (أمر واحد)

    شغّل: gemini extensions install https://github.com/Onplana/onplana-mcp-server. يتضمن مستودع Onplana في جذره بيان gemini-extension.json، يقرؤه Gemini CLI ليضبط الاتصال بخادم MCP تلقائيًا. أو عدّل ~/.gemini/settings.json يدويًا؛ الصيغة موثقة على developers.google.com/gemini-code-assist/docs.

  4. 4

    أعد تشغيل Gemini CLI أو أعد تحميل المحرر

    لـGemini CLI: اخرج وأعد فتح `gemini`. ولـGemini Code Assist في VS Code: Cmd/Ctrl+Shift+P ← "Developer: Reload Window". ولـJetBrains: أعد تشغيل بيئة التطوير. تظهر أدوات Onplana في منتقي /mcp بعد إعادة التشغيل.

  5. 5

    تحقق من الاتصال

    في جلسة Gemini جديدة، اطلب: "list my Onplana projects via the onplana tool". يستدعي Gemini أداة list_projects من Onplana ويعرض لك النتيجة. إن تلقيت خطأ، فتحقق من أن ONPLANA_PAT مضبوط في البيئة التي يستخدمها Gemini، ومن أن بيان الامتداد ثُبّت بشكل صحيح، بالأمر `gemini extensions list`.

أو اضبطه يدويًا

إن فضّلت عدم تثبيت الامتداد، فعدّل~/.gemini/settings.json(أو .gemini/settings.json في جذر مساحة العمل) مباشرة:

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

لاحظ أن المفتاح هو httpUrl، لا url. يستخدم Gemini CLI المفتاح httpUrl لخوادم Streamable HTTP مثل Onplana ويحجز url لخوادم SSE. ورمز Bearer في headers.Authorization يصادق كل طلب.

كيف تتحقق من أنه يعمل

افتح جلسة Gemini جديدة وجرّب أحد هذه:

  • "بأداة onplana، اعرض مشاريعي."
  • "أرني مهامي المتأخرة في Onplana."
  • "أنشئ مهمة في Onplana في المشروع X باسم 'نقل Postgres إلى Aurora'."
  • "ابحث في صفحاتي في Onplana عن ملاحظات ترحيل الواجهة البرمجية."

شغّل gemini extensions list لتتأكد من أن امتداد Onplana مثبّت. وبعد تثبيت ناجح، يُفترض أن يعرض منتقي /mcp القائمة الكاملة لأدوات Onplana.

الأسئلة الشائعة

هل يعمل مع Gemini Code Assist في VS Code؟

نعم. يشارك Gemini CLI وGemini Code Assist ملف الإعداد نفسه (~/.gemini/settings.json للمستخدم كله أو .gemini/settings.json في مساحة عمل). وتثبيت واحد بـ`gemini extensions install` يغطي الاثنين. ثم أعد تحميل نافذة VS Code (Cmd/Ctrl+Shift+P ← "Developer: Reload Window") ليأخذ Code Assist الإعداد الجديد.

وماذا عن تطبيق Gemini على gemini.google.com؟

حتى مايو 2026 لا يدعم gemini.google.com خوادم MCP المخصصة بعد. وتوجّه Google من يريد الاتصال بخوادم MCP من جهات خارجية إلى Gemini CLI أو Gemini Code Assist. نتابع ذلك؛ وإن أضاف التطبيق دعم MCP، فسيكون التثبيت بنقرة واحدة عبر واجهة موصلات مشابهة لواجهة Claude.ai.

وماذا عن Gemini Enterprise / Vertex AI Agent Builder؟

Gemini Enterprise إعداد مختلف عن Gemini CLI: يضيف مسؤول Onplana في وحدة تحكم Google Cloud كمخزن بيانات Custom MCP Server، بمعرّف عميل OAuth وسر. إنه في وصول مبكر ويديره المسؤول، وليس خدمة ذاتية: يصدر Onplana العميل لمؤسستك عند الطلب. يتضمن الدليل على docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ الإعداد، والإجراءات التي تُفعَّل أولًا (20)، ورابط طلب الوصول.

أي خطة من Onplana تتضمن MCP؟

MCP متاح في جميع الخطط، بما فيها الخطة المجانية. ويزداد عدد اتصالات الوكلاء المتزامنة مع الخطة (Free 2، Professional 3، Business 5، Enterprise 10، Enterprise+ بلا حدود)، ورصيدك من رموز الذكاء الاصطناعي (مخصص شهري في الخطط المدفوعة، ومنحة لمرة واحدة في Free، إضافة إلى الرصيد الذي تشتريه) هو ما يحد الاستخدام الفعلي للذكاء الاصطناعي. يمكنك تغيير خطتك متى شئت على app.onplana.com/billing.

ما الفرق بين التثبيت بـgemini-extension.json وتعديل settings.json مباشرة؟

وظيفيًا هما متكافئان. تثبيت الامتداد أمر واحد ويستخدم بيانًا في جذر المستودع، فهو قابل للتكرار. وتعديل settings.json يدويًا مفيد حين تريد وضع Onplana بجانب عدة خوادم MCP (مثلًا واحد لـOnplana، وواحد لـLinear، وواحد لواجهة برمجية داخلية) في الكائن `mcpServers` نفسه. كلاهما يعمل ويشتركان في الإعداد نفسه.

لماذا يُسمى المفتاح httpUrl لا url؟

يميّز Gemini CLI بين خوادم MCP عبر stdio (المفتاح: command)، وعبر SSE (المفتاح: url)، وعبر Streamable HTTP (المفتاح: httpUrl). يستخدم خادم MCP من Onplana نقل Streamable HTTP، أحدث معايير النقل، الذي يتعامل مع الطلب والاستجابة عبر HTTPS بسيط دون SSE. والمفتاح `url` في إعدادات Claude Desktop وCursor وChatGPT هو المقابل.

هل يمكنني إلغاء الاتصال؟

نعم، بطريقتين: (1) Onplana ← الإعدادات ← الوكلاء ← الاتصالات ← إلغاء على صف الرمز. (2) أزل ONPLANA_PAT من بيئتك وشغّل أيضًا `gemini extensions uninstall onplana`. كلتاهما تسري فورًا؛ ويعيد استدعاء Gemini التالي لأي أداة الخطأ 401.

ما الأدوات التي يصل إليها Gemini؟

351 من الأدوات، وهي نفسها التي يتلقاها Claude Desktop وCursor وChatGPT: القراءة (list_projects وlist_my_tasks وget_task وsearch_org_knowledge وغيرها) والكتابة (create_task وupdate_task وassign_task وcreate_milestone وغيرها)، إضافة إلى مجالات الحوكمة، وضبط التغيير، والامتثال، والمستندات، وسير العمل. الكتالوج واحد أيًا كان العميل المتصل. تتيح الخطة بعض الأدوات؛ والكتالوج الكامل على onplana.com/mcp.

ذو صلة