Okta MCP Server

🚀 基於MCP協議的Okta API接口服務器

本項目是一個基於MCP協議的Okta API接口服務器，主要用於實現AI助手與Okta之間的交互。當前版本已支持基本的用戶和組信息查詢功能，為相關業務提供了基礎的數據交互能力。

🚀 快速開始

本項目是一個基於MCP協議的Okta API接口服務器，用於實現AI助手與Okta之間的交互。以下是快速開始的步驟：

項目克隆

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

✨ 主要特性

• 協議兼容性：符合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

💻 使用示例

支持的傳輸協議

標準I/O (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"
      }
    }
  }
}

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。

法律聲明

詳細信息請查閱LICENSE.md文件。

🌟 © 2025 Fctr Identity. 版權所有。為Okta和AI社區傾心打造。