اربط PinSay بأداة الذكاء الاصطناعي
لدى PinSay خادما MCP. الموصل المستضاف على https://app.pinsay.dev/mcp لا يحتاج إلى تثبيت أي شيء: تسجّل الدخول من وكيلك. أما الخادم المحلي في @pinsay/cli فيعمل عبر stdio، ويستخدم مفتاح API الخاص بك، ويضيف أدوات git. Read this guide in English
الموصل المستضاف
العنوان هو https://app.pinsay.dev/mcp. وفي PinSay المستضاف ذاتيًا يكون https://<your PinSay host>/mcp.
تسجيل الدخول: يفتح وكيلك PinSay في المتصفح، فتختار مساحة العمل وما يُسمح للوكيل بفعله (القراءة، أو القراءة والتطبيق)، ثم توافق. يمكنك فصله في أي وقت من الملف الشخصي، تحت «التطبيقات المتصلة».
اختر أداتك. تعرض كل أداة أين يوضع الإعداد، وكيف تسجّل الدخول، وكيف تتحقق من أنه يعمل، وكيف تفصله. «مُختبَر» يعني أن PinSay شغّل هذا الإعداد بالضبط من البداية إلى النهاية؛ و«لم يُختبر بعد» يعني أننا نتبع تعليمات الأداة نفسها لكننا لم نشغّلها.
Claude Code تم اختباره 2026-11-14 · 2.1.322
أين: الطرفية لديك. يحفظه Claude Code في ~/.claude.json.
قبل أن تبدأ: Claude Code مع تسجيل الدخول بخطة Claude أو بمفتاح API.
claude mcp add --transport http pinsay https://app.pinsay.dev/mcp
تسجيل الدخول: في Claude Code شغّل /mcp، واختر pinsay ثم Authenticate. يفتح المتصفح PinSay: اختر مساحة العمل ووافق.
تحقّق من الاتصال: يعرض /mcp أن pinsay متصل مع 6 أدوات.
قطع الاتصال: شغّل claude mcp logout pinsay (وهذا ينهي تسجيل الدخول من جهة PinSay أيضًا)، ثم claude mcp remove pinsay. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
يخزّن Claude Code تسجيل الدخول باسم الخادم ورابطه: إضافة pinsay مرة أخرى في مجلد آخر وتسجيل الدخول هناك تُنهي تسجيل الدخول في المجلد الأول.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
claude mcp add --transport http pinsay https://app.pinsay.dev/mcp --header "Authorization: Bearer $PINSAY_API_KEY"claude.ai تم اختباره 2026-11-13 · web للمحادثة فقط
أين: Settings → Connectors → Add custom connector. الصق الرابط.
قبل أن تبدأ: خطة Claude تسمح بالموصلات المخصصة. PinSay موجود أيضًا في دليل موصلات Claude.
https://app.pinsay.dev/mcp
تسجيل الدخول: اختر Connect وسجّل الدخول إلى PinSay في النافذة التي تُفتح.
تحقّق من الاتصال: في محادثة جديدة اسأل: «اعرض مشاريعي في PinSay».
قطع الاتصال: Settings → Connectors → PinSay → Disconnect. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
للمحادثة فقط: يقرأ claude.ai التعليقات ويرد عليها ويغيّر الحالة. لا يستطيع تعديل شيفرتك أو عمل commit لها.
opencode تم اختباره 2026-11-14 · 1.19.5
أين: الملف opencode.json في مشروعك، أو ~/.config/opencode/opencode.json لكل المشاريع.
قبل أن تبدأ: opencode مع مزوّد نماذج تستخدمه بالفعل.
{
"mcp": {
"pinsay": {
"type": "remote",
"url": "https://app.pinsay.dev/mcp",
"enabled": true
}
}
}
تسجيل الدخول: شغّل opencode mcp auth pinsay.
تحقّق من الاتصال: يعرض opencode mcp list أن pinsay متصل.
قطع الاتصال: شغّل opencode mcp logout pinsay، ثم احذف مدخل pinsay. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
جُرّبت هذه الصيغة على opencode 1.19.5. ويصف توثيق opencode الحالي أيضًا صيغة أحدث تضع الخوادم تحت mcp.servers؛ ولم تجرّبها PinSay بعد.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcp": {
"pinsay": {
"type": "remote",
"url": "https://app.pinsay.dev/mcp",
"enabled": true,
"oauth": false,
"headers": {
"Authorization": "Bearer {env:PINSAY_API_KEY}"
}
}
}
}Cursor لم يُختبر بعد
أين: الملف .cursor/mcp.json في مشروعك، أو ~/.cursor/mcp.json لكل المشاريع. أو استخدم زر Add to Cursor.
قبل أن تبدأ: Cursor مع تسجيل الدخول.
{
"mcpServers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp"
}
}
}
تسجيل الدخول: عند أول اتصال لـ pinsay يفتح Cursor صفحة PinSay في المتصفح: اختر مساحة العمل ووافق.
تحقّق من الاتصال: في Customize تُدرج pinsay أدواتها تحت Available Tools.
قطع الاتصال: أزل pinsay في Customize، أو احذف مدخلها من mcp.json. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcpServers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp",
"headers": {
"Authorization": "Bearer ${env:PINSAY_API_KEY}"
}
}
}
}VS Code (GitHub Copilot) لم يُختبر بعد
أين: الملف ~/.copilot/mcp-config.json لكل المشاريع، أو .mcp.json في جذر مساحة عمل واحدة. ضع مفتاح API في ملف المستخدم فقط، ولا تضعه أبدًا في ملف مساحة عمل تُودِعه في git.
قبل أن تبدأ: VS Code مع GitHub Copilot في وضع الوكيل. قد تحتاج مؤسستك إلى السماح بخوادم MCP.
{
"mcpServers": {
"pinsay": {
"type": "http",
"url": "https://app.pinsay.dev/mcp",
"tools": ["*"]
}
}
}
تسجيل الدخول: ابدأ جلسة وكيل Copilot؛ وعندما يطلب منك VS Code تفويض pinsay، وافق في المتصفح.
تحقّق من الاتصال: شغّل MCP: List Servers: تكون pinsay قيد التشغيل وتظهر أدواتها في منتقي الأدوات في المحادثة.
قطع الاتصال: احذف مدخل pinsay من الملف الذي أضفته إليه. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
زر Install in VS Code والملف .vscode/mcp.json يستخدمان وضع Local الأقدم في VS Code (المفتاح servers في المستوى الأعلى)، وسيزيله VS Code في فبراير 2027. لا يقرأ Copilot هذا الملف مباشرة: بل يعيد استخدام تلك الخوادم عبر تمرير المحرر، والخوادم التي تحتاج إلى مطالبات ${input:…} أو ${command:…} لا تُمرَّر. فضّل الملف أعلاه.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcpServers": {
"pinsay": {
"type": "http",
"url": "https://app.pinsay.dev/mcp",
"tools": ["*"],
"headers": {
"Authorization": "Bearer <your PinSay API key>"
}
}
}
}Antigravity CLI تم اختباره 2026-11-14 · CLI 1.5.9
أين: الملف ~/.gemini/config/mcp_config.json (يسري على كل المشاريع).
قبل أن تبدأ: Antigravity مع تسجيل الدخول بحساب Google.
{
"mcpServers": {
"pinsay": {
"serverUrl": "https://app.pinsay.dev/mcp"
}
}
}
تسجيل الدخول: في Antigravity اكتب /mcp، واختر pinsay، ثم Authenticate. سجّل الدخول إلى PinSay في المتصفح، ثم الصق الرمز الذي يعرضه في الحقل Enter authorization code.
تحقّق من الاتصال: في Antigravity اكتب /mcp: يُدرَج pinsay مع أدواته.
قطع الاتصال: احذف مدخل pinsay من ~/.gemini/config/mcp_config.json. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
جُرّب مع Antigravity CLI. يقرأ Antigravity IDE الملف نفسه، لكن PinSay لم تختبر IDE بعد. لم يقرأ CLI ملف مساحة العمل .agents/mcp_config.json، لذا استخدم الملف أعلاه. يقرأ Antigravity الحقل serverUrl (ويعمل url أيضًا). أبقِ أي ملف يحتوي مفتاح API خارج git.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcpServers": {
"pinsay": {
"serverUrl": "https://app.pinsay.dev/mcp",
"headers": {
"Authorization": "Bearer <your PinSay API key>"
}
}
}
}Codex CLI تم اختباره 2026-11-14 · 0.166.0
أين: الملف ~/.codex/config.toml، أو .codex/config.toml في مشروع موثوق.
قبل أن تبدأ: Codex CLI مع تسجيل الدخول.
[mcp_servers.pinsay]
url = "https://app.pinsay.dev/mcp"
تسجيل الدخول: شغّل codex mcp login pinsay.
تحقّق من الاتصال: يعرض codex mcp list الخادم pinsay؛ وفي Codex يسرد /mcp أدواته.
قطع الاتصال: شغّل codex mcp logout pinsay، ثم codex mcp remove pinsay. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
[mcp_servers.pinsay]
url = "https://app.pinsay.dev/mcp"
bearer_token_env_var = "PINSAY_API_KEY"Gemini CLI لم يُختبر بعد
أين: الملف ~/.gemini/settings.json، أو .gemini/settings.json في مشروع.
قبل أن تبدأ: Gemini CLI مع تسجيل الدخول (راجع دليل المصادقة الخاص به).
{
"mcpServers": {
"pinsay": {
"httpUrl": "https://app.pinsay.dev/mcp"
}
}
}
تسجيل الدخول: في Gemini CLI شغّل /mcp auth pinsay.
تحقّق من الاتصال: يسرد /mcp الخادم pinsay وأدواته.
قطع الاتصال: شغّل gemini mcp remove pinsay. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
إن قال Google إن حسابك لم يعد مدعومًا في Gemini CLI، فسجّل الدخول بمفتاح Gemini API بدلًا من ذلك، أو استخدم خطوات Antigravity. لم تُكمل PinSay اختبار Gemini CLI بعد.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcpServers": {
"pinsay": {
"httpUrl": "https://app.pinsay.dev/mcp",
"headers": {
"Authorization": "Bearer <your PinSay API key>"
}
}
}
}Devin Local (formerly Windsurf) لم يُختبر بعد
أين: الملف ~/.config/devin/mcp_config.json لكل المشاريع، أو .devin/mcp_config.local.json في مشروع واحد (مُتجاهَل في git).
قبل أن تبدأ: Devin Local (تطبيق سطح المكتب أو devin CLI) مع تسجيل الدخول.
{
"mcpServers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp"
}
}
}
تسجيل الدخول: شغّل devin mcp login pinsay، أو اختر Authenticate في Customize → MCPs.
تحقّق من الاتصال: يعرض devin mcp list الخادم pinsay؛ أو اطلب من الوكيل سرد أدوات MCP لديه.
قطع الاتصال: شغّل devin mcp remove pinsay. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
توثيق MCP في Windsurf يقود الآن إلى Devin Local، لذا هذه الخطوات خاصة بـ Devin Local (انتقل إعداده في الإصدار v3000.3). إصدارات Windsurf الأقدم غير مشمولة.
Zed لم يُختبر بعد
أين: إعدادات Zed (الأمر zed: open settings file)، أو Settings → AI → MCP Servers → Add Server → Add Remote Server.
قبل أن تبدأ: وكيل Zed المدمج مع نموذج تستخدمه بالفعل.
{
"context_servers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp"
}
}
}
تسجيل الدخول: إن لم تضبط ترويسة Authorization، يطلب منك Zed تسجيل الدخول عند تشغيل pinsay؛ وافق في المتصفح.
تحقّق من الاتصال: تعرض Settings → AI → MCP Servers نقطة خضراء: Server is active.
قطع الاتصال: احذف مدخل pinsay من context_servers. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"context_servers": {
"pinsay": {
"url": "https://app.pinsay.dev/mcp",
"headers": {
"Authorization": "Bearer <your PinSay API key>"
}
}
}
}Cline لم يُختبر بعد
أين: Cline → MCP Servers → Configure → Configure MCP Servers (الملف cline_mcp_settings.json).
قبل أن تبدأ: إضافة Cline مع مزوّد نماذج تستخدمه بالفعل.
{
"mcpServers": {
"pinsay": {
"type": "streamableHttp",
"url": "https://app.pinsay.dev/mcp",
"disabled": false,
"autoApprove": []
}
}
}
تسجيل الدخول: عند اتصال pinsay يعرض Cline تفويضه؛ وافق في المتصفح.
تحقّق من الاتصال: تسرد MCP Servers الخادم pinsay مع أدواته؛ شغّل إحداها.
قطع الاتصال: احذف pinsay في MCP Servers، أو اضبط "disabled": true. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
استخدم مفتاح API بدلًا من ذلك
أنشئ مفتاحًا بصلاحيتي القراءة والتطبيق من الملف الشخصي ← مفاتيح API، ولا تضعه في git.
{
"mcpServers": {
"pinsay": {
"type": "streamableHttp",
"url": "https://app.pinsay.dev/mcp",
"headers": {
"Authorization": "Bearer <your PinSay API key>"
},
"disabled": false,
"autoApprove": []
}
}
}ChatGPT لم يُختبر بعد للمحادثة فقط
أين: chatgpt.com/plugins → + → Add custom MCP server. الصق الرابط.
قبل أن تبدأ: حساب ChatGPT أو مساحة عمل تسمح سياساتها بخوادم MCP المخصصة.
https://app.pinsay.dev/mcp
تسجيل الدخول: تحت Connection اختر OAuth، واقرأ التحذير، واختر I understand and want to continue، ثم Create as a plugin. سجّل الدخول إلى PinSay.
تحقّق من الاتصال: راجع الأدوات الستة التي وجدها ChatGPT.
قطع الاتصال: أزل الإضافة في ChatGPT. ثم أزل PinSay من الملف الشخصي ← التطبيقات المتصلة.
للمحادثة فقط: يقرأ ChatGPT التعليقات ويرد عليها ويغيّر الحالة. لا يستطيع تعديل شيفرتك أو عمل commit لها.
مفتاح API بدلًا من تسجيل الدخول
أرسل Authorization: Bearer <your PinSay API key> مع كل طلب. مثلًا في Claude Code:
claude mcp add --transport http pinsay https://app.pinsay.dev/mcp --header "Authorization: Bearer $PINSAY_API_KEY"
المفتاح الذي يملك صلاحية القراءة فقط يستطيع قراءة التعليقات، لكنه لا يستطيع وضع علامة «مُطبَّق» ولا الرد ولا تغيير الحالة؛ وتعيد هذه الاستدعاءات forbidden. راجع API Keys.
الحدود
- يُحتسب كل استدعاء أداة طلب MCP واحدًا من طلبات MCP الشهرية لمساحة العمل. يظهر العدد في الإعدادات ← الاستخدام، ويُصفَّر في اليوم الأول من كل شهر (UTC). لا يُحتسب عرض قائمة الأدوات والموجّهات والموارد.
- عندما تستهلك مساحة العمل كل طلباتها، تعيد استدعاءات الأدوات
quota_exceededمع الحد وتاريخ التصفير. - حد المعدّل: 240 طلبًا في الدقيقة لكل مستخدم ومساحة عمل.
إذا حدثت مشكلة
- القائمة فارغة
- لا تحتوي القائمة إلا التعليقات في حالة جاهز للتطبيق. افتح التعليق في PinSay وانقله إلى «جاهز للتطبيق»، أو اطلب من وكيلك سرد التعليقات حسب الحالة. ولا ينبغي للوكيل أن يوسّع التصفية من تلقاء نفسه.
- «Project not found» أو يسألك الوكيل عن المشروع
- اطلب من الوكيل سرد مشاريعك وسمِّ أحدها بمفتاحه. مفتاح API المقصور على بعض المشاريع لا يرى إلا تلك المشاريع.
- رُفض تسجيل الدخول أو انتهت صلاحيته
- شغّل خطوة تسجيل الدخول في أداتك مرة أخرى (مذكورة تحت أداتك أعلاه). وإذا أزلت التطبيق من الملف الشخصي ← التطبيقات المتصلة، فعليك تسجيل الدخول من جديد. أما مفتاح API الذي أُلغي فيتوقف عن العمل فورًا؛ أنشئ مفتاحًا جديدًا.
forbiddenعند الرد أو تغيير الحالة أو وضع علامة «مُطبَّق»- الاتصال يملك صلاحية القراءة فقط. سجّل الدخول من جديد واسمح بالقراءة والتطبيق، أو استخدم مفتاحًا بصلاحيتي القراءة والتطبيق. لا تستخدم لهذا مفتاحًا بصلاحية الوصول الكامل.
- الأداة لا تعرض تسجيل الدخول، أو ترفض الخادم
- حدّث الأداة: يحتاج MCP البعيد مع تسجيل الدخول إلى إصدار حديث. وإذا كانت مؤسستك تدير الأداة، فقد يلزم أن يسمح المسؤول بخوادم MCP. وإلا فاستخدم خيار مفتاح API تحت أداتك.
quota_exceeded- استهلكت مساحة العمل طلبات MCP لهذا الشهر. يذكر الخطأ الحد وتاريخ التصفير. انتظر التصفير؛ ولا تعِد المحاولة في حلقة.
الخادم المحلي (stdio)
استخدم الخادم المحلي لأدوات git (pinsay_commit_and_mark وpinsay_resolve_source) أو للعمل بمفتاح API. اضبطه على مستوى المستخدم، ولا تضعه أبدًا في المستودع. الإعدادات لكل أداة وقائمة الأدوات الكاملة في الدليل الإنجليزي (Local server).
المستضاف أم المحلي؟
- لا يشغّل الخادم المستضاف git أبدًا ولا يلمس ملفاتك. يعدّل وكيلك ويُنشئ الـ commit في مستودعك بأدواته، ثم يستدعي
pinsay_mark_appliedمع رابط الـ commit. - تعود لقطات الشاشة والملفات الأخرى كروابط موقّعة (صالحة لمدة ساعة)؛ وتكون
pathفارغة دائمًا على الخادم المستضاف. - يمكن حذف
projectعندما تحتوي مساحة العمل على مشروع واحد. - يضيف الخادم المحلي
pinsay_get_step_sequenceوpinsay_commit_and_markوpinsay_resolve_sourceوpinsay_doctorوpinsay_list_projects.