内容
# RapidID MCP 服务器
[](https://github.com/Jamf-Concepts/mcp-rapidid/releases)
RapidID MCP 服务器使支持模型上下文协议（MCP）的 AI 应用（如 Claude Desktop）能够与 RapidID 身份管理系统进行交互。它提供了用于搜索用户、管理权限、查询组、查看审计日志和处理 Connect 操作集的工具。
## 入门指南
### 使用 Claude 扩展
1. 下载适用于您操作系统的 mcpb 包
2. 打开 Claude Desktop 并转到 设置 ➡️ 扩展 ➡️ 高级设置 ➡️ 安装扩展
3. 从步骤 1 中选择 mcpb 包
4. 输入主机名和用户名/密码或服务标识
### 使用二进制文件
从发行版中下载适用于您操作系统的二进制文件，并按照模型上下文协议的使用说明进行操作。
## 与模型上下文协议配合使用
要使用 RapidID 用户名和密码将此服务器与支持 MCP 的应用程序集成
```json
{
"mcpServers": {
"mcp-rapidid": {
"command": "<下载的二进制文件路径>",
"env": {
"RI_USER": "kclarkson",
"RI_PASSWORD": "notarealpassword123",
"RI_HOST": "portal.us006-rapididentity.com"
}
}
}
}
```
要使用 RapidID 服务标识将此服务器与支持 MCP 的应用程序集成。请注意，服务标识即使具有租户管理员角色，也无法访问所有 API 端点。
```json
{
"mcpServers": {
"mcp-rapidid": {
"command": "<下载的二进制文件路径>",
"env": {
"RI_SERVICE_IDENTITY_SECRET_KEY": "1jdie203i4jjf9",
"RI_HOST": "portal.us006-rapididentity.com"
}
}
}
}
```
## 工具
- `search-users`: 根据身份验证用户可用的委托执行简单搜索。
- `search-entitlements-for-user`: 根据用户的 idautoID 搜索用户的权限。
- `start-entitlement-request`: 为特定用户和权限发起权限请求，分别基于 idautoID 和 resourceId。
- `get-my-delegations`: 获取身份验证用户可访问的委托。这基于环境变量中包含的凭证。
- `get-user-info-in-delegation`: 执行 RapidID 委托的 advanced 搜索。
- `search-groups`: 执行 RapidID 组的简单搜索。
- `get-group-members`: 获取指定 RapidID 组的成员。
- `get-user-activity-from-audit-log`: 返回特定 RapidID 用户在给定日期范围内的审计日志活动。
- `get-connect-projects`: 返回所有 RapidID Connect 项目
- `get-connect-actions`: 返回项目内的 Connect 操作集，或所有项目中的 Connect 操作集
- `get-connect-action`: 返回单个 RapidID Connect 操作集，ID 指定
- `save-connect-action`: 保存（创建或更新）RapidID Connect 操作集
- `delete-connect-action`: 删除 RapidID Connect 操作集，ID 指定
- `get-password-policies-for`: 检索指定用户的密码策略
- `set-password`: 通过委托为一个或多个用户设置 RapidID 密码
- `run-connect-action`: 运行 RapidID Connect 操作集并返回 HTML 日志
- `get-connect-files`: 返回 RapidID Connect 文件模块中文件和目录的元数据
- `get-connect-file-content`: 返回 RapidID Connect 文件模块中文件的文本内容
## 技能
- [RapidID 角色挖掘](./skills/rapididentity-role-mining/SKILL.md): 用于为静态 RapidID 组识别动态筛选器的过程。
- [Connect 操作集](./skills/connect-action-sets/SKILL.md): 关于如何使用 RapidID Connect 操作集的知识。
## 故障排除
- 身份验证失败时，请确保 RI_HOST、RI_USER / RI_PASSWORD 或 RI_SERVICE_IDENTITY_SECRET_KEY 设置正确
- 如果在使用 `search-users` 或 `get-user-info-in-delegation` 时收到意外的空数组 `[]`，这可能是由于使用了服务标识，切换到用户名和密码将解决问题。
- 服务标识即使具有租户管理员角色，也无法访问所有端点，通常表现为接收空响应，例如空数组 `[]` 或空对象 `{}`。
- `get-user-info-in-delegation` 不支持分页，这可能导致工具响应大小错误。解决此问题的一种方法是结合使用 `search-groups` 和 `get-group-members` 工具，将用户分成多个工具调用，因为 `get-group-members` 工具支持分页。
- 如果在使用 `save-connect-actions` 工具时收到保存错误，这可能是由于未迭代版本号。确保首先使用 `get-connect-action` 检索操作集的最新版本，以便正确迭代版本号
- `get-user-info-in-delegation` 接受原始 LDAP 筛选器输入。在某些情况下，如果未返回结果，可能是由于 LDAP 筛选器格式不正确。
## 获取帮助
在 https://github.com/Jamf-Concepts/mcp-rapidid/issues 上创建一个问题
