Claude API で作る生成AIアプリ実践入門 ― プロンプト設計・Tool use・RAG・エージェント・MCP を一気通貫で

自宅サーバーのObsidian Vaultに外出先のスマホから安全にアクセスするため、OAuth 2.1 + MCP を組み合わせた認証アーキテクチャを設計した。認可サーバー層とゲートウェイ層を分離し Cloudflare Tunnel を経由する構成を検討したが、Claude モバイルアプリのカスタムMCP接続に未解決バグが存在することが判明、実装は延期した。

Claude.ai のカスタムコネクタで MCP サーバーを接続する際、OAuth 2.1 + PKCE、Dynamic Client Registration（/register エンドポイント）、Authorization Server Metadata の実装が必須となる。認証なしでの接続やURLトークン埋め込みは仕様上不可で、トランスポートは Streamable HTTP のみ対応という制約がある。

Anthropicの最新動向をまとめたニュース索引。OAuth権限の細分化、MCP活用での業務自動化、Claude Codeの研究論文適用、モデル訓練の一時停止による安全性確保、Enterprise Frontier Safeguardsの商用化など、派手さより「現場運用の標準化」に焦点を当てた施策を紹介している。

Claude API のプロンプトキャッシュ機能を使うと、繰り返し送る部分の読み取りコストを通常入力の約1/10に削減できる。実装は cache_control フラグを付けるだけだが、モデルごとの最小トークン数未満は無視される、プレフィックスの1バイト変更でキャッシュ全滅、tools 変更で先頭から無効化される、の3つのハマりどころがある。usage.cache_read_input_tokens で実測確認必須。