إعداد وصول الذكاء الاصطناعيفي خمس دقائق
أربع خطوات قصيرة. أنشئ مفتاح API، الصقه في Cursor أو Claude Desktop، تحقق من الاتصال، ثم راجع الأسئلة الشائعة إذا كان شيء غير صحيح.
اختر أداتك
انقر على أداة الذكاء الاصطناعي لديك للقفز مباشرة إلى خطوات الإعداد. كل المسارات تستخدم نفس الصلاحيات - الفرق الوحيد هو طريقة المصادقة.
1. الحصول على بيانات الاعتماد
مساران، نفس الصلاحيات. اختر حسب أداتك.
مفتاح API (X-API-Key + X-API-Secret)
لـ Cursor، Claude Desktop، والسكريبتات التي تكتبها بنفسك. ذاتي في اللوحة: افتح توثيق API → إنشاء مفتاح API. اختر مجموعة Standard. السر يظهر مرة واحدة - انسخه قبل الإغلاق.
افتح توثيق APIOAuth 2.1
لـ ChatGPT، Zapier، Make.com، n8n وغيرها من منصات no-code التي تحتاج زر Login بدلاً من مفتاح API. في اللوحة: افتح تطبيقات OAuth → تسجيل تطبيق. يظهر client_id و client_secret مرة واحدة فقط - انسخهما قبل الإغلاق.
افتح تطبيقات OAuth2. ربط Cursor أو Claude Desktop
افتح ملف إعدادات العميل وأضف إدخال Proginter. Native remote MCP يعمل في الإصدارات الجديدة؛ الـ shim mcp-remote هو الاحتياطي للإصدارات القديمة. أعد تشغيل العميل بعد التعديل.
Cursor
حرر ~/.cursor/mcp.json (أنشئه إذا لم يوجد).
Native remote (Cursor الجديد)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}Stdio shim كبديل (Cursor القديم)
{
"mcpServers": {
"proginter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://proginter.com/mcp",
"--header",
"X-API-Key:pk_your_public_key",
"--header",
"X-API-Secret:sk_your_secret_key"
]
}
}
}Claude Desktop
حرر claude_desktop_config.json - المسار يختلف حسب نظام التشغيل، راجع توثيق Claude Desktop.
Native remote (Claude Desktop الجديد)
{
"mcpServers": {
"proginter": {
"url": "https://proginter.com/mcp",
"headers": {
"X-API-Key": "pk_your_public_key",
"X-API-Secret": "sk_your_secret_key"
}
}
}
}Stdio shim كبديل (Claude Desktop القديم)
{
"mcpServers": {
"proginter": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://proginter.com/mcp",
"--header",
"X-API-Key:pk_your_public_key",
"--header",
"X-API-Secret:sk_your_secret_key"
]
}
}
}3. تحقق من الإعداد
أعد تشغيل عميل الذكاء الاصطناعي واسأل سؤال قراءة فقط. إذا أجاب ببيانات حقيقية من حسابك، انتهيت.
اسأل الذكاء الاصطناعي
"أرني ملف حسابي في Proginter."
المتوقع
رد نظيف يحتوي اسمك وبريدك - هذا 200 OK من أداة account_profile. إذا رأيت 401، اقفز للأسئلة الشائعة بالأسفل.
4. وصل ChatGPT
Custom GPT Actions في ChatGPT تحتاج ترويسة Authorization واحدة، فهي تستخدم OAuth بدلاً من مفتاح API. سجّل الـ GPT بنفسك في اللوحة ثم الصق البيانات في GPT builder.
أ. تسجيل تطبيق OAuth
في اللوحة، افتح تطبيقات OAuth → تسجيل تطبيق. أدخل عنوان redirect الذي يعطيك إياه ChatGPT (عادة https://chat.openai.com/aip/...) والصلاحيات التي تحتاجها (مثل websites:files، servers:plan). عند الحفظ تحصل على client_id و client_secret - السر يُعرض مرة واحدة فقط.
ب. اضبط الإجراء في Custom GPT
في GPT builder، اختر Authentication: OAuth. الصق:
- Client ID: client_id الذي نسخته من تطبيقات OAuth
- Client Secret: client_secret الذي نسخته عند التسجيل (لمرة واحدة)
- Authorization URL:
https://proginter.com/client/oauth/authorize - Token URL:
https://proginter.com/oauth/token - Scope: قائمة مفصولة بمسافات من الـ scopes التي سمحت بها عند التسجيل
- Token Exchange Method:
POST request (default)
لرفع OpenAPI schema، استخدم https://proginter.com/api/v1/openapi.json.
ج. تحقق
احفظ الـ GPT، اضغط "Test"، واسأل: "أرني ملف حسابي في Proginter." ChatGPT سيوجهك في المرة الأولى إلى شاشة موافقة Proginter. وافق عليها، ثم يستلم ChatGPT توكناً ويرد بالبيانات الحقيقية.
5. الأسئلة الشائعة
إجابات قصيرة للأشياء التي عادة تتعطل.
OAuth أم X-API-Key - ماذا أختار؟
كلا التدفقين يصلان إلى نفس نقاط النهاية وبنفس الصلاحيات - الاختيار حسب أداتك. X-API-Key: الأفضل لـ Cursor و Claude Desktop والسكريبتات التي تكتبها بنفسك - في كل حالة تتحكم فيها بالطرفين. OAuth: مطلوب من ChatGPT Custom GPT Actions ومعظم منصات الـ no-code (Zapier، Make.com، n8n) لأنها تقبل ترويسة Authorization واحدة فقط. يمكنك الاستمرار في X-API-Key للأبد إذا كان يناسبك - نحن لا نُلغيه.
أحصل على 401 - ماذا الآن؟
بيانات اعتمادك خاطئة أو منتهية أو ترويسة ناقصة. في مسار X-API-Key: تحقق أن X-API-Key و X-API-Secret مضبوطان. إذا استمر الفشل، دور المفتاح من صفحة توثيق API. في مسار OAuth: ربما انتهت صلاحية توكن الوصول (ساعة)، الأداة يجب أن تحدثه تلقائياً. إذا لم تفعل، قد يحتاج المستخدم لإعادة الموافقة.
كيف أبطل وصول OAuth منحته سابقاً؟
افتح صفحة "التطبيقات المتصلة" في الشريط الجانبي للوحة العميل. تعرض كل صلاحية OAuth - اسم التطبيق والصلاحيات وتاريخ المنح وآخر استخدام. اضغط Disconnect لإبطال جميع التوكنات فوراً. سيحتاج التطبيق لإعادة المصادقة.
بيني وبين Proginter CDN أو بروكسي - ماذا الآن؟
بعض الحواف تجرد ترويسات X-* المخصصة. حلان: (أ) اسمح لـ X-API-Key و X-API-Secret بالمرور عبر CDN، أو (ب) استخدم stdio shim أعلاه - الـ shim يرسل الترويسات من جهازك المحلي فلا يستطيع أي حافة تجريدها. ترويسة Authorization في OAuth قياسية لذا لا تتدخل بها معظم CDNs.
كيف أرى ما يرسله عميلي فعلاً؟
اطرق نقطة النهاية التشخيصية بترويساتك - تعيد ما استلمناه مع إخفاء الأسرار: https://proginter.com/mcp-diagnostic/echo-headers
ما معنى "تأكيد العمليات المدمرة"؟
أي شيء يحذف أو يحاسب أو يستبدل بيانات يحتاج موافقة صريحة. معظم العملاء يعرضون تأكيداً. إذا لم يفعل عميلك، يجب على الذكاء الاصطناعي أن يضمن _confirm: true في الاستدعاء. عمليات القراءة فقط لا تحتاجه أبداً.
كل شيء متصل؟
أنشئ مفتاحاً في اللوحة، الصقه في إعدادات عميلك، واطلب ملف حسابك للتحقق.
