Okta User Management

🚀 Okta MCP 服務器

此 MCP 服務器讓 Claude 能夠與 Okta 的用戶管理系統進行交互，為用戶提供用戶和組管理的功能。

🚀 快速開始

本 MCP 服務器可助力 Claude 與 Okta 用戶管理系統交互，實現用戶和組管理。使用前，請確保滿足以下先決條件，並按設置說明操作。

先決條件

• Node.js（v16 或更高版本）
• Claude 桌面應用程序
• Okta 開發者賬戶
• Okta 的管理員 API Token

設置說明

1. 創建 Okta 開發者賬戶

• 訪問 Okta 開發者控制檯
• 創建新賬戶或登錄現有賬戶
• 記錄您的 Okta 域名（例如，dev-123456.okta.com）

2. 創建 API Token

• 在 Okta 開發者控制檯中，轉到“安全”>“API”>“令牌”
• 點擊“創建令牌”
• 為您的令牌起一個有意義的名稱（例如，“MCP 服務器令牌”）
• 複製令牌值（之後將無法再次查看）

3. 初始項目設置

安裝依賴項：

npm install

4. 配置 Claude 桌面應用程序

在 config.json 文件中添加以下內容：

{
  "okta": {
    "url": "https://your-domain.okta.com",
    "token": "your-okta-token"
  }
}

✨ 主要特性

可用工具

獲取用戶詳細信息

使用 get-user 命令獲取單個用戶的詳細信息：

claudius get-user --id <user-id>

列出所有用戶

列出 Okta 中的所有用戶：

claudius list-users

💻 使用示例

基礎用法

在 Claude 桌面應用程序中使用以下命令：

創建新組

claudius create-group --name "New Group"

刪除指定組

claudius delete-group --id <group-id>

🔧 技術細節

錯誤處理

常見錯誤

1. 權限不足：確保您的 API Token 具有管理員權限。
2. 連接問題：檢查 Okta 服務狀態或網絡連接。

故障排除

檢查配置文件

確保 config.json 文件中的 URL 和令牌值正確無誤。

查看日誌

在控制檯中查看 Claude 桌面應用程序的日誌輸出以獲取更多信息。

安全注意事項

• 實施速率限制以防止濫用。
• 監控 API 使用情況，確保合規性。
• 定期審查和最小化 API Token 的權限。

類型定義

服務器包含 TypeScript 接口用於 Okta 用戶和組數據：

interface OktaUserProfile {
  login: string;
  email: string;
  secondEmail?: string;
  firstName: string;
  lastName: string;
  displayName: string;
  nickName?: string;
  organization: string;
  title: string;
  division: string;
  department: string;
  employeeNumber: string;
  userType: string;
  costCenter: string;
  mobilePhone?: string;
  primaryPhone?: string;
  streetAddress: string;
  city: string;
  state: string;
  zipCode: string;
  countryCode: string;
  preferredLanguage: string;
  profileUrl?: string;
}

interface OktaUser {
  id: string;
  status: string;
  created: string;
  activated: string;
  lastLogin: string;
  lastUpdated: string;
  statusChanged: string;
  passwordChanged: string;
  profile: OktaUserProfile;
}

interface OktaGroup {
  id: string;
  created: string;
  lastUpdated: string;
  lastMembershipUpdated: string;
  type: string;
  objectClass: string[];
  profile: {
    name: string;
    description: string;
  };
}

📄 許可證

MIT License - 有關詳細信息，請參閱 LICENSE 文件。

📚 詳細文檔

如遇到任何問題：

• 檢查故障排除部分
• 查看 Claude 桌面應用程序日誌
• 檢查 Okta 開發者文檔