JinDaGe - Okta User Management MCP Details

article

README

🚀 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>

🔧 技术细节

错误处理

常见错误

权限不足：确保您的 API Token 具有管理员权限。
连接问题：检查 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 开发者文档

Okta User Management