管理と運用
Context Graph API
APIとサービスの依存関係を認証済みの情報に基づいてエージェントが把握できるようにします。変更がどこまで影響するかをたどり、影響を受けるAPI利用者を特定して、コードをマージする前に破壊的変更を検出できます。
Context Graphの仕組み
468のリポジトリを対象にベンチマーク
8つの質問を3つのモデルで検証し、Context Graphを使う場合と使わない場合で、それぞれ3回ずつ実行しました。モデル、質問、使用するツールはすべて同じ条件です。
29%
プロンプトトークンを削減
Opus 4.7では29%削減。GPT-6 Astraでは23%削減し、Sonnet 4.5では増加しました。
17%
1回の実行あたりのツール呼び出しを削減
Opus 4.7では、69回から57回に減少しました。
27%
1回の実行あたりのコストを削減
Opus 4.7では27%削減。GPT-6 Astraでは20%削減し、Sonnet 4.5では増加しました。
2026年9月に、468のリポジトリと3つのモデルを対象に、計144回のベンチマークを実施しました。コストには、初回のみ必要なグラフの構築と継続的な再取り込みにかかるコストは含まれていません。
システムをまたぐ質問で、プロンプトトークンを削減
モデルがコードを読む前にグラフへ問い合わせた場合の、プロンプトトークンの削減率を示しています。468のリポジトリを対象にOpus 4.7で検証した結果で、8つの質問のうち削減率が最も大きかった3つを掲載しています。質問1つあたりのツール呼び出しが69回から57回に減ったことで、やり取りの回数が減り、トークン数も削減されました。
Chart will load when visible
利用を開始
Postmanで用意済みの質問を実際のAPIに送信し、Context Graphを直接試すことができます。
1. Context Graphでは認証が必要です。クエリを実行する前に、Postmanアカウントにサインインしてください。
2. リクエストの［Authorization］タブにPostman APIキーを追加してください。
3. アクティブな環境を「Context Graph API」に設定してください。
4. グラフはチームごとに構築されます。現在サインインしているチームのノードが取り込まれ、そのチームのグラフがクエリの対象になります。
5. リクエストボディのクエリを編集して、質問したい内容を指定してください。
取り込まれたグラフは、Postmanのホームボタン ＞［Agent Context］からいつでも確認できます。
USE IT FROM YOUR CODING AGENT
Reach the same graph whichever way your agent works: from the CLI, through MCP, or over HTTP.
CLI + skills. Run postman init in your repo to install Postman's agent skills, then your coding agent queries the graph through the Postman CLI, with no HTTP wiring or polling to manage.
MCP. Point any MCP client at https://mcp.postman.com/context-graph, or add the --context-graph toolset to the Postman MCP server, and the graph shows up as a tool.
HTTP. Call the Context Graph API directly with a Postman API key: submit an ask and poll for the result.
複数のリポジトリにまたがる変更で、Context Graphがどう役立つかをご覧ください
RESOURCES
Go deeper on Context Graph
Frequently asked questions
What is Postman Context Graph?
A continuously updated graph of your API estate. It ingests your Postman workspaces, code repositories, and runtime telemetry, then turns them into typed entities (APIs, endpoints, deployments, databases, teams) joined by typed relationships. Agents query that graph instead of reconstructing it from whatever files are open.
Which sources can Context Graph ingest?
Your Postman workspaces are the primary source: the specs, collections, and environments your teams already maintain. Beyond that, GitHub repositories scanned for OpenAPI, AsyncAPI, and service definitions, and New Relic for the deployments and telemetry a code scan cannot see.
How does the graph stay current?
Each source carries its own policy: a refresh interval, a webhook, or manual. Re-ingestion is incremental, so unchanged repositories are skipped and cost tracks your code churn rather than your estate size. Runtime connectors stream continuously.
What does Context Graph know about an API?
What it exposes, calls, and depends on at runtime. Which databases back it, which external services it talks to, which team owns it, where it is deployed, and what watches it. Every relationship carries its evidence, so you can tell a confirmed edge from an inferred one.
Can I use Context Graph through MCP?
Yes. Point any MCP client you already run (your editor, your agent framework, your own harness) at https://mcp.postman.com/context-graph, or add the --context-graph toolset to the Postman MCP server, and the graph is available as a tool, without writing the HTTP request or handling the asynchronous polling yourself. The HTTP endpoint is still available for anything you'd rather build against directly.
When should I not use the graph?
When the answer is already in the files in front of you. Our benchmarking found that on a declared dependency, like who imports a module, go.mod answers outright: reading the repository scores 98% on its own and the graph adds nothing. It earns its keep on cross-boundary work.