راه‌اندازی Postman MCP Server محلی

Postman MCP Server محلی با transport از نوع STDIO روی سیستم یا محیط انتخابی شما اجرا می‌شود. این روش برای ابزارهایی مثل VS Code، Cursor، Claude Code، Codex، Gemini CLI، Windsurf، Kiro و Docker مناسب است، به‌خصوص وقتی باید به APIهای داخلی یا محلی دسترسی داشته باشید.

پیش‌نیازها

برای local server همیشه به Postman API key نیاز دارید.
اگر از اجرای Node استفاده می‌کنید، Node.js باید نصب باشد.
کلید API را با environment variable مثل POSTMAN_API_KEY نگه دارید.

پیکربندی‌های پشتیبانی‌شده

Minimal: حالت پیش‌فرض با ابزارهای اصلی.
Code: با flag --code برای جست‌وجوی API و تولید کد.
Full: با flag --full برای همه ابزارهای Postman API.
Quiet: با flag --quiet برای کم کردن logهای stderr؛ برای بعضی کاربران Windsurf روی Windows مهم است.

برای انتخاب منطقه API می‌توانید از --region us یا --region eu استفاده کنید، یا متغیر POSTMAN_API_BASE_URL را مستقیم تنظیم کنید.

Claude Code

claude mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server@latest
claude mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server@latest --code
claude mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server@latest --full

VS Code یا Cursor

برای نصب دستی، یک فایل .vscode/mcp.json یا config مشابه host بسازید و نمونه زیر را استفاده کنید:

{
  "servers": {
    "postman-api-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@postman/postman-mcp-server"
      ],
      "env": {
        "POSTMAN_API_KEY": "${input:postman-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "postman-api-key",
      "type": "promptString",
      "description": "Enter your Postman API key"
    }
  ]
}

برای حالت Code مقدار --code و برای حالت Full مقدار --full را به آرایه args اضافه کنید.

Codex

codex mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server
codex mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server --code
codex mcp add postman --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx @postman/postman-mcp-server --full

Gemini CLI

gemini mcp add postman npx -- -y @postman/postman-mcp-server --env POSTMAN_API_KEY=<POSTMAN_API_KEY>
gemini mcp add postman npx -- -y @postman/postman-mcp-server --code --env POSTMAN_API_KEY=<POSTMAN_API_KEY>
gemini mcp add postman npx -- -y @postman/postman-mcp-server --full --env POSTMAN_API_KEY=<POSTMAN_API_KEY>

همچنین می‌توانید extension رسمی را نصب کنید:

gemini extensions install https://github.com/postmanlabs/postman-mcp-server

Docker

اگر Docker را ترجیح می‌دهید، می‌توانید image رسمی را اجرا کنید:

docker run -i -e POSTMAN_API_KEY="<POSTMAN_API_KEY>" mcp/postman

برای ساخت دستی از سورس، ابتدا image را build کنید و سپس آن را اجرا کنید:

docker build -t postman-api-mcp-stdio .
docker run -i -e POSTMAN_API_KEY="<POSTMAN_API_KEY>" postman-api-mcp-stdio
docker run -i -e POSTMAN_API_KEY="<POSTMAN_API_KEY>" postman-api-mcp-stdio --full

نکته عملی

اگر فقط شروع سریع می‌خواهید، Minimal را انتخاب کنید. اگر agent باید درباره APIها کد تولید کند، Code مناسب‌تر است. Full را برای کارهای پیشرفته و وقتی استفاده کنید که واقعا به ابزارهای کامل Postman API نیاز دارید.

منبع آموزشی: Postman Docs، بازنویسی و ساده‌سازی‌شده برای کاربران فارسی‌زبان.