01 / DECIDE
Architecture decision
全 integration を custom function で再実装せず、governed external capability/data を接続する場合に使う。
有効化前に server identity、transport、authentication、exposed tools、returned data、approval、failure behavior を棚卸しする。 input、output、state、side effect を一つの観測可能な経路にしてから、MCP server を external principal として扱う の所有層を決めます。
02 / BUILD
3段階の実装
- 01
contract を定義
caller、data classification、success condition、timeout、cancel、ownership を先に記述します。全 integration を custom function で再実装せず、governed external capability/data を接続する場合に使う。
- 02
狭い経路を構築
request correlation、typed state、reversible failure handling を持つ一つの end-to-end path だけを実装します。有効化前に server identity、transport、authentication、exposed tools、returned data、approval、failure behavior を棚卸しする。
- 03
outcome を証明
acceptance を再実行可能な fixture、contract test、browser test にします。negative test で untrusted server、changed schema、expired credential、injected content が安全に失敗することを示す。
03 / BOUND
Production boundary
trusted server のみ接続し、tool を最小化し、returned content を検証し、high-impact call は approval 配下に置く。
04 / PROVE
Acceptance evidence
negative test で untrusted server、changed schema、expired credential、injected content が安全に失敗することを示す。
SOURCE / HTTP
再現可能な source probe
curl -fsSI 'https://developers.openai.com/api/docs/guides/tools-connectors-mcp' | sed -n '1,5p'