gatewaystack-chatgpt-starter - AIアプリの三方認証解決、OAuth/JWT統合MCPサーバーフレームワーク

Gatewaystack Chatgpt Starter

GatewayStackは、ChatGPTなどのLLMに安全な認証とユーザーデータアクセスを提供するMCPサーバーフレームワークです。OAuth/JWTを通じてユーザー認証、権限管理、監査追跡を実現し、AIアプリケーションにおける三方認証問題を解決します。

セキュリティ開発者ツール #AIセキュリティゲートウェイ #認証 #ユーザーデータアクセス #MCPサーバー .TypeScript

スコア : 2ポイント

ダウンロード数 : 4.4K

更新時間 : 2025-12-29

サイトを開く

GatewayStack ChatGPTセキュリティコネクタとは？

これは、ChatGPT用に特別に設計されたModel Context Protocol (MCP)サーバーで、AIアプリケーションにおける「三方認証問題」を解決します。ユーザーがChatGPTを通じてあなたの内部ツール（カレンダー、販売データ、ドキュメントなど）にアクセスする際、このコネクタは、そのユーザー本人のみが自分のデータにアクセスできるようにし、他人のデータにはアクセスできないようにします。従来のAIアプリケーションにはセキュリティ上の脆弱性があります。ChatGPTはユーザーが誰であるかを知っていますが、あなたのバックエンドシステムは知らないのです。このコネクタはその間に信頼層を構築し、ユーザーのID情報を安全にあなたのシステムに伝え、データアクセスの正確性と安全性を確保します。

GatewayStackコネクタの使い方は？

最終ユーザーにとって、使用方法は非常に簡単です。 1. ユーザーがChatGPTであなたのツールを有効にします。 2. ChatGPTが自動的にユーザーをOAuthログインに導きます（必要な場合）。 3. ユーザーは通常通りChatGPTと会話します。 4. ChatGPTがユーザーデータにアクセスする必要があるとき、コネクタを通じて安全に取得します。開発者にとっては、このサーバーをデプロイし、OAuthプロバイダーを設定し、あなたのツールを統合する必要があります。

適用シーン

このソリューションは、以下のシーンに特に適しています。 • 企業の従業員がChatGPTを通じて個人の業務データ（カレンダー、メール、タスク）にアクセスする場合。 • カスタマーサービスAIが特定の顧客の注文履歴を確認する必要がある場合。 • 医療AIアシスタントが患者の医療記録にアクセスする必要がある場合（承認された医師のみ）。 • 販売チームがAIを通じて個人の販売データを分析する場合。 • ユーザー認証が必要な多テナントAIアプリケーション。

主要機能

OAuth認証統合

すべての主要なOAuth 2.0/OIDCプロバイダー（Auth0、Okta、Azure AD、Googleなど）をサポートし、ログインプロセスを自動的に処理し、ユーザーのIDを確実に検証します。

JWTトークン検証

ChatGPTからのJWTトークンを自動的に検証し、発行者、対象者、署名をチェックし、偽造されたリクエストを防止します。

細かい権限管理

各ツールに必要な権限範囲（scopes）を定義し、ユーザーが許可された機能のみにアクセスできるようにします。

完全な監査ログ

すべてのAIリクエストを記録します：誰が、いつ、どのモデルに、どの操作を要求したか。コンプライアンス要件を満たします。

MCPプロトコル互換性

ChatGPTのModel Context Protocolと完全に互換性があり、すべての標準MCP操作（ツールリスト、ツール呼び出し、リソースアクセスなど）をサポートします。

柔軟なデプロイオプション

ローカル開発、クラウドラン（Cloud Run）、コンテナ化デプロイをサポートし、完全なCI/CD設定例を提供します。

利点

🔐 エンドツーエンドのセキュリティ：ユーザーからバックエンドまでの完全な認証で、セキュリティ上の脆弱性がありません。

👥 ユーザーデータの分離：各ユーザーが自分のデータのみにアクセスでき、他人の情報を見ることはできません。

🏢 企業向け：SSO、権限管理、監査ログをサポートし、企業のセキュリティ要件を満たします。

⚡ 即座に使用可能：完全なインフラストラクチャコードを提供し、既存のツールを迅速に統合できます。

🔧 高度にカスタマイズ可能：カスタムIDマッピング、ツール定義、権限ロジックをサポートします。

📊 完全な可観測性：組み込みの構造化ログで、監視とトラブルシューティングが容易です。

制限

📚 学習曲線：OAuth、JWT、MCPなどの概念を理解する必要があり、正しく設定するには時間がかかります。

🔧 設定が複雑：OAuthプロバイダーと権限範囲を正しく設定する必要があります。

⚙️ 保守コスト：サーバーの継続的な保守と依存関係の更新が必要です。

🔗 外部サービスに依存：利用可能なOAuthプロバイダーと安定したネットワーク接続が必要です。

🚀 パフォーマンスのオーバーヘッド：追加の認証層により、わずかな遅延が発生します。

💾 リソース要件：サーバーを実行するためのインフラストラクチャが必要です。

使い方

環境の準備

コードリポジトリをクローンし、依存関係をインストールし、環境設定ファイルのテンプレートをコピーします。

OAuthプロバイダーの設定

あなたのIDプロバイダー（Auth0、Oktaなど）に合わせて環境変数を設定します。クライアントID、シークレット、発行者URLなどを含みます。

あなたのツールを定義する

tools.tsファイルにツール定義を追加または変更します。ツール名、説明、必要な権限範囲、実装ロジックを含みます。

ローカルでのテスト

開発サーバーを起動し、ツールが正常に動作するかテストし、認証プロセスを検証します。

本番環境へのデプロイ

提供されたCloud Run設定またはあなたが選択したプラットフォームを使用してサーバーをデプロイし、ドメインとSSL証明書を設定します。

ChatGPTでの設定

デプロイしたサーバーのURLをChatGPTのMCPサーバー設定に追加すると、ユーザーは使用を開始できます。

使用例

販売データの照会

営業担当者がChatGPTを通じて個人の販売実績を照会すると、システムはその担当者のデータのみを返し、他の同僚の情報を漏洩することはありません。

医療記録のアクセス

医師がAIアシスタントを通じて患者の医療記録を確認すると、システムは医師のIDと権限を検証し、承認された医師のみが特定の患者の記録にアクセスできるようにします。

プロジェクト管理

プロジェクトマネージャーがChatGPTを通じてチームのプロジェクト進捗を追跡すると、システムはユーザーの権限に基づいてアクセス可能なプロジェクトとタスクをフィルタリングします。

カスタマーサービス

カスタマーサービス担当者がAIアシスタントを通じて顧客の過去のやり取り履歴を照会すると、迅速に顧客の問題と対応履歴を把握できます。

よくある質問

このコネクタを使用するにはプログラミング知識が必要ですか？

どの認証プロバイダーをサポートしていますか？

このソリューションは安全ですか？

デプロイにどれくらいのコストがかかりますか？

ChatGPTが私のサーバーに接続できない場合はどうすればいいですか？

複数の異なるバックエンドシステムを同時にサポートできますか？

このソリューションと直接ChatGPTプラグインを使用する場合との違いは何ですか？

デプロイして実行するのにどれくらいの時間がかかりますか？

🚀 LLMに内部ツールを安全に公開する

このプロジェクトは、ユーザー、LLM、バックエンド間の信頼とガバナンスレイヤーを提供し、ChatGPT内からユーザー自身のデータに安全にアクセスできるようにします。

🚀 クイックスタート

git clone https://github.com/davidcrowe/gatewaystack-chatgpt-starter
cd gatewaystack-chatgpt-starter
npm install
cp .env.example .env
# Edit .env with your OAuth config
npm run dev

✨ 主な機能

MCP JSON-RPCエンドポイント (initialize, tools/list, tools/call) を POST /mcp で提供
OAuthディスカバリエンドポイント (/.well-known/*) を提供し、ChatGPTのOAuthディスカバリをサポート
@gatewaystack/identifiabl を使用したJWT検証 (発行者/対象者/JWKS)
@gatewaystack/request-context を通じたエンドツーエンドのリクエストコンテキストオブジェクト
ツールごとのスコープ制限
@gatewaystack/proxyabl を使用したツール実行プロキシ
@gatewaystack/explicabl を使用した構造化されたリクエストコンテキストロギング

📦 インストール

git clone https://github.com/davidcrowe/gatewaystack-chatgpt-starter
cd gatewaystack-chatgpt-starter
npm install
cp .env.example .env
# Edit .env with your OAuth config
npm run dev

💻 使用例

基本的な使用法

このスターターには2つのツールが付属しています。

whoami

ユーザーのIDが正しく流れていることを証明します (uid、sub、scopesを返します)。ツールの定義は src/tools/tools.ts にあります。

echo

メッセージをエコーバックします。ツールの定義は src/tools/tools.ts にあります。

高度な使用法

アプリケーションのカスタマイズには通常、以下の3つのことを変更するだけです。

1) ツールレジストリ

src/tools/tools.ts
ツール、必要なスコープ、MCPディスクリプタを定義
必要に応じて出力整形を追加 (summarizeToolResult、formatStructuredForToolなど)

2) アイデンティティマッピング

src/handlers/authHelpers.ts の subjectToUid(sub, email?)
OAuthのサブジェクトを内部のユーザーIDにマッピング

3) バックエンド実行 (オプション)

デモ用にはツールをローカルに保つことができます。実際のバックエンドを使用する場合は、以下のように設定します。

Proxyablを設定してバックエンドエンドポイントを呼び出す
下流にOAuthトークンを転送する
バックエンドでJWTを検証し、sub/uidを使用してデータをスコープ化する

📚 ドキュメント

ライブデモ → docs/live-demo.md
独自のインスタンスをデプロイする → docs/deploy-your-own.md
Auth0の設定 → docs/auth0-setup-guide.md
その他のアイデンティティプロバイダ → docs/other-idps.md
トラブルシューティング → troubleshooting.md
バックエンド統合パターン → docs/backend-integration-pattern.md
環境設定ガイド → docs/env-config-guide.md

🔧 技術詳細

信頼とガバナンスレイヤー

現代のAIアプリでは、ユーザー、LLM、バックエンドの3つのアクターが関与しますが、これらを結びつける共有アイデンティティレイヤーがありません。これにより、ユーザースコープのデータ、ポリシー、監査のギャップが生じます。

ユーザーはAIに自分のデータにアクセスしてほしい (ChatGPTが自分のカレンダーを読み取る)。
企業はAIモデルを使用できるユーザーを制御したい (医師のみが医療モデルを使用できる、取締役のみが機密性の高いプロンプトを送信できる)。
監査人は、誰がどのモデルに何をいつ要求したかを知りたい。

LLMとバックエンドの両方が、すべてのAIリクエストに関連付けられたユーザーアイデンティティの暗号証明を必要としますが、AIプラットフォームは自分たちの側でユーザーを認証し、バックエンドにはポリシーを適用したり、データをフィルタリングしたり、アクションをログに記録したりするための検証済みのアイデンティティがありません。これが三方向の問題です。