Model Context Protocol (MCP) Live Agent Infrastructure

AI エージェント向けの OAuth 保護ポートフォリオアクセス

接続ガイド • 検出エンドポイント

概要

• 役割：フルスタックエンジニアリング、OAuth と MCP の実装
• スタック：Next.js、TypeScript、Model Context Protocol、Streamable HTTP、OAuth 2.1、PKCE S256、Upstash Redis
• 成果：AI エージェントに検証済みの読み取り専用ポートフォリオデータを提供する MCP サーバー。

課題

ポートフォリオ情報は AI エージェントにとって有用ですが、公開ウェブサイトだけでは、一貫性のある認証済みツールインターフェースを提供できません。プライベート設定を公開せず、長期的なシークレットを発行せず、書き込みアクセスを許可せずに、検証済みデータを公開する必要がありました。

アプローチ

• /.well-known 配下で MCP、保護リソース、OAuth 認可メタデータを公開します。
• 匿名パブリッククライアントを登録し、PKCE S256 と portfolio.read スコープを含む認可コードフローを使用します。
• プロジェクト、スキル、経験、認定資格、公開プロフィール、ソーシャルリンク用の読み取り専用ツールを提供します。
• 本番環境では Redis により認可コードの一回限りの交換を保護します。

利用可能なツール

検証

本番エンドポイントは、メタデータ検出、パブリッククライアント登録、認可承認、PKCE トークン交換、MCP 初期化、ツール検出、およびすべての読み取り専用ツール呼び出しを通じて外部検証しました。

接続

MCP 対応エージェントを検出エンドポイントへ接続してください。手動 OAuth 統合については接続ガイドを参照してください。