local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Okta's user management system, providing tools for retrieving detailed user information, listing users with filtering and pagination options, and managing user groups.

Okta MCP 服务器

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

先决条件

Node.js（v16 或更高版本）
克劳德桌面应用程序
Okta开发者账户
Okta 的管理员 API 令牌

设置说明

1.创建 Okta 开发者账户

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

2. 创建 API 令牌

在 Okta 开发者控制台中，转到“安全”>“API”>“令牌”
点击“创建代币”
给你的令牌起一个有意义的名字（例如，“MCP 服务器令牌”）
复制令牌值（您将无法再看到它）

3. 初始项目设置

安装依赖项：

npm install

4.配置Claude桌面

打开您的 Claude Desktop 配置文件：

对于 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 Desktop。

可用工具

该服务器提供以下工具：

获取用户

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

用户详细信息（ID、状态）
帐户日期（创建、激活、上次登录等）
个人信息（姓名、电子邮件）
就业详情
联系信息
地址
偏好设置

列出用户

列出 Okta 中的用户，并提供可选的过滤和分页功能：

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

列表组

列出 Okta 中的用户组，并带有可选的过滤和分页功能：

组的过滤表达式（例如，'type eq“OKTA_GROUP”'）
跨组字段的自由格式文本搜索
排序选项（按名称、类型等）
具有可自定义限制的分页支持

Claude 中的示例用法

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

“显示用户 ID XXXX 的详细信息”
“用户john.doe@company.com的状态是什么？”
“用户jane.smith@organization.com的上次登录时间是什么时候”
“列出市场部所有用户”
“查找上个月创建的用户”
“显示我的 Okta 组织中的所有群组”
“列出包含单词‘admin’的组”

错误处理

该服务器包括强大的错误处理功能：

未找到用户或组（404 错误）
API 身份验证问题
用户资料缺失或无效
常规 API 错误

故障排除

常见问题

Claude 中未出现的工具：

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

身份验证错误：

验证您的 API 令牌是否有效
检查 OKTA_ORG_URL 是否包含带有 https:// 的完整 URL
确保您的 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;
  };
}

执照

MIT 许可证 - 有关详细信息，请参阅 LICENSE 文件。

支持

如果您遇到任何问题：

查看上面的故障排除部分
查看 Claude Desktop 日志
检查服务器的错误输出
查看 Okta 的开发者文档

注意：欢迎 PR！

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

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

Okta MCP Server