Skip to main content
Glama
enesjakozh
kapilduraphe

Okta MCP Server

by kapilduraphe
OverviewInspectSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Okta MCP 服务器

该 MCP 服务器使 Claude 能够与 Okta 的用户管理系统进行交互，提供全面的用户和组管理功能以及入职自动化。

先决条件

  • Node.js（v16 或更高版本）

  • 克劳德桌面应用程序

  • Okta开发者账户

  • Okta 的管理员 API 令牌

Related MCP server: Enhanced Outlook MCP Server

设置说明

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 中激活用户：

  • 发送激活电子邮件的选项

  • 将用户状态更新为活跃

暂停用户

在 Okta 中暂停用户

取消暂停用户

取消 Okta 中先前暂停的用户

删除用户

从 Okta 中删除用户（注意：必须先停用用户）

获取用户最后位置

从 Okta 系统日志中检索用户的最后已知位置和登录信息

集团管理

列表组

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

  • 组的过滤表达式（例如，'type eq“OKTA_GROUP”'）

  • 跨组字段的自由格式文本搜索

  • 排序选项（按名称、类型等）

  • 具有可自定义限制的分页支持

创建组

在 Okta 中创建一个新组，并指定名称和可选描述

获取组

检索特定组的详细信息

删除组

从 Okta 中删除一个组

将用户分配给组

在 Okta 中将用户分配到组

从组中删除用户

从 Okta 中的组中删除用户

列出组用户

列出特定组中的所有用户，并支持分页

入职自动化（实验性）

**注意：**入门自动化工具尚处于实验阶段，可能会根据 Okta 的 API 限制而有所变更或受限。请在生产环境中谨慎使用。

批量用户导入

从 CSV 字符串导入多个用户：

  • 根据 CSV 数据创建用户帐户

  • 用户可选激活

  • 可选的电子邮件通知

  • 分配到默认组

将用户分配到组

根据属性映射将多个用户分配到组：

  • 将用户属性（部门、职称等）映射到特定组

  • 根据属性批量分配用户

预配应用程序

为多个用户提供应用程序访问权限：

  • 将用户分配到应用程序

  • 支持批量配置

运行入职工作流

通过 CSV 数据为多个用户运行完整的入职工作流程：

  • 从 CSV 导入用户

  • 自动激活

  • 基于属性的组分配

  • 应用程序配置

  • 欢迎电子邮件配置

Claude 中的示例用法

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

用户管理

  • “显示用户 ID XXXX 的详细信息”

  • “用户john.doe@company.com的状态是什么？”

  • “用户jane.smith@organization.com的上次登录时间是什么时候”

  • “列出市场部所有用户”

  • “查找上个月创建的用户”

  • “激活 ID XXXX 的用户”

  • “暂停 ID 为 XXXX 的用户”

  • “删除 ID 为 XXXX 的已停用用户”

  • “用户XXXX上次从哪里登录的？”

集团管理

  • “显示我的 Okta 组织中的所有群组”

  • “列出包含单词‘admin’的组”

  • “创建一个名为‘营销团队’的新组”

  • “获取 ID 为 XXXX 的组的详细信息”

  • “删除 ID 为 XXXX 的组”

  • “将用户 XXXX 添加到组 YYYY”

  • “从组 YYYY 中删除用户 XXXX”

  • “列出‘财务’组中的所有用户”

入职自动化

  • “从 CSV 数据导入这些用户：[CSV 内容]”

  • “根据部门属性将用户分配到组”

  • “为这 5 位用户提供应用程序访问权限”

  • “为这些新员工运行完整的入职流程：[CSV 内容]”

错误处理

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

  • 未找到用户或组（404 错误）

  • API 身份验证问题

  • 用户资料缺失或无效

  • 常规 API 错误

  • CSV解析问题

  • 用户属性映射失败

  • 应用程序配置错误

故障排除

常见问题

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

用于入职培训的 CSV 格式

使用批量导入或入职工作流工具时，您的 CSV 应包含以下标题：

  • firstName （必填）

  • lastName （必填）

  • email （必填）

  • department （可选）

  • title （可选）

  • mobilePhone （可选）

例子：

firstName,lastName,email,department,title,mobilePhone John,Doe,john.doe@example.com,Engineering,Senior Developer,+1-555-123-4567 Jane,Smith,jane.smith@example.com,Marketing,Director,+1-555-987-6543

执照

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

支持

如果您遇到任何问题：

  • 查看上面的故障排除部分

  • 查看 Claude Desktop 日志

  • 检查服务器的错误输出

  • 查看 Okta 的开发者文档

注意：欢迎 PR！

This server cannot be installed

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Resources

Tools

View all tools

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/kapilduraphe/okta-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server