كيفية استخدام خادم Postman MCP - دليل للمبتدئين

خادم Postman MCP هو خادم متقدم مبني على TypeScript يتكامل مع واجهة برمجة التطبيقات Postman، مما يعزز الإدارة الفعالة لمجموعات Postman والبيئات وواجهات برمجة التطبيقات. من خلال الاستفادة من مبادرة بروتوكول سياق النموذج (MCP) من Anthropic، يوفر خادم Postman MCP طبقة تفاعل مدفوعة بالذكاء الاصطناعي تسهل سير العمل المعقد لواجهات برمجة التطبيقات، وتؤتمت المهام، وتعزز الإنتاجية. يُسهِّل هذا الخادم إنشاء وتعديل وتنظيم موارد Postman مع وظائف تفصيلية للمطورين والفرق التي تسعى إلى تبسيط مهام إدارة واجهات برمجة التطبيقات.

الميزات الرئيسية لخادم Postman MCP

يأتي خادم Postman MCP مع مجموعة غنية من الميزات التي تسمح بإدارة سلسة وتفاعل مع واجهة برمجة التطبيقات Postman.

1. إدارة المجموعات

عمليات CRUD: أنشئ واسترجع وحدث واحذف مجموعات Postman بسهولة.

إدارة المجلدات: نظم الطلبات من خلال تجميعها في مجلدات داخل المجموعات، مما يجعل التنقل أكثر سهولة.

إدارة الطلبات: أضف طلبات جديدة، أو حدث الطلبات الموجودة، أو احذف الطلبات ضمن المجموعات، مما يجعل من السهل إدارة واجهات برمجة التطبيقات.

إدارة الاستجابات: قم بتخزين وإدارة الاستجابات المرتبطة بالطلبات الفردية للمساعدة في الاختبار وإزالة الأخطاء.

التحكم في الإصدارات: استخدم ميزات التحكم في الإصدارات القوية مثل التفرع والدمج وسحب التغييرات، مما يضمن التعاون والتكامل السلس مع الفرق.

التعليقات: أضف تعليقات على المجموعات، مما يسهل التعاون على الطلبات، وتقديم الشروحات، والحفاظ على التواصل الواضح داخل الفرق.

2. إدارة البيئات

إنشاء واسترجاع البيئات: قم بإنشاء بيئات مختلفة لإعدادات متنوعة واسترجعها للاستخدام ضمن المجموعات.

عمليات CRUD: دعم كامل لإنشاء وتحديث وحذف البيئات، مما يسهل العمل مع التكوينات المختلفة بناءً على احتياجاتك.

3. إدارة واجهات برمجة التطبيقات

إنشاء وتحديث واجهات برمجة التطبيقات: إدارة دورة حياة واجهات برمجة التطبيقات بالكامل، بما في ذلك الإنشاء والاسترجاع والتحديث والحذف لواجهات برمجة التطبيقات ضمن منصة Postman.

دعم مخططات متعددة الملفات: إدارة مخططات واجهة برمجة التطبيقات متعددة الملفات، مما يعزز تنظيم ومرونة وثائق واجهة برمجة التطبيقات الخاصة بك.

التسمية: عيِّن تسميات لواجهات برمجة التطبيقات لتحسين التصنيف وإمكانية البحث، مما يمكّن الوصول والتكامل السريع.

تعليقات API: أضف تعليقات على واجهات برمجة التطبيقات، مما يسهل التعاون ويضمن أن وثائق واجهة برمجة التطبيقات مفهومة بشكل جيد من قبل جميع المعنيين.

4. المصادقة والتفويض

مصادقة مفتاح API: تأمين الوصول لموارد Postman باستخدام مفاتيح API، مما يضمن أن المستخدمين المصرح لهم فقط يمكنهم التفاعل مع بياناتك.

التحكم في الوصول القائم على الدور (RBAC): التحكم في الوصول إلى مساحات العمل والمجموعات وموارد Postman الأخرى من خلال تحديد أدوار المستخدم وإذن.

أذونات مساحة العمل: تعريف أذونات دقيقة للأعمال المتعلقة بمساحة العمل، مما يضمن أن المستخدمين المصرح لهم فقط يمكنهم إجراء تغييرات هامة.

5. ميزات إضافية

شبكة API الخاصة: إدارة العناصر والمجلدات بسلاسة داخل شبكة API الخاصة، مما يضمن أن البيانات الحساسة تبقى آمنة ومنظمة.

Webhooks: إعداد webhooks لتشغيل المجموعات بأحمال مخصصة، مما يمكّن من سير العمل الآلي والتكامل مع خدمات أخرى.

ميزات المؤسسات: ضوابط متقدمة قائمة على الدور، بما في ذلك دعم SCIM، لإدارة المستخدمين والأذونات ضمن بيئات المؤسسات.

كيفية تثبيت خادم Postman MCP

إن إعداد خادم Postman MCP هو عملية بسيطة يمكن القيام بها بالخطوات التالية:

التثبيت عبر Smithery

لتثبيت خادم Postman MCP لـ Claude Desktop تلقائيًا عبر Smithery:

npx -y @smithery/cli install postman-api-server --client claude

المتطلبات المسبقة

• Node.js مثبت.

استنساخ المستودع:

استنساخ المشروع من GitHub عن طريق تشغيل الأمر التالي:

git clone https://github.com/delano/postman-api-server.git
cd postman-api-server

تثبيت التبعيات:

قم بتثبيت التبعيات المطلوبة باستخدام pnpm:

pnpm install

بناء الخادم:

قم ببناء الخادم عن طريق تشغيل:

pnpm run build

تشغيل في وضع التطوير:

لتشغيل الخادم في وضع التطوير مع إعادة البناء التلقائي:

pnpm run watch

إعداد مفاتيح API

للتفاعل مع واجهة برمجة التطبيقات Postman، ستحتاج إلى توليد وتكوين مفتاح API.

توليد مفتاح API الخاص بك:

اذهب إلى إعدادات حساب Postman واضغط على "توليد مفتاح API."

تأكد من تخزين المفتاح بشكل آمن، حيث لن يتم عرضه مرة أخرى.

تكوين مفتاح API:

أضف المفتاح الذي تم توليده إلى بيئتك بصيغة POSTMAN_API_KEY.

بالنسبة للأدوات مثل Claude Desktop أو Cline، أدخل مفتاح API في ملف التكوين.

مهم: لا تقم أبدًا بتسجيل مفتاح API الخاص بك في التحكم في الإصدارات لتجنب التعرض.

تحقق من الوصول:

مع تكوين مفتاح API الخاص بك، يمكنك اختبار الوصول عن طريق تشغيل استفسارات بسيطة، مثل سرد مساحات العمل، للتأكد من الإعداد الصحيح والأذونات.

الاندماج مع Claude Desktop و Cline

تكوين Claude Desktop:

على Claude Desktop، تحتاج إلى إضافة تكوين الخادم إلى ملف إعداد Claude الموجود في:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

تكوين مثال:

{
  "mcpServers": {
    "postman": {
      "command": "node",
      "args": [
        "/path/to/postman-api-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "CHANGEME"
      }
    }
  }
}

تكوين Cline:

أضف نفس التكوين إلى ملف تكوين خوادم MCP لـ Cline، مشابهًا لتكوين Claude.

الإعداد المتقدم وإزالة الأخطاء

تشغيل في وضع التطوير مع إعادة بناء تلقائية:

لتطوير سهل، يمكنك تشغيل الخادم مع إعادة البناء التلقائي:

pnpm run watch

إزالة الأخطاء باستخدام MCP Inspector:

لتسهيل إزالة الأخطاء، استخدم MCP Inspector، والذي يمكن تشغيله عبر:

pnpm run inspector

سيوفر لك هذا عنوان URL (http://localhost:5173) للوصول إلى أدوات إزالة الأخطاء في متصفحك، مما يساعدك في استكشاف الأخطاء ومراقبة الخادم.

تحويل مواصفات OpenAPI إلى كود TypeScript مع Claude

مع التكامل بين خادم Postman MCP وClaude وCline، يصبح تحويل مواصفات OpenAPI إلى كود TypeScript سلسًا وفعالًا. تعمل هذه العملية الآلية على تقليل الأخطاء الشائعة في التكامل بشكل كبير وتعزز سلامة النوع عند التفاعل مع واجهات برمجة التطبيقات.

1. تكامل مواصفات OpenAPI

يقوم خادم Postman MCP، بمساعدة Claude، بتحليل مواصفة OpenAPI تلقائيًا ويولد كود TypeScript المقابل. هذا يقضي على الحاجة إلى رسم الخرائط اليدوية بين موارد واجهة برمجة التطبيقات وأنواع TypeScript، مما يضمن الدقة والاتساق في الأنواع.

على سبيل المثال، قد يبدو تعريف OpenAPI لنقطة النهاية GET /users/{id} كما يلي:

paths:
  /users/{id}:
    get:
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string

سيتم تحويل ذلك إلى واجهة TypeScript ودالة استدعاء واجهة برمجة التطبيقات مثل:

interface User {
  id: string;
  name: string;
  email: string;
}

const getUser = async (id: string): Promise<User> => {
  const response = await axios.get(`https://api.postman.com/users/${id}`);
  return response.data;
};

2. سلامة النوع الآلية

يضمن Claude أن تظل أنواع TypeScript متزامنة مع مواصفة OpenAPI. هذا يقضي على الأخطاء المحتملة الناجمة عن عدم تطابق الأنواع في الطلبات أو الاستجابات. على سبيل المثال، ستوضح TypeScript الأخطاء إذا حاولت الوصول إلى خصائص غير معرّفة في واجهة User:

console.log(user.age);  // خطأ: الخاصية 'age' غير موجودة في نوع 'User'

3. تجربة مطور محسنة

باستخدام Cline، يمكن للمطورين بسهولة تكوين والتفاعل مع واجهة برمجة التطبيقات Postman مع ضمان تحديث أنواع TypeScript تلقائيًا. هذا يقلل من العمل اليدوي ويسرع من التطوير، ويساعد في الحفاظ على وثائق واجهة برمجة التطبيقات الدقيقة طوال دورة حياة المشروع.

تضمن هذه الطريقة تفاعلات أكثر موثوقية وفعالية وخالية من الأخطاء مع واجهة برمجة التطبيقات Postman، مما يحسن من جودة الكود العامة ويقلل من مشكلات التكامل.

خادم Postman MCP مقابل Apidog – أيهما يجب أن تستخدمه؟

بينما يُعتبر خادم Postman MCP أداة قوية لإدارة واجهات برمجة التطبيقات والأتمتة، فإن Apidog يوفر حلاً أكثر سهولة، ومدمجًا لكل ما يتعلق بتصميم واجهات برمجة التطبيقات، الاختبار، والتعاون.

الاختلافات الرئيسية

لماذا يجب النظر في Apidog؟

منحنى تعلم أسهل – مثالي للمبتدئين مع واجهة مستخدم بديهية.

خادم محاكي مدمج – عدم الحاجة إلى تكاملات طرف ثالث.

تعاون في الوقت الحقيقي – فريق عمل سلس على مشاريع واجهة برمجة التطبيقات.

إدارة دورة حياة واجهة برمجة التطبيقات الشاملة – تصميم واختبار وتوثيق وإدارة واجهات برمجة التطبيقات في مكان واحد.

نظرة عامة على المشروع

يعتبر خادم Postman MCP جزءًا من مبادرة بروتوكول سياق النموذج (MCP)، والتي توفر إطارًا للتعامل مع تفاعلات واجهة برمجة التطبيقات المعقدة، خاصة التي تتطلب عمليات متعددة الخطوات. يوفر الخادم قيمة كبيرة للمهام التي تتضمن إدارة مجموعات متعددة، وأتمتة سير العمل، والحفاظ على التوافق مع معايير واجهة برمجة التطبيقات.

الخاتمة

يعتبر خادم Postman MCP أداة قوية للمطورين الذين يسعون لتبسيط إدارة مجموعات Postman، والبيئات، وواجهات برمجة التطبيقات. من خلال أتمتة المهام المتكررة، وتوفير ميزات أمان قوية، وعرض تكامل سلس مع أدوات مثل Claude وCline، يعمل هذا الخادم على تسريع سير عمل واجهة برمجة التطبيقات ويعزز الإنتاجية العامة.