Postman MCP Server به agentهای هوش مصنوعی مثل Claude، Cursor و VS Code کمک می‌کند منابع Postman را از طریق Postman API مدیریت کنند. این سرور دستورهای طبیعی کاربر را به workflowهای API تبدیل می‌کند تا agent بتواند با Workspaceها، Collectionها، specificationها، mock serverها و monitorها کار کند.
پیش‌نیازها
- یک حساب Postman لازم دارید.
- برای احراز هویت با API key باید Postman API key بسازید.
- API key برای local server و remote server منطقه EU لازم است؛ در remote server منطقه US، OAuth هم پشتیبانی می‌شود.
- کلید API را در environment variable یا secret store نگه دارید، نه در فایل‌های مشترک.
روش‌های اتصال
- Remote Server: از طریق streamable HTTPS به agent وصل می‌شود و سریع‌ترین راه شروع است. اگر host شما از OAuth پشتیبانی کند، در منطقه US معمولا نیازی به تنظیم دستی API key ندارید.
- Local Server: روی سیستم خودتان با STDIO اجرا می‌شود. برای شبکه‌های داخلی، تست APIهای محلی، نیازهای امنیتی خاص یا اجرای مستقیم بسته npm/Docker مناسب‌تر است.
پیکربندی ابزارها
هر دو روش remote و local می‌توانند مجموعه ابزار متفاوتی بارگذاری کنند. انتخاب ابزار کمتر مصرف token را پایین می‌آورد و احتمال انتخاب ابزار اشتباه توسط agent را کم می‌کند.
- Minimal: حالت پیش‌فرض، شامل ابزارهای اصلی برای کارهای پایه با Workspace، Collection و Environment.
- Code: برای جست‌وجوی تعریف‌های API و تولید کد کلاینت؛ مناسب وقتی agent باید از APIها استفاده کند یا درباره آن‌ها context بگیرد.
- Full: همه ابزارهای Postman API، بیش از ۱۰۰ ابزار؛ مناسب workflowهای پیشرفته و قابلیت‌های Enterprise.
پشتیبانی EU
در منطقه EU، endpointهای remote عبارت‌اند از https://mcp.eu.postman.com/minimal، https://mcp.eu.postman.com/code و https://mcp.eu.postman.com/mcp. OAuth برای EU پشتیبانی نمی‌شود و باید از API key در header احراز هویت استفاده کنید.
نمونه کاربردها
- همگام‌سازی کد با Collectionها و specificationها.
- ساخت و برچسب‌گذاری Collectionها یا به‌روزرسانی مستندات درخواست‌ها.
- ساخت Workspace و Environment و مدیریت متغیرهای محیط.
- ساخت specification از روی کد و تولید Collection از روی آن.
احراز هویت پیشنهادی
برای remote server منطقه US، OAuth بهترین تجربه راه‌اندازی را می‌دهد و با مشخصات MCP Authorization سازگار است. برای local server و EU remote server، از Postman API key استفاده کنید.
منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.