</>CodingLSコーディングライフスタイル

MCPの2026-07-28仕様で、initializeハンドシェイクとMcp-Session-Idが廃止され、プロトコルはステートレスになりました。何が変わったのか、新旧クライアントとサーバーの互換性、状態を引数のIDで持つ設計、TypeScript SDK v2への移行手順を、実際にサーバーを動かしてcurlで確認した結果とあわせて解説します。

Codex Goals（/goal）は、達成条件を設定して複数ターンにわたり作業を続けさせる機能です。導入方法、/goalの操作、Planモード・AGENTS.mdとの違い、テスト失敗を直させる実例（実行確認済み）、完了条件と停止条件の書き方、勝手に止まる原因と予算の考え方を、公式ドキュメントに沿って解説します。

GitHub Agentic Workflows（gh aw）は、Markdownで書いた指示をAIエージェントがGitHub Actions上で実行する仕組みです。導入手順、Issueの自動分類とPRレビューの設定例、safe-outputsによる書き込みの制限、Claude CodeやCodexの認証、roles・min-integrityなどの安全設定、料金の考え方を、公式ドキュメントに沿って解説します。

Claude Codeのpermissionsで、gitやnpmなどのBashコマンドを「許可・確認・禁止」に振り分ける設定例をまとめました。git push、npm install、rm、findの扱い、複合コマンドとラッパーの照合、dontAskを使った許可リスト運用まで、公式ドキュメントに沿って解説します。

permissions.allowは確認を省くルール、denyは実行を止めるルールです。評価順序（deny→ask→allow）、許可リストに書かないとどうなるか、Bashのワイルドカードの落とし穴、.envを守るRead deny、denyでは防げない迂回とSandboxの使い分けを、公式ドキュメントに沿って安全な設定例とともに解説します。

CLAUDE.mdは長く書くほど守られるわけではありません。200行未満の目安、削除テスト、含める情報と除外する情報、検証できる具体的な書き方、強調の使い方、.claude/rules/・Skills・Hooksへ移す基準、/doctor prompt-auditの使い方をまとめます。

Claude CodeのCLAUDE.mdをどこに置くか、誰に適用したいルールかで判断する方法を解説。~/.claude/CLAUDE.md、プロジェクトのCLAUDE.md、CLAUDE.local.md、.claude/rules/の使い分けと、200行の目安、AGENTS.mdとの関係、/initと/memoryの使い方までまとめます。

MCP 2026-07-28でRoots・Sampling・Loggingが非推奨になった理由と影響を解説。Deprecatedと削除の違い、Tool Parameter・Resource URI・Server Configurationへの置き換え、LLM Provider APIの直接利用、InputRequiredResultとの関係、移行とテストの手順をまとめます。

MCPサーバーを本番運用するときの監視設計を解説。ログ・メトリクス・トレースの役割分担、Tool単位のメトリクスとp95・p99、OpenTelemetryのSpanとサンプリング、Health Check、Alertの作り方、複数Replicaでの注意点、障害調査の手順までまとめます。

MCPサーバーを複数接続すると遅くなるのかを解説。Server数ではなくTool Definitionの総量が重要な理由、Claude Codeでの既定の挙動、/contextと/mcpでの確認方法、defer_loadingやTool Searchの使いどころ、Tool Catalogを小さくする設計までまとめます。

stdio方式のMCPサーバーをDockerで動かす基本構成を解説。docker run -iが必要な理由、-tを付けない理由、stdoutにログを出してはいけない理由、Bind Mountとread-only、Working Directory、Windowsでの注意点までDockerfileと設定例付きで紹介します。

MCPで同じTool名を登録すると何が起きるのかを解説。Server内で一意にする理由、別Server間の名前衝突、Claude Codeのmcp__server__tool形式、Scopeによる上書き、Tool名のNamespace設計と検証方法をPythonの例付きで紹介します。

MCP Toolで削除・更新などの破壊的操作を実装する際の安全な設計を解説。destructiveHint/idempotentHintの正しい使い方、Elicitationによる確認フロー、expected_versionによる楽観的ロック、Soft Delete、Idempotency Key、監査ログまでPythonの実装例付きで紹介します。

MCPサーバーでファイルを読み込むToolを作る際のパストラバーサル対策を解説。許可Directoryの固定、path.resolve/realpathによる境界チェック、Symlink対策、Roots非推奨化の注意点まで、TypeScriptとPythonの実装例付きで紹介します。

MCP Toolのレスポンスを小さく保つための設計指針を、limit・Cursor Pagination・Summary・詳細取得Toolの分離・ResourceLink・Server側Aggregationなどの実例で解説します。

MCP ToolのoutputSchema・structuredContent・contentの違いを整理し、いつStructured Outputが必要か、Python SDK/TypeScript SDKでの実装方法まで解説します。

MCP ToolのinputSchemaをJSON Schemaでどう書くか、required・enum・配列・Nested Object・oneOf・anyOfの実例と、Python SDK/Pydanticでの自動生成方法まで解説します。

MCPサーバーの3つの基本機能tools・resources・promptsの違いを、Model-controlled・Application-controlled・User-controlledという判断基準で整理し、検索・データ参照・更新処理・コードレビューなどをどこへ実装するべきか解説します。

MCPサーバーをOAuth 2.1のResource Serverとして保護する実装方法を、TokenVerifier・Audience・Scope・Token保存・ログ・Refresh Token・外部APIへのToken Passthrough回避まで解説します。

MCPサーバーをstdioのローカル利用からStreamable HTTPでのリモート公開へ移行する際に必要な、HTTPS・Reverse Proxy・Host Allowlist・OAuth 2.1 Bearer Token・TokenVerifierなどの基本構成を解説します。