🚀 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
列出所有用户
列出 Okta 中的所有用户：
claudius list-users
💻 使用示例
基础用法
在 Claude 桌面应用程序中使用以下命令：
创建新组
claudius create-group --name "New Group"
删除指定组
claudius delete-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 开发者文档