Okta MCP Server

Okta MCP Server

site icon
2025.03.24 0
TypeScript用户管理组管理API 集成开发效率
Okta MCP Server 是一个与 Okta 用户管理系统交互的 MCP 服务器,提供用户和组管理功能。它允许 Claude 通过 API 访问和管理 Okta 中的用户信息、组信息,并支持多种查询和过滤功能。
View on GitHub

Overview

基本能力

产品定位

Okta MCP Server 是一个中间件服务,旨在为 Claude 提供与 Okta 用户管理系统交互的能力,实现用户和组的管理功能。

核心功能

  1. 用户管理
  2. 获取用户详细信息(ID、状态、账户日期、个人信息、就业详情、联系方式等)
  3. 列出用户(支持过滤、搜索、排序和分页)
  4. 组管理
  5. 列出用户组(支持过滤、搜索、排序和分页)
  6. 错误处理
  7. 处理用户或组未找到、API 认证问题、无效用户配置等错误
  8. 安全考虑
  9. API 令牌安全、环境变量管理、权限最小化等

适用场景

  1. 查询用户详细信息
  2. 批量列出用户或组
  3. 根据条件筛选用户或组
  4. 管理 Okta 用户和组

工具列表

  1. get_user:获取用户详细信息
  2. list_users:列出用户(支持过滤、搜索、排序和分页)
  3. list_groups:列出用户组(支持过滤、搜索、排序和分页)

常见问题解答

  1. 工具未出现在 Claude 中:检查日志、环境变量和路径
  2. 认证错误:验证 API 令牌和 Okta 域名
  3. 服务器连接问题:检查构建、文件权限和直接运行

使用教程

使用依赖

  1. Node.js (v16 或更高版本)
  2. Claude 桌面应用
  3. Okta 开发者账户
  4. Okta 的管理 API 令牌

安装教程

  1. 创建 Okta 开发者账户bash # 访问 Okta 开发者控制台并创建账户
  2. 创建 API 令牌bash # 在 Okta 开发者控制台中创建并复制令牌
  3. 初始项目设置bash npm install
  4. 配置 Claude 桌面
  5. MacOS: bash code ~/Library/Application\ Support/Claude/claude_desktop_config.json
  6. Windows: bash code %AppData%\Claude\claude_desktop_config.json
  7. 添加或更新配置: 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" } } } }

调试方式

  1. 查看日志
  2. MacOS/Linux: bash tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
  3. Windows: powershell Get-Content -Path "$env:AppData\Claude\Logs\mcp*.log" -Wait -Tail 20
  4. 验证环境变量
  5. OKTA_ORG_URL:完整的 URL
  6. OKTA_API_TOKEN:有效的 API 令牌
  7. 直接运行服务器bash node /path/to/build/index.js

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。