领取凭证
向管理员获取服务地址、个人 Token、授权主题及有效期。
KNOWLEDGE ACCESS / MCP
把企企通 SRM 知识，
接入你的 AI。
通过受控 MCP 服务查询企企通 SRM 文档与补充卡片。
获取个人 Token，配置客户端，即可按授权主题使用。
Streamable HTTP · 与说明页共用端口
https://你的服务域名/mcp说明页与 MCP 由同一服务同时启动、共用同一端口。浏览器打开根路径 / 查看说明，AI 客户端连接 /mcp 并携带 Token。
配置客户端
添加远程 MCP 地址，在请求头中设置 Bearer Token。
开始查询
连接后查看两个知识工具，先搜索，再按卡片 ID 读取。
01 / CONFIGURATION
配置你的 AI 客户端
客户端需支持 Streamable HTTP 和自定义请求头。以下为通用配置结构，具体字段与配置位置以客户端为准。
mcpServers · JSON 示例
{
"mcpServers": {
"qiqitong-srm": {
"url": "https://你的服务域名/mcp",
"headers": {
"Authorization": "Bearer <替换为管理员发放的Token>"
}
}
}
}将 Token 占位符完整替换，保留 Bearer 后的一个空格。保存后重新连接 MCP 服务。部署在标准根路径时，页面会自动使用当前域名生成地址；请以管理员提供的地址为准。
先确认连接方式
服务使用静态 Bearer Token，不提供 OAuth 登录、自动发现或自动刷新。仅支持 OAuth 授权流程的客户端，不能直接使用这份配置。
使用 WorkBuddy？
在 WorkBuddy 的「连接器」中添加本服务（MCP · streamableHttp），地址填本页顶部的 MCP 地址，Token 填管理员发放的个人 Token；也可由管理员将仓库中 connector/workbuddy/ 连接器包提交上架后在连接器市场安装。连接成功后，开发企企通 SRM 项目时 AI 会主动检索本知识库。
02 / AUTHENTICATION
每次请求，都验证身份
Token 决定你是谁；管理员分配的主题权限决定你能查询哪些知识。
请求头鉴权
Authorization: Bearer <你的Token>- 每次调用都需携带有效 Token。
- Token 过期或被撤销后，请向管理员申请新凭证。
- 同一人员的多个 Token 共享使用配额。
- 不要把 Token 放进 URL、共享仓库或公开对话。
权限与知识范围
- 仅能查询授权主题内的 Git 文档片段和补充卡片。
- 不知道 ID 时，先使用搜索工具定位卡片。
- 已删除或无权访问的文档片段不会返回正文。
- 说明页公开可读；知识接口始终需要鉴权。
本页不收集 Token，也不在浏览器中执行知识查询。
用 curl 验证连接
在本机 Bash 终端执行。输入 Token 时不回显，也不直接写入命令历史。成功响应包含 result.serverInfo；此验证会占用一次请求额度。
Bash · initialize
read -rsp 'Token: ' KB_TOKEN; echo
printf 'header = "Authorization: Bearer %s"\n' "$KB_TOKEN" |
curl --config - 'https://你的服务域名/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"connection-check","version":"1.0"}}}'
unset KB_TOKEN03 / TOOLS
先搜索，再阅读
search_knowledge
输入具体关键词，查找相关文档片段或补充卡片。
{"query": "采购 审批"}2–80 个字符；多个关键词需同时命中。最多返回 3 条固定摘要，每条不超过 240 字符，无分页。
read_knowledge
使用搜索结果中的 ID，读取一段文档或补充卡片。
{"card_id": "搜索返回的卡片ID"}文档每段最多 1400 字符，补充卡片最多 1600 字符。不支持文件路径、批量 ID、任意偏移或原始文档下载。
可对 AI 说：“请使用 qiqitong-srm 搜索采购审批规则，再读取相关卡片，并说明哪些信息需要补充确认。”
04 / USAGE POLICY
按需查询，合理使用
以下是默认配额，管理员可按人员调整；此页不显示个人实时余额。
| 限制项 | 默认上限 | 计算方式 |
|---|---|---|
| 请求频率 | 20 次 / 分钟 | 固定分钟窗口，包含初始化和工具列表 |
| 每日请求 | 100 次 | 同一人员所有 Token 合计 |
| 每日输出 | 12,000 字符 | 摘要、重复读取和结果字段均计入 |
| 累计输出 | 100,000 字符 | 不随日期或 Token 轮换重置 |
| 每日不同来源 | 20 份 | 包括搜索命中的文档，同一文档的多段计为一份 |
每日额度在北京时间 08:00（UTC 00:00）重置。重启服务或重新领取 Token 不会清空用量。禁止 JSON-RPC 批量请求，请求体最大 8 KiB。
05 / TROUBLESHOOTING
遇到问题，从这里排查
401 · invalid_token
检查 Authorization 请求头、Bearer 后的空格以及 Token 是否完整。Token 可能已过期或被撤销，请联系管理员。不要把 Token 发到公开问题反馈中。
403 或 card_unavailable · 请求或卡片不可用
HTTP 403 通常表示请求带有查询字符串或 Origin。请通过 MCP 客户端调用，不要在浏览器里直接请求接口。工具返回 card_unavailable 表示文档片段不存在、已更新、已删除或不在授权主题中。
429 或 quota_exceeded · 配额已用尽
HTTP 429 表示请求次数超限；工具返回 isError 和 quota_exceeded 表示输出量或不同卡片数达到上限。分钟额度稍后恢复，日额度需等下次重置，累计额度需联系管理员调整。Retry-After: 60 不代表所有额度会在 60 秒后恢复。
400 / 405 / 413 / 421 · 请求格式或地址问题
400：检查 JSON 格式，不要发送批量数组。405：/mcp 使用 POST，不能在地址栏直接打开。413：请求体超过 8 KiB。421：域名不在服务器允许列表，联系管理员检查 Host 和代理配置。
连接成功，但搜索没有结果
换用更具体、较短的关键词，并确认管理员已挂载知识目录且授予相应主题权限。Git 更新后的 Markdown 会在后续查询中自动加载；服务和隐藏目录不参与查询。