MCP 服务器

Okta MCP Server

使Claude能够与Okta的用户管理系统交互，提供检索用户详细信息、列出带有过滤选项的用户以及管理用户组的功能。

README

Okta MCP 服务器

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

前提条件

Node.js (v16 或更高版本)
Claude 桌面应用
Okta 开发者帐户
来自 Okta 的管理员 API 令牌

设置说明

1. 创建一个 Okta 开发者帐户

前往 Okta 开发者控制台
创建一个新帐户或登录到现有帐户
记下您的 Okta 域名 (例如，dev-123456.okta.com)

2. 创建一个 API 令牌

在 Okta 开发者控制台中，转到 Security > API > Tokens
点击 "Create Token"
为您的令牌指定一个有意义的名称 (例如，"MCP Server Token")
复制令牌值 (您将无法再次看到它)

3. 初始项目设置

安装依赖项:

npm install

4. 配置 Claude 桌面

打开您的 Claude 桌面配置文件:

对于 MacOS:

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

对于 Windows:

code %AppData%\Claude\claude_desktop_config.json

添加或更新配置:

{
    "mcpServers": {
        "okta": {
            "command": "node",
            "args": [
                "PATH_TO_PROJECT_DIRECTORY/dist/index.js"
            ],
            "env": {
                "OKTA_ORG_URL": "https://your-domain.okta.com",
                "OKTA_API_TOKEN": "your-api-token"
            }
        }
    }
}

保存文件并重启 Claude 桌面。

可用工具

该服务器提供以下工具:

get_user

从 Okta 检索详细的用户信息，包括:

用户详细信息 (ID, 状态)
帐户日期 (创建时间, 激活时间, 上次登录时间等)
个人信息 (姓名, 电子邮件)
就业详情
联系方式
地址
偏好

list_users

从 Okta 列出用户，带有可选的过滤和分页功能:

支持 SCIM 过滤表达式 (例如，'profile.firstName eq "John"')
跨多个字段的自由文本搜索
排序选项 (按状态, 创建日期等)
支持可自定义限制的分页

list_groups

从 Okta 列出用户组，带有可选的过滤和分页功能:

用于组的过滤表达式 (例如，'type eq "OKTA_GROUP"')
跨组字段的自由文本搜索
排序选项 (按名称, 类型等)
支持可自定义限制的分页

在 Claude 中的示例用法

设置完成后，您可以使用如下命令:

"Show me details for user with userId XXXX" (显示 userId 为 XXXX 的用户的详细信息)
"What's the status of user john.doe@company.com" (john.doe@company.com 用户的状态是什么)
"When was the last login for user jane.smith@organization.com" (jane.smith@organization.com 用户上次登录是什么时候)
"List all users in the marketing department" (列出营销部门的所有用户)
"Find users created in the last month" (查找上个月创建的用户)
"Show me all the groups in my Okta organization" (显示我 Okta 组织中的所有组)
"List groups containing the word 'admin'" (列出包含单词 'admin' 的组)

错误处理

该服务器包括强大的错误处理功能，用于处理以下情况:

未找到用户或组 (404 错误)
API 身份验证问题
缺少或无效的用户配置文件
常规 API 错误

故障排除

常见问题

工具未出现在 Claude 中:

检查 Claude 桌面日志: tail -f ~/Library/Logs/Claude/mcp*.log
验证所有环境变量是否已正确设置
确保 index.js 的路径是绝对路径且正确

身份验证错误:

验证您的 API 令牌是否有效
检查 OKTA_ORG_URL 是否包含完整的 URL，包括 https://
确保您的 Okta 域名正确

服务器连接问题:

检查服务器是否成功构建
验证 build/index.js 的文件权限 (应为 755)
尝试直接运行服务器: node /path/to/build/index.js

查看日志

要查看服务器日志:

对于 MacOS/Linux:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

对于 Windows:

Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20

环境变量

如果您遇到环境变量错误，请验证:

OKTA_ORG_URL: 应该是完整的 URL (例如，"https://dev-123456.okta.com")
OKTA_API_TOKEN: 应该是有效的 API 令牌

安全注意事项

确保您的 API 令牌安全
不要将凭据提交到版本控制
使用环境变量存储敏感数据
定期轮换 API 令牌
在 Okta 管理控制台中监控 API 使用情况
为 API 调用实施速率限制
为 API 令牌使用所需的最低权限

类型

该服务器包括 Okta 用户和组数据的 TypeScript 接口:

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;
  };
}