フィールドガイド / 16 分
MCP で外部 system を接続する
Transport、auth、tool policy、failure behavior を contract にする。
Codex は STDIO と Streamable HTTP MCP をサポートし、CLI・IDE・desktop app が host config を共有します。Connection には transport、auth source、timeouts、required status、enabled tools、approval behavior が必要です。
CLI
検証済みターミナル手順
- $
codex mcp add openaiDeveloperDocs --url https://developers.openai.com/mcp - $
codex mcp list - $
codex mcp login <server> - ›
/mcp
A
作業原則
Connection ≠ trust
Identity、auth、instructions、tool annotations を review。
Tool surface を constrain
Enabled/disabled lists と per-tool approvals。
Required は loud failure
Silent degradation が危険なら required=true。
B
フィールド手順
- 01
Docs MCP lab
公式 OpenAI docs endpoint を command で追加。
- 02
List/inspect
codex mcp list と /mcp。
- 03
Auth separately
OAuth は codex mcp login、token を commit しない。
- 04
Tools/approvals scope
必要 tools のみ、writes は prompt。
- 05
Failure test
Unavailable/slow/error を確認。
PASS / FAIL
受入チェック
- Identity/transport known。
- Secret source appropriate。
- Required tools only。
- Critical failure not silent。
WATCH / REJECT
失敗パターン
- Bearer token commit。
- 全 MCP tool を read-only と仮定。
- Optional server presence 未確認。