如何将 Postman API 远程 MCP 连接到 Gemini CLI

约 1 分钟即可把 Postman 的远程 MCP 服务端接入 Gemini CLI。如需排查 OAuth / 401 问题,可先用 OAuth 2.1 调试器体检端点。

🛡️ Official✓ VerifiedStreamable HTTPBearer Token🛡️ A+~479 tok16 tools
Streamable HTTPhttps://mcp.postman.com/mcp

🔒 Client-side only — never leaves your browser.

Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:

{
  "mcpServers": {
    "postman": {
      "httpUrl": "https://mcp.postman.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

接入步骤

  1. 编辑设置文件 — 打开 ~/.gemini/settings.json。
  2. 添加服务端 — 在 mcpServers 中加入 "postman": { "httpUrl": https://mcp.postman.com/mcp }。
  3. 完成认证 — 在 Postman 控制台获取凭据,并将其作为 Authorization: Bearer <密钥> 请求头加入配置。
  4. 验证 — 在 在线 Inspector 中粘贴 https://mcp.postman.com/mcp 并运行 initialize + tools/list 验证连通性。

🧰 工具预览(16)

ToolSafetyDescriptionParameters
getCollections
~29 tok
🟢 ReadList Postman collections.—
getCollection
~29 tok
🟢 ReadGet a Postman collection.—
createCollection
~30 tok
🟠 WriteCreate a Postman collection.—
updateCollection
~30 tok
🟠 WriteUpdate a collection (PUT).—
patchCollection
~31 tok
🟠 WritePartially update a collection.—
deleteCollection
~28 tok
🔴 DestructiveDelete a collection.—
createRequest
~30 tok
🟠 WriteAdd a request to a collection.—
updateRequest
~31 tok
🟠 WriteUpdate a request in a collection.—
getEnvironments
~30 tok
🟢 ReadList Postman environments.—
getEnvironment
~28 tok
🟢 ReadGet an environment.—
createEnvironment
~29 tok
🟠 WriteCreate an environment.—
getMocks
~26 tok
🟢 ReadList mock servers.—
createMock
~27 tok
🟠 WriteCreate a mock server.—
getApis
~26 tok
🟢 ReadList Postman APIs.—
getWorkspaces
~29 tok
🟢 ReadList Postman workspaces.—
getWorkspace
~26 tok
🟢 ReadGet a workspace.—

更多连接指南