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 开发者文档