راه‌اندازی Postman MCP Server ریموت

Postman MCP Server ریموت توسط Postman و از طریق streamable HTTP میزبانی می‌شود. این روش ساده‌ترین راه شروع است، چون لازم نیست سرور را روی سیستم خودتان اجرا کنید. در سرور US، OAuth برای تجربه نصب سریع‌تر پشتیبانی می‌شود؛ در سرور EU باید از API key استفاده کنید.

endpointهای ریموت

پیکربندی	US endpoint	EU endpoint
Minimal	https://mcp.postman.com/minimal	https://mcp.eu.postman.com/minimal
Code	https://mcp.postman.com/code	https://mcp.eu.postman.com/code
Full	https://mcp.postman.com/mcp	https://mcp.eu.postman.com/mcp

OAuth فقط روی سرور US فعال است. برای EU، کلید API را با قالب Authorization: Bearer <POSTMAN_API_KEY> ارسال کنید.

Claude Code

برای OAuth در سرور US، یکی از دستورهای زیر را اجرا کنید:

claude mcp add --transport http postman https://mcp.postman.com/minimal
claude mcp add --transport http postman https://mcp.postman.com/code
claude mcp add --transport http postman https://mcp.postman.com/mcp

برای API key، به‌ویژه در EU، header را اضافه کنید:

claude mcp add --transport http postman https://mcp.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"

VS Code و Cursor

اگر host از OAuth پشتیبانی می‌کند، فقط URL سرور را در config قرار دهید. برای نصب دستی در VS Code می‌توانید نمونه زیر را در .vscode/mcp.json بگذارید:

{
  "servers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com/minimal"
    }
  }
}

برای API key، از ورودی امن استفاده کنید:

{
  "servers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com/minimal",
      "headers": {
        "Authorization": "Bearer ${input:postman-api-key}"
      }
    }
  },
  "inputs": [
    {
      "id": "postman-api-key",
      "type": "promptString",
      "description": "Enter your Postman API key"
    }
  ]
}

Codex

برای OAuth در سرور US:

codex mcp add postman --remote-url https://mcp.postman.com/minimal
codex mcp add postman --remote-url https://mcp.postman.com/code
codex mcp add postman --remote-url https://mcp.postman.com/mcp

اگر EU یا API key لازم دارید، می‌توانید از بسته محلی با environment variable استفاده کنید:

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

سایر hostها

Windsurf، Antigravity، GitHub Copilot CLI، Gemini CLI و Kiro هم می‌توانند Postman MCP Server ریموت را با URLهای بالا اضافه کنند. برای hostهایی که config JSON می‌خواهند، نوع transport را http و URL را مطابق حالت Minimal، Code یا Full قرار دهید.

تایید اتصال

بعد از نصب، host خود را reload یا restart کنید. سپس بررسی کنید که سرور Postman و ابزارهای آن در فهرست MCP host دیده می‌شوند. یک تست فقط‌خواندنی مثل «Workspaceهای Postman من را فهرست کن» راه خوبی برای تایید اتصال است.

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