Okta MCP Server

🚀 プロジェクト概要

MCPプロトコルに基づくOkta APIインターフェースサーバーです。主にAIアシスタントとOkta間のやり取りに使用されます。現在のバージョンでは、基本的なユーザーとグループ情報の照会機能をサポートしています。

✨ 主な機能

• プロトコル互換性：MCPプロトコル仕様に準拠しています。
• セキュリティ設計：デフォルトでは読み取り専用アクセスで、書き込み操作には追加の承認が必要です。
• 拡張性：徐々により多くのAPIインターフェースのサポートを追加する予定です。
• マルチテナントサポート：将来のバージョンでマルチテナント管理を実装予定です。

📦 インストール

プロジェクトのクローン

git clone https://github.com/fctr-id/okta-mcp-server.git
cd okta-mcp-server

環境の構築

python -m venv venv
source venv/bin/activate  # Windowsシステムの場合は：venv\Scripts\activate
pip install -r requirements.txt

📚 ドキュメント

設定の説明

設定ファイルを作成します：

cp .env.sample .env
# .envファイルを編集し、Oktaドメイン名とAPIトークンなどの情報を記入します

コマンドラインクライアントを起動します：

cd clients
python mcp-cli-stdio-client.py

サポートされる伝送プロトコル

1. 標準入出力 (STDIO) - 推奨

• セキュリティ：標準入出力ストリームを通じて通信します。
• 適用シナリオ：Claude DesktopなどのデスクトップAIアシスタントに適しています。
• 設定例（Claude Desktopに適用）：

{
  "mcpServers": {
    "okta-mcp-server": {
      "command": "ABS_PATH/venv/Scripts/python",
      "args": [
        "ABS_PATH/main.py"
      ],
      "env": {
        "OKTA_CLIENT_ORGURL": "https://dev-1606.okta.com",
        "OKTA_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

2. Server-Sent Events (SSE) - 高度な使用

python main.py --sse --iunderstandtherisks

⚠️ 重要提示

SSEモードでは、サービスがネットワークを介してアクセス可能になり、大きなセキュリティリスクがあります。制御された環境でのみ使用してください。

既知の制限

• 現在のバージョンでは機能が限られており、主にユーザーとグループの読み取り操作をサポートしています。
• 大型Oktaインスタンスのパフォーマンス最適化はまだ完了していません。
• 一部の複雑なOkta関係は公開されていません。
• 完全なドキュメントとサポートが不足しています。

将来の計画

• 完全なドキュメント：詳細な使用方法と設定ガイドを提供します。
• 完全なユーザーライフサイクル管理
• アプリケーション割り当て管理
• グループメンバー操作
• 要素登録と検証
• ポリシーとルール管理
• 承認ワークフロー
• 複数チャネルの承認オプション（ウェブ、メール、Slackなど）
• 監査ログとコンプライアンスレポート
• システムログの統合
• セキュリティインサイトの生成
• マルチテナントサポート
• ロールベースのアクセス制御

サポートとヘルプ

問題解決手順

1. サーバー設定を確認します。
2. Okta APIの権限設定を確認します。
3. MCPクライアントの互換性を検証します。
4. サーバーログを確認します。

まだ疑問がある場合は、GitHubで問題を提出するか、support@fctr.ioに連絡してください。

機能リクエストと提案

何かアイデアや提案があれば、GitHubで機能リクエストを提出してください。

貢献者

興味のある開発者は、info@fctr.ioまでご連絡ください。

法的声明

詳細については、ファイルをご覧ください。

🌟 © 2025 Fctr Identity. 全著作権所有。OktaとAIコミュニティのために誠心誠意作られました。