اربط Claude وChatGPT بأسعار الذهب المباشرة عبر MCP

لماذا يحتاج المساعد إلى أداة للأسعار

اسأل مساعد محادثة عن سعر الذهب اليوم دون أي أدوات، وستحصل على واحدة من ثلاث إجابات: رفض، أو رقم من بيانات تدريبه، أو تخمين يُقدَّم بثقة تفوق ما يستحقه. ولا تفيدك أي منها. فالنموذج اللغوي يتعلم من لقطة نصية تنتهي قبل أشهر من حديثك معه، بينما تتحرك أسعار الذهب والفضة والنفط كل بضع ثوانٍ ما دامت الأسواق مفتوحة.

الحل المعتاد هو أن تبحث عن السعر بنفسك ثم تلصقه في المحادثة. ينجح ذلك لسؤال واحد ثم ينهار. فعليك أن تتذكر الوحدة التي نسختها (أونصة تروي أم غرام؟)، والعملة، ووقت أخذ الرقم. واسأل سؤالًا لاحقًا عن نطاق الشهر الماضي، أو عن التحويل إلى الليرة التركية، وستعود إلى المتصفح من جديد.

يُلغي بروتوكول سياق النموذج (MCP) هذه الخطوة. إذ يحصل المساعد على مجموعة صغيرة من الأدوات يمكنه استدعاؤها بنفسه، وتُبنى كل إجابة على استجابة API حديثة تحمل طابعها الزمني وعملة الأساس والوحدة الخاصة بها. توضح هذه المقالة كيفية ربط Claude وChatGPT وClaude Code وCursor وVS Code بخادم MetalAPI MCP، وما الذي يستطيع المساعد فعله بعد الاتصال، وما الضمانات المطبقة.

ما هو MCP

MCP بروتوكول مفتوح قدّمته Anthropic في عام 2024، وتدعمه اليوم تطبيقات ذكاء اصطناعي كثيرة، ويوحّد الطريقة التي يتواصل بها المساعد مع الأدوات والبيانات الخارجية. ينشر خادم MCP قائمة بالأدوات. لكل أداة اسم ووصف بلغة واضحة ومخطط JSON لوسائطها وتعليقات توضيحية اختيارية مثل «للقراءة فقط». أما عميل MCP (Claude وChatGPT وCursor وVS Code وغيرها) فيقرأ تلك القائمة، ويترك للنموذج تحديد متى تكون الأداة مناسبة، ويرسل الاستدعاء إلى الخادم ثم يعيد النتيجة إلى النموذج.

النموذج نفسه لا يرى بيانات اعتمادك أبدًا ولا يتواصل مع الواجهة مباشرةً. بل يُنتج طلبًا منظّمًا مثل «استدعِ get_latest_prices مع symbols: XAU وbase: EUR»، فينفّذه العميل، ويكتب النموذج إجابته انطلاقًا من JSON الذي يعود.

يقع خادم MetalAPI على https://metalapi.com/mcp. ويعمل عبر Streamable HTTP، وهو بروتوكول النقل البعيد المحدد في مواصفة MCP، كما أنه عديم الحالة: كل استدعاء طلب HTTPS مستقل باستجابة JSON، فلا توجد جلسة طويلة الأمد يلزم إبقاؤها نشطة. والخادم مُدرج في سجل MCP الرسمي باسم com.metalapi/metalapi. وإذا فتحت عنوان URL في متصفح، فسيُعاد توجيهك إلى صفحة النظرة العامة الذكاء الاصطناعي وMCP.

سجّل الدخول عبر OAuth أو استخدم مفتاح API

كل استدعاء للخادم يخضع للمصادقة. وهناك طريقتان لذلك، وتعتمد الطريقة المناسبة على العميل:

• OAuth 2.1 (تسجيل الدخول) للتطبيقات التي تتضمن شاشة للموصلات، مثل Claude وChatGPT. يكتشف العميل خادم التفويض بنفسه: يتلقى الاستدعاء غير المُصادَق استجابة 401 مع ترويسة WWW-Authenticate تشير إلى البيانات الوصفية للمورد المحمي على الخادم. ثم يسجّل العميل نفسه عبر التسجيل الديناميكي للعملاء ويفتح صفحة تسجيل الدخول إلى MetalAPI. يستخدم هذا التدفق PKCE، فلا حاجة إلى تضمين سر عميل في التطبيق. تسجّل الدخول، أو تنشئ حسابًا مجانيًا، ثم توافق على الاتصال.
• مفتاح API لأدوات المطورين التي تتيح ضبط ترويسات HTTP، مثل Claude Code وCursor وVS Code. ترسل المفتاح نفسه الذي تستخدمه مع REST API على الشكل Authorization: Bearer mk_live_….

يؤدي الطريقان إلى الحساب والخطة والحصة نفسها. لكن ثمة فرق واحد في قائمة الأدوات: لا تُتاح create_api_key إلا في اتصالات OAuth. فالمفتاح المنسوخ إلى ملف إعدادات لا ينبغي أن يتمكن أبدًا من إنشاء مفاتيح أخرى، لذا يرى الاتصال القائم على المفتاح اثنتي عشرة أداة بدلًا من ثلاث عشرة.

ربط Claude وChatGPT

بالنسبة إلى Claude على claude.ai وفي Claude Desktop:

1. افتح Settings → Connectors واختر Add custom connector.
2. سمِّه MetalAPI وأدخل https://metalapi.com/mcp.
3. انقر Connect، وسجّل الدخول إلى MetalAPI (أو أنشئ حسابًا مجانيًا)، ثم انقر Allow.

أما في ChatGPT، فافتح Settings → Apps & Connectors وأنشئ موصلًا في وضع المطور باستخدام عنوان URL https://metalapi.com/mcp والمصادقة عبر OAuth. يفتح ChatGPT صفحة تسجيل الدخول إلى MetalAPI؛ وافق على الاتصال لتصبح الأدوات متاحة في محادثاتك. وتعتمد إمكانية إضافة موصلات مخصصة على خطة ChatGPT لديك، وفي مساحات العمل على ما يسمح به المسؤول.

تتغير أسماء القوائم في التطبيقين من وقت لآخر. ويُحدَّث دليل إعداد MCP باستمرار بالخطوات الحالية لكل عميل.

في محادثتك الأولى، يفيد أن تذكر المصدر («باستخدام MetalAPI، كم…») حتى يلجأ المساعد إلى الأداة بدلًا من ذاكرته. وبعد ذلك، يختار معظم المساعدين الأداة من تلقاء أنفسهم كلما تعلق السؤال بسعر.

ربط Claude Code وCursor وVS Code

تعتمد مساعدات البرمجة عادةً على مفتاح API. أنشئ مفتاحًا في لوحة التحكم (خطة Free تكفي للبدء) واستخدم مفتاحًا منفصلًا لكل أداة، حتى تتمكن من إلغاء أحدها دون تعطيل البقية.

في Claude Code، أضف الخادم من الطرفية:

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

إذا كنت تفضّل عدم تخزين مفتاح، فأضف الخادم دون --header وشغّل /mcp داخل Claude Code لتسجيل الدخول عبر OAuth بدلًا من ذلك.

في Cursor، أضف الخادم إلى ~/.cursor/mcp.json، أو إلى .cursor/mcp.json داخل مشروع:

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

في VS Code مع GitHub Copilot، احفظ ما يلي باسم .vscode/mcp.json. تجعل كتلة inputs محرر VS Code يطلب المفتاح مرة واحدة ويخزّنه بأمان، فلا يُكتب المفتاح في الملف نفسه أبدًا:

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

تتبع العملاء الأخرى التي تدعم خوادم MCP البعيدة عبر Streamable HTTP، مثل Windsurf، النمط نفسه: عنوان URL للخادم مع ترويسة Bearer أو تسجيل الدخول عبر OAuth.

كيف تبدو المحادثة

بعد الاتصال، تسأل بلغة طبيعية ويختار المساعد الأداة ووسائطها. إليك بعض الأسئلة النموذجية والاستدعاءات التي تؤدي إليها:

تُرجع أدوات الأسعار JSON مضغوطًا. تسرد كتلة rates في REST API كل رمز مرتين، كسعر وكمقلوب له، لأغراض التوافق مع التكاملات الأقدم. أما خادم MCP فلا يحتفظ إلا بالأسعار، مفهرسةً حسب الرمز، ضمن prices. وهذا يخفض عدد الرموز المميزة (tokens) إلى النصف تقريبًا ويزيل أكثر أسباب سوء قراءة البيانات شيوعًا. يُرجع استدعاء get_latest_prices مع symbols: XAU,XAG وbase: EUR وunit: gram نتيجة كهذه:

{
  "success": true,
  "timestamp": 1792834892,
  "date": "2026-10-24",
  "base": "EUR",
  "unit": "gram",
  "rate_limit": {
    "limit": 10000,
    "remaining": 9874,
    "reset": 1793491200,
    "used": 126,
    "plan": "Standard",
    "reset_date": "2026-11-01T00:00:00.000Z"
  },
  "prices": {
    "XAU": 110.4064149,
    "XAG": 1.489616277
  }
}

ولأن كل استجابة تحمل timestamp وbase وunit، فإن الإجابة الجيدة تذكر أن الذهب كان نحو €110 للغرام في وقت محدد، لا مجرد «€110». وإذا أغفلت إجابة ما هذا السياق، فاطلبه.

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

الأدوات الثلاث عشرة

يتيح الخادم ثلاث عشرة أداة. سبع منها تُرجع بيانات السوق وتُحتسب كل منها طلبًا واحدًا من الحصة الشهرية لخطتك، تمامًا مثل استدعاء REST. أما البقية فمجانية.

عند اتصال العميل، يرسل الخادم أيضًا تعليمات موجزة: معنى رموز الأصول، وأن أسعار المعادن لكل أونصة تروي ما لم تُحدَّد وحدة أخرى، وأن أدوات البيانات تستهلك من الحصة. يمرّر العملاء هذه التعليمات إلى النموذج، ولهذا يطلب المساعد المنضبط الرموز التي يحتاجها فقط. فالرموز الأقل تعني إجابات أقصر وعددًا أقل من الرموز المميزة (tokens).

الأمان: للقراءة فقط افتراضيًا، ولا مدفوعات

ربط مساعد بحساب يثير سؤالًا مشروعًا: ما الذي يمكنه تغييره؟ وقد صُمّم الخادم بحيث تكون الإجابة قصيرة.

• إحدى عشرة أداة من أصل ثلاث عشرة للقراءة فقط. تحمل التعليق التوضيحي readOnlyHint في MCP، ولا يمكنها إلا قراءة الأسعار وخطتك واستخدامك وتفاصيل المفاتيح المخفية جزئيًا.
• أداتا الكتابة تطلبان التأكيد أولًا. create_api_key وget_upgrade_link مصنّفتان كإجراءات تُحدث تغييرًا، لذا يطلب عملاء MCP تأكيدك قبل تشغيلهما.
• لا يفرض الخادم أي رسوم على الإطلاق. تنشئ get_upgrade_link جلسة دفع في Stripe للخطة التي طلبتها، أو رابط بوابة الفوترة إذا كنت مشتركًا بالفعل، وتُرجع عنوان URL. تفتحه أنت، وتتحقق من السعر، وتدفع بنفسك. ولا يستطيع المساعد إتمام أي عملية دفع.
• المفاتيح الجديدة تُعرض مرة واحدة. يُرجَع المفتاح الذي تنشئه create_api_key كاملًا مرة واحدة فقط، كما في لوحة التحكم، ولا تُخزَّن إلا قيمة تجزئته.
• نطاق محدود. لا يصل الاتصال إلا إلى MetalAPI: الأسعار وخطتك واستخدامك ومفاتيح API. ولا يرى الخادم محادثاتك أو ملفاتك أو موصلاتك الأخرى أبدًا.
• يُسجَّل مثل حركة API. تظهر استدعاءات بيانات السوق في سجل الطلبات بلوحة التحكم على شكل /mcp/ متبوعًا باسم الأداة، إلى جانب طلبات REST.

ثمة عادة عامة في MCP تستحق الالتزام بها مع أي خادم: اقرأ طلبات التأكيد التي يعرضها عميلك بدلًا من الموافقة عليها تلقائيًا، وأزل الموصلات التي لم تعد تستخدمها.

الحصص وحداثة البيانات والخطط

تستهلك استدعاءات MCP من الحصة نفسها التي يستهلك منها REST API. يكلّف استدعاء أداة البيانات طلبًا واحدًا مهما كان عدد الرموز التي يُرجعها، بينما لا تكلّف list_symbols وأدوات الحساب شيئًا. وتنطبق أيضًا حدود الطلبات في الدقيقة، بدءًا من 10 طلبات في الدقيقة في خطة Free.

تكون الأسعار حديثة بقدر ما تسمح به خطتك. في خطة Free يرى المساعد أسعارًا يومية؛ وتتحدث الخطط المدفوعة من كل 30 دقيقة وصولًا إلى كل 5 ثوانٍ:

تكفي مئة طلب شهريًا للأسئلة العرضية في المحادثة. أما إذا كنت تستخدم المساعد لتحليلات تسحب سلاسل كثيرة، أو تربطه بوكيل يعمل وفق جدول زمني، فاطلب منه get_account بين الحين والآخر: فهي تُبلغ عن الطلبات المستخدمة والمتبقية وموعد إعادة تعيين الحصة. وعند نفاد الحصة الشهرية، تُرجع أدوات البيانات خطأ تجاوز الحصة مع رابط للترقية حتى اليوم الأول من الشهر (UTC)، بينما تستمر أدوات الحساب في العمل. وتتضمن صفحة الأسعار المقارنة الكاملة.

لا يستغرق البدء سوى دقيقتين: سجّل للحصول على حساب مجاني، واتبع دليل إعداد MCP الخاص بعميلك، واطرح سؤالك الأول. تلخّص صفحة الذكاء الاصطناعي وMCP خطوات الإعداد، ويصف توثيق API نقاط نهاية REST التي تقف خلف كل أداة.