Claude Code هو أداة تعمل من خلال سطر الأوامر (Command Line). ويمكن إضافة الموصل باستخدام أمر واحد فقط.
كيفية الاتصال في Claude Code
1. في نافذة الطرفية (Terminal)، نفّذ الأمر التالي:
claude mcp add --transport http HTA_MCP
https://mcp.hilltopads.com/mcp
سيعرض Claude Code رسالة تأكيد:
Added HTTP MCP server HTA_MCP
يمثل HTA_MCP الاسم المحلي للخادم فقط، ويمكنك اختيار أي اسم آخر إذا أردت.
الخطوة 1 — أضف الخادم باستخدام أمر واحد.
2. شغّل Claude Code. سيكتشف أن الخادم يحتاج إلى المصادقة. نفّذ الأمر: mcp/
الخطوة 2 — شغّل الأمر mcp/.
3. في قائمة الخوادم، سيظهر HTA_MCP بالحالة Needs authentication. افتحه.
الخطوة 3 — يحتاج HTA_MCP إلى المصادقة.
4. اختر Authenticate.
الخطوة 4 — اختر Authenticate.
5. سيفتح Claude Code نافذة في المتصفح لإجراء المصادقة. (إذا لم تُفتح تلقائيًا، فانسخ الرابط الذي يظهر في الطرفية وافتحه يدويًا في متصفحك.)
الخطوة 5 — يفتح المتصفح لإتمام المصادقة.
6. في صفحة HilltopAds MCP Authorization، الصق مفتاح API الخاص بك، ثم انقر على Authorize.
الخطوة 6 — قم بالتفويض باستخدام مفتاح API.
7. ستظهر في المتصفح رسالة Authentication successful. أغلق علامة التبويب ثم ارجع إلى نافذة الطرفية.
الخطوة 7 — تمت المصادقة بنجاح؛ ارجع إلى الطرفية.
8. شغّل الأمر /mcp مرة أخرى. سيظهر HTA_MCP الآن بالحالة Connected، مع توفر جميع أدواته.
الخطوة 8 — أصبح HTA_MCP متصلًا، وأدواته جاهزة للاستخدام.
استخدامه في Claude Code
اطلب البيانات بلغة طبيعية، وسيتولى Claude Code استدعاء الموصل. ويمكنه أيضًا تنفيذ مهام إضافية، مثل إنشاء مخطط بياني اعتمادًا على البيانات المسترجعة.
جرّب الطلب التالي:
"using HTA_MCP get advertiser stats for last 7 days and plot a graph for the top-5 geo, grouping by geo."
يقوم Claude Code بجلب الإحصاءات وإعداد تمثيل مرئي لها.
النتيجة: جدول يضم أفضل 5 مناطق GEO بالإضافة إلى مخطط بياني تم إنشاؤه تلقائيًا.