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

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などの基本構成を解説します。

Claude CodeのPermission・Hook・Sandbox、GitHub CopilotのCustom Instructions、Docker Read Only Mount、GitやCIまで、AIコーディングツールに変更してほしくないファイルを複数の層で守る設計を解説します。

GitHub Copilotがcopilot-instructions.mdの指示を無視しているように見えるとき、配置場所・Workspace Root・References・VS Code設定・Path-specific Instructions・機能ごとの対応差という観点から原因を切り分ける方法を解説します。

Claude CodeのHooksが実行されない、またはexit codeやJSONによる制御が効かないとき、matcher・Hook Event・exit code(0/1/2)・stdin/stdoutのJSON形式・Script Pathという観点から原因を切り分ける方法を解説します。

Claude Codeのsettings.jsonを変更しても権限やHook、環境変数が反映されないとき、User・Project・Localの優先順位、settings.local.jsonとの競合、~/.claude.jsonとの混同、/status・/doctorでの確認方法という観点から原因を切り分ける方法を解説します。

Claude CodeがCLAUDE.mdの指示を無視しているように見えるとき、/contextでの確認方法、配置場所ごとの読み込み範囲、優先順位、サブディレクトリや@インポートの読み込みタイミングという観点から原因を切り分ける方法を解説します。