网络钩子、SCIM 与配对
本页涵盖其余的协议表面： 设备配对，企业 认证联盟 (SAML / SCIM / OAuth)，选择加入 MCP 服务器 和 A2A 端点, 媒体 转移，以及 连接-RPC 服务。其中有几个默认是关闭的，必须明确启用。
设备配对
移动端和桌面端客户端通过简短的配对交换加入实例（iOS/macOS 应用程序仅使用二维码配对）。
| 方法与路径 | 目的 |
|---|---|
POST /v1/pairing/redeem |
兑换配对码并配置设备 |
POST /v1/pairing/device/validate |
验证已配对的设备 |
curl https://your-aihummer.example/v1/pairing/redeem \
-H "Content-Type: application/json" \
-d '{ "code": "ABCD-EFGH" }'身份认证联合
AiHummer 与企业身份提供者集成，用于登录和用户配置。
安全断言标记语言
| 方法与路径 | 目的 |
|---|---|
GET /saml/metadata |
您的身份提供者的服务提供商元数据 |
POST /saml/acs |
断言消费者服务（SAML 响应） |
GET /saml/login |
启动 SAML 登录 |
SCIM 配置
跨域身份管理系统（SCIM 2.0）让您的身份提供者自动创建和管理用户。
| 方法与路径 | 目的 |
|---|---|
.../scim/v2/Users |
列出 / 创建用户 |
.../scim/v2/Users/{id} |
读取 / 更新 / 删除用户 |
SCIM端点通过一个方式进行身份验证 每租户 SCIM 承载令牌，签发（并轮换/撤销）于 POST /v1/admin/scim/token; 身份提供者在一个中发送它 Authorization: Bearer 标题。令牌在发行时显示一次。
OAuth 令牌
| 方法与路径 | 目的 |
|---|---|
POST /v1/oauth/token |
OAuth 令牌端点 |
MCP 服务器（向外发布）
AiHummer 可以通过充当一个向 MCP 客户端发布其自身工具的角色 MCP 服务器. 这是 选择加入 并且禁用，除非你设置 AIHUMMER_MCP_PUBLISH=1.
| 方法与路径 | 目的 |
|---|---|
POST /v1/mcp |
MCP 服务器端点（需要 AIHUMMER_MCP_PUBLISH=1) |
[!WARNING] 仅有
AIHUMMER_MCP_PUBLISH=1是不够的。 它只是开放了地址，导出清单仍为 空：tools/list返回空数组，任何调用都会被拒绝。请在AIHUMMER_MCP_EXPORT_TOOLS中用逗号分隔的精确名称列出所需工具——不支持 通配符，也不支持*。对外只允许发布只读工具：http_request、web_fetch、browser、code_exec和filesystem_read永远不会被导出， 即使你把它们写进去。这两项设置要在 管理 → 设置 中或用
aihummer settings set命令设置，而不是 写进gateway.env——对这些键，环境变量会被忽略。AIHUMMER_MCP_PUBLISH只 接受1：写true或on会让地址保持关闭。修改在网关重启后生效。客户端必须在
Authorization: Bearer …头中提供带mcp权限范围的 API 密钥； 没有它则返回 401。
[!NOTE] 将发布工具向外部提供与作为 MCP 服务器的消费者是不同的 零代码集成。此端点用于让其他MCP客户端调用 人工智能悍马
A2A（代理到代理）
AiHummer 可以公开一个 A2A 表面，以便其他代理可以发现并与其通信。这也是 选择加入 通过 AIHUMMER_A2A_PUBLISH=1.
| 方法与路径 | 目的 |
|---|---|
GET /.well-known/agent.json |
A2A 代理卡 / 发现文档 |
POST /a2a/message |
接收 A2A 消息（需要 AIHUMMER_A2A_PUBLISH=1) |
媒体
大型媒体（音频、图像、文件）是通过专用端点上传和获取的，而不是嵌入在 JSON 正文中。
| 方法与路径 | 目的 |
|---|---|
PUT /v1/media/{id}/content |
上传媒体对象的字节 |
GET /v1/files/{id} |
下载已存储的文件 |
[!TIP] 设置
AIHUMMER_BLOB_DIR启用媒体/文件服务，并AIHUMMER_MEDIA_TOKEN_SECRET因此签名的下载 URL 在整个过程中保持有效 重启。
连接-RPC 服务
对于打字、流式客户端，AiHummer 也提供 连接-RPC 通过 HTTP 提供的服务（支持服务器流）:
| 服务 | 区域 |
|---|---|
aihummer.health.v1 |
健康检查 |
aihummer.event.v1 |
事件流 |
aihummer.conversation.v1 |
对话 |
aihummer.push.v1 |
推送交付 |
aihummer.media.v1 |
媒体传输 |
aihummer.turn.v1 |
转身执行 |