أسعار الصرف في Claude

زوّد Claude بأسعار صرف العملات عبر خادم MCP المستضاف دون الحاجة إلى مفتاح API للاتصال. الأسعار دون مفتاح وفي خطة Free متأخرة 15 دقيقة؛ والخطط المدفوعة تحصل على أسعار لحظية.

إضافة الخادم المستضاف إلى Claude Code

نفّذ الأمر التالي في Claude Code لإضافة خادم MCP المستضاف دون مفتاح API.

نقطة الاتصال هي https://api.exchangerate.dev/v1/mcp/، مع الشرطة المائلة الأخيرة، عبر Streamable HTTP. يعمل اكتشاف الأدوات واستدعاؤها دون مفتاح.

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/

استخدام مفتاح لحصتك الخاصة

نفّذ الأمر التالي بمفتاح API الخاص بك لاستخدام حصتك وحدودك.

يرسل الأمر Authorization: Bearer YOUR_API_KEY. تشمل خطة Free عدد 5,000 طلب شهريا و10 طلبات في الدقيقة. يُحسب كل استدعاء لأداة MCP طلب API واحدا ضمن حد الدقيقة والحصة الشهرية نفسيهما لطلب REST المقابل.

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

تشغيل الجسر المحلي كبديل

نفّذ الأمر التالي لربط Claude Code عبر جسر npm المحلي.

استخدم Node.js 20 أو أحدث ومفتاح API. يضبط الأمر EXCHANGERATE_API_KEY باستخدام -e قبل الشرطتين. يتطلب الاستخدام دون مفتاح ضبط ALLOW_ANONYMOUS=true.

claude mcp add exchangerate-dev -e EXCHANGERATE_API_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/exchangerate-mcp

إعداد Claude Desktop

أضف الإعداد التالي إلى ملف إعدادات Claude Desktop واستبدل YOUR_API_KEY.

في macOS، الملف هو ~/Library/Application Support/Claude/claude_desktop_config.json. في Windows، استخدم %APPDATA%\Claude\claude_desktop_config.json.

اضبط EXCHANGERATE_API_KEY داخل كتلة env في الإعدادات لأن Claude Desktop لا يقرأ بيئة الطرفية. احفظ الملف، وأغلق Claude Desktop تماما، ثم افتحه مجددا. تُحمّل الخوادم مرة واحدة عند بدء التشغيل.

{  "mcpServers": {    "exchangerate-dev": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/exchangerate-mcp"      ],      "env": {        "EXCHANGERATE_API_KEY": "YOUR_API_KEY"      }    }  }}

طلب سعر صرف من Claude

اسأل «كم يساوي 100 يورو بالين الياباني الآن؟». يمكن أن يستخدم Claude أداة convert التي تأخذ from وto وamount. تتضمن الاستجابة السعر والمبلغ المحوّل وعلامة تفيد بأن السعر مشتق عبر USD.

يستخدم سؤال «ما سعر USD مقابل IDR في 1 سبتمبر؟» أداة get_range أو get_rate. للحصول على أحدث سعر، تأخذ get_rate المعاملين base وquote؛ وتعيد get_range أسعارا ضمن نطاق زمني.

اسأل «ما العملات التي يمكنك البحث عنها؟» لاستخدام list_currencies، أو «ما البنوك المركزية التي تنشر سعر صرف؟» لاستخدام list_official_rate_tables.

ما يستطيع Claude قراءته وفعله

تتيح 9 أدوات لـ Claude الوصول إلى الأسعار ومعلومات العملات والتوثيق. إلى جانب الأدوات السابقة، تعيد get_usd_index مؤشر USD محسوبا بشكل مستقل، وتبحث search_docs في التوثيق، وتعيد get_official_rate أسعارا تنشرها الجهات الحكومية.

تتضمن الإجابات source وmarket_session وdata_updated_at وتنبيها بأن الأسعار استرشادية ولا تصلح للتسوية أو التداول. ينبغي أن يذكر Claude الوقت المُعاد.

تفتح start_checkout صفحة الدفع لخطة بعد تأكيدك فقط. لا يشتري Claude أي شيء من تلقاء نفسه.

معالجة المشكلات

تحقق من JSON في الإعدادات إذا لم يعرض Claude Desktop أي أدوات. الفاصلة الزائدة في النهاية سبب شائع.

يعيد مفتاح API غير الصالح HTTP 401. ويعني 429 بلوغ حد الدقيقة أو الحصة الشهرية؛ انتظر موعد إعادة المحاولة.