استخدام MetalAPI مع مساعدي الذكاء الاصطناعي (MCP)

ما الذي يفعله خادم MCP

يشغّل MetalAPI خادم Model Context Protocol على https://metalapi.com/mcp. وبعد الاتصال، يستطيع مساعدك البحث عن الأسعار اللحظية والتاريخية، وتحويل المبالغ، ورسم السلاسل الزمنية، والتحقق من خطتك واستهلاكك، وكل ذلك من داخل المحادثة.

هناك طريقتان للاتصال:

• تسجيل الدخول (OAuth): لـ Claude وChatGPT والتطبيقات الأخرى التي تدعم الموصلات المخصصة. تسجّل الدخول إلى MetalAPI (أو تنشئ حسابًا مجانيًا) وتوافق على الاتصال.
• مفتاح API: لـ Claude Code وCursor وVS Code وأي عميل يستطيع إرسال ترويسة. استخدم مفتاحًا من لوحة التحكم.

Claude (claude.ai وClaude Desktop)

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

ثم اسأل، على سبيل المثال: «ما سعر غرام الذهب باليورو اليوم؟»

ChatGPT

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

Claude Code

أضف الخادم باستخدام مفتاح API الخاص بك:

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

# Or sign in instead of using a key: add it without --header, then run /mcp in Claude Code.

Cursor

أضف MetalAPI إلى ~/.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؛ سيطلب 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}" }
    }
  }
}

الأدوات

• get_latest_prices، get_historical_prices، convert، get_timeseries، get_fluctuation، get_ohlc، get_carat_prices: بيانات السوق. يُحتسب كل استدعاء طلبًا واحدًا من خطتك، تمامًا مثل REST API، وتكون البيانات بالحداثة التي تسمح بها خطتك.
• list_symbols، get_account، list_plans، list_api_keys: مجانية.
• get_upgrade_link: رابط دفع آمن عبر Stripe للترقية إلى خطة أكبر. يمكن لمساعدك تجهيزه، لكن الدفع يبقى بيدك وحدك.
• create_api_key: ينشئ مفتاحًا لتطبيقاتك الخاصة (فقط عند الاتصال عبر تسجيل الدخول).

لمساعدي البرمجة بالذكاء الاصطناعي

هل تبني تكاملًا باستخدام أداة برمجة بالذكاء الاصطناعي؟ وجّهها إلى llms.txt، أو إلى الملف الكامل llms-full.txt، أو إلى مواصفات OpenAPI؛ فهي تصف كل نقطة نهاية ومعامل واستجابة.

الأمان

تظهر الاتصالات التي أُنشئت عبر تسجيل الدخول ضمن Settings → Connected apps في لوحة التحكم، حيث يمكنك قطعها في أي وقت. ويمكن تدوير مفاتيح API أو إلغاؤها ضمن API keys؛ فالمفتاح الموجود في إعدادات MCP لا يقل حساسية عن المفتاح الموجود في شيفرتك.