ADK 向け Postman MCP ツール¶
Supported in ADKPythonTypeScript
Postman MCP Server は ADK エージェントを Postman エコシステムへ接続します。 この連携により、エージェントは自然言語操作でワークスペースアクセス、 コレクション/環境管理、API 評価、ワークフロー自動化を実行できます。
ユースケース¶
-
API テスト: Postman コレクションを使って API を継続的にテストします。
-
コレクション管理: エディタを離れずにコレクション作成/タグ付け、 ドキュメント更新、コメント追加、複数コレクション操作を実行できます。
-
ワークスペース/環境管理: ワークスペースと環境を作成し、 環境変数を管理します。
-
クライアントコード生成: ベストプラクティスとプロジェクト規約に沿った 本番利用可能な API クライアントコードを生成します。
前提条件¶
- Postman アカウント 作成
- Postman API キー 生成
エージェントで使う¶
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters
POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY"
root_agent = Agent(
model="gemini-2.5-pro",
name="postman_agent",
instruction="Help users manage their Postman workspaces and collections",
tools=[
McpToolset(
connection_params=StdioConnectionParams(
server_params=StdioServerParameters(
command="npx",
args=[
"-y",
"@postman/postman-mcp-server",
# "--full", # Use all 100+ tools
# "--code", # Use code generation tools
# "--region", "eu", # Use EU region
],
env={
"POSTMAN_API_KEY": POSTMAN_API_KEY,
},
),
timeout=30,
),
)
],
)
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPServerParams
POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY"
root_agent = Agent(
model="gemini-2.5-pro",
name="postman_agent",
instruction="Help users manage their Postman workspaces and collections",
tools=[
McpToolset(
connection_params=StreamableHTTPServerParams(
url="https://mcp.postman.com/mcp",
# (Optional) Use "/minimal" for essential tools only
# (Optional) Use "/code" for code generation tools
# (Optional) Use "https://mcp.eu.postman.com" for EU region
headers={
"Authorization": f"Bearer {POSTMAN_API_KEY}",
},
),
)
],
)
import { LlmAgent, MCPToolset } from "@google/adk";
const POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY";
const rootAgent = new LlmAgent({
model: "gemini-2.5-pro",
name: "postman_agent",
instruction: "Help users manage their Postman workspaces and collections",
tools: [
new MCPToolset({
type: "StdioConnectionParams",
serverParams: {
command: "npx",
args: [
"-y",
"@postman/postman-mcp-server",
// "--full", // Use all 100+ tools
// "--code", // Use code generation tools
// "--region", "eu", // Use EU region
],
env: {
POSTMAN_API_KEY: POSTMAN_API_KEY,
},
},
}),
],
});
export { rootAgent };
import { LlmAgent, MCPToolset } from "@google/adk";
const POSTMAN_API_KEY = "YOUR_POSTMAN_API_KEY";
const rootAgent = new LlmAgent({
model: "gemini-2.5-pro",
name: "postman_agent",
instruction: "Help users manage their Postman workspaces and collections",
tools: [
new MCPToolset({
type: "StreamableHTTPConnectionParams",
url: "https://mcp.postman.com/mcp",
// (Optional) Use "/minimal" for essential tools only
// (Optional) Use "/code" for code generation tools
// (Optional) Use "https://mcp.eu.postman.com" for EU region
transportOptions: {
requestInit: {
headers: {
Authorization: `Bearer ${POSTMAN_API_KEY}`,
},
},
},
}),
],
});
export { rootAgent };
設定¶
Postman は 3 種類のツール構成を提供します:
- Minimal (デフォルト): 基本的な Postman 操作用の最小セット。 コレクション/ワークスペース/環境の簡易変更向け。
- Full: 利用可能な Postman API ツール全体 (100+ ツール)。 高度な協業やエンタープライズ機能向け。
- Code: API 定義検索とクライアントコード生成向け。 API 利用コードが必要な開発者向け。
構成選択方法:
- ローカルサーバー:
argsに--fullまたは--codeを追加。 - リモートサーバー: URL パスを
/minimal、/mcp(full)、/codeに変更。
EU リージョンでは --region eu (ローカル) または https://mcp.eu.postman.com (リモート) を使用します。