Okta MCP 服务器

此 MCP 服务器使 Claude 能够与 Okta 的用户管理系统交互，提供用户和组管理功能。

先决条件

• Node.js (v16 或更高版本)
• Claude 桌面应用程序
• Okta 开发者账户
• Okta 的管理员 API Token

设置说明

1. 创建 Okta 开发者账户

• 访问 Okta 开发者控制台
• 创建新账户或登录到现有账户
• 记录您的 Okta 域名 (e.g., 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 开发者文档