管理画面の Web-API を OpenAPI から MCP ツールにし、自前の IdP の OAuth で Claude から操作する

MCP サーバーを複数接続するとツール定義とレスポンスで毎ターン数万トークンが消費される問題が発生。この構造的課題に対し、Unix CLI ベースのアプローチで最大 98% のトークン削減が可能な一方、セキュリティとのトレードオフを考慮した設計が必須となる。

Notion の読み取り専用ユースケースにおいて、MCP経由のリアルタイムAPIとローカル Markdown 同期を比較検証した結果、ローカル同期（ripgrep で 10-50ms）が MCP（300-900ms/リクエスト）を圧倒的に上回った。API のレートリミット（平均3req/秒）とネットワーク往復が主原因で、書き込みが不要なら Markdown ミラーを構築する方が現実的。

自宅サーバーの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 のみ対応という制約がある。