外部AIエコシステムゲートウェイ

MCP互換アシスタントクライアントに権限スコープ付きツールを公開しつつ、Slackなどの外部システムへのアクセスを仲介する、セキュリティ重視のPythonゲートウェイです。テナント分離、委任認可、機密性の高い書き込みに対する人間の確認、冪等実行、署名付きWebhook検証、失効対応の付与ストレージ、ハッシュチェーン監査証跡を実証します。

これはポートフォリオ／参考実装であり、本番用のアイデンティティプロバイダではありません。ヘッダーベースの開発用認証アダプタは、デプロイ前にdocs/security.mdに記載されているOIDC検証ミドルウェアに置き換える必要があります。

アーキテクチャ

Assistant / Slack client
          |
          v
  FastAPI edge + auth adapter
          |
          v
 Policy + tenant boundary ----> confirmation tokens
          |
          v
 Sandboxed tool registry -----> Slack / OpenAI / Claude adapters
          |
          +--------------------> idempotency store
          +--------------------> append-only hash-chained audit log

Related MCP server: MCP Tool Manager

クイックスタート

python -m venv .venv
source .venv/bin/activate
pip install -e '.[dev]'
uvicorn ecosystem_gateway.app:app --reload

ツール一覧:

curl localhost:8000/mcp/tools \
  -H 'X-Subject: user-1' -H 'X-Tenant-Id: tenant-a' -H 'X-Roles: operator'

pytestでテストスイートを実行します。Slackトークンが設定されていない場合、コネクタは安全なサンドボックスモードで動作し、発行する予定のリクエストを返します。

セキュリティ特性

• すべてのプリンシパルと冪等性キーはテナント名前空間に分離されます。

• ツールポリシーは、最小権限ロールと委任スコープを組み合わせます。

• 権限性の高い書き込みには、サブジェクト、テナント、ツール、引数にバインドされた短命トークンが必要です。

• Webhook署名は定数時間比較を使用し、古いリクエストを拒否します。

• 監査レコードはSHA-256チェーンを形成し、削除や改変を検出可能にします。

• OAuth付与は失効をサポートし、ツール結果を通じてリフレッシュトークンを公開することはありません。

本番の堅牢化チェックリストと脅威モデルについては、docs/security.mdを参照してください。

ライセンス

MIT