خادم MCP
نظرة عامة
Section titled “نظرة عامة”خادم MCP المستضاف من Wink متاح على:
https://docs.mcp.wink.travel/mcpوجه عملاء الذكاء الاصطناعي المتوافقين (VS Code، Cursor، وغيرهم الذين ينفذون نقل MCP عبر HTTP) إلى هذه النقطة النهائية للسماح لهم بـ:
- تصفح وثائق المنتج والمنصة (
wink://docs/...) - اكتشاف SDKs والتعمق في فئات / نماذج API (
wink://sdk/...وwink://sdk/.../docs) - إجراء بحث دلالي / بالكلمات المفتاحية خفيف الوزن عبر الوثائق وملخصات SDK
استخدم نقطة النهاية الأساسية القابلة للبث عبر HTTP:
https://docs.mcp.wink.travel/mcpإذا كان عميلك يدعم SSE فقط، استخدم:
https://docs.mcp.wink.travel/sseCursor
Section titled “Cursor”وثائق MCP لـ Cursor: https://cursor.com/docs/context/mcp الإعداد: أضف الخادم البعيد عبر إعدادات MCP.
{ "mcpServers": { "wink-docs": { "url": "https://docs.mcp.wink.travel/mcp", } }}VS Code
Section titled “VS Code”الوثائق الرسمية: https://code.visualstudio.com/docs/copilot/customization/mcp-servers
تكوين بعيد بسيط (ملف mcp.json للمستخدم أو مساحة العمل):
{ "servers": { "wink-docs": { "type": "http", "url": "https://docs.mcp.wink.travel/mcp" } }}نصائح:
- استخدم لوحة الأوامر: “MCP: List Servers” لتأكيد الاتصال وتصفح الأدوات.
- يتيح لك محدد الأدوات تمكين/تعطيل
sdk_searchوdocs_search. - أضف السياق: عرض الدردشة → إضافة سياق → موارد MCP لإرفاق صفحات الوثائق.
عناوين URI الأساسية للموارد
Section titled “عناوين URI الأساسية للموارد”| URI | الوصف |
|---|---|
wink://docs | فهرس الوثائق (مجمعة حسب الفئة) |
wink://docs/{path} | مقالة وثائق محددة (Markdown / MDX) |
wink://sdk | نظرة عامة على SDK (كل SDK + عدد الوثائق) |
wink://sdk/{sdkPath} | ملف README الخاص بـ SDK / مجلد وثائق الوحدة / وثيقة وحدة محددة |
وثائق الوحدة
Section titled “وثائق الوحدة”فتح مجلد وثائق SDK (مثلاً wink://sdk/python/wink-sdk-booking/docs) يعرض مجموعات:
- فئات API (عدد الطرق + أسماء طرق نموذجية)
- النماذج والأنواع (هياكل البيانات المستخدمة من قبل تلك APIs)
أدوات البحث (مرجع سريع)
Section titled “أدوات البحث (مرجع سريع)”| الأداة | الغرض | أمثلة استعلام نموذجية |
|---|---|---|
sdk_search | العثور على SDK / فئة API لاستخدامها | إلغاء الحجز، قائمة العقارات، مخزون الشركاء |
docs_search | العثور على الوثائق المفاهيمية / الأدلة | المصادقة، webhooks، ووردبريس |
اترك query فارغًا لتلقي اقتراحات. كل نتيجة تتضمن URI MCP يمكنك فتحه.
نمط الاستخدام النموذجي
Section titled “نمط الاستخدام النموذجي”- شغّل
sdk_searchمع نيتك (مثلاً “قائمة العقارات”). - افتح ملف README الخاص بـ SDK أو
docs_uriالخاص به لفحص APIs / النماذج. - استخدم
docs_searchللمفاهيم الداعمة (المصادقة، webhooks).
ملاحظات
Section titled “ملاحظات”- يمكن للوكيل فتح كل URI معاد للحصول على المحتوى الكامل.
- تظهر الاقتراحات تلقائيًا عندما تكون الاستعلامات فارغة.
SDKs المدعومة حاليًا
Section titled “SDKs المدعومة حاليًا”- SDKs بايثون من Wink
خارطة الطريق (على مستوى عالٍ)
Section titled “خارطة الطريق (على مستوى عالٍ)”- SDKs بلغات إضافية (جافا، جافا سكريبت/تايب سكريبت)
- إضافة SDKs TripPay