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은 세 가지 도구 구성 모드를 제공합니다:
- 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(원격)을 사용하세요.