笔记本对外是一个标准 MCP 服务器（Streamable HTTP 协议）。你的 MCP Hub 已经支持
streamable_http + 自定义请求头，所以不需要 Worker、不需要本地常驻进程、不需要新增部署单元
—— 下面这份配置贴进 Hub 就能用。
API_TOKEN 存在服务器项目根目录的 .secrets.local 文件里，找 API_TOKEN= 那一行，
等号后面的整串就是。
编辑 Hub 的 MCP 配置（或直接在 /mcp 管理页粘贴 JSON，走「AI 自动新增 + 人工审批」流程）：
{
"mcpServers": {
"biji-notes": {
"type": "streamable_http",
"url": "https://zhangchong-biji-web.pages.dev/api/mcp/rpc",
"headers": {
"Authorization": "Bearer <API_TOKEN>"
}
}
}
}
把 <API_TOKEN> 换成第 1 步拿到的值（Bearer 后面有一个空格）。
| 工具 | 参数 | 说明 |
|---|---|---|
search_notes |
query（必填，关键词）limit（可选，默认 10） |
全文检索：三个字以上走 FTS5 全文索引 + 相关度排序，两个字自动降级模糊匹配。返回标题、标签、时间、地点和完整正文。 |
add_note |
content（必填）title / tags（可选） |
记一条笔记。标题和标签不填会自动识别生成，来源标记为「小智」。写入的笔记在搜索台里能看到。 |
故意不提供编辑和删除 —— Agent 只能查和记，破坏性操作必须由你在网页里亲自做。
配置生效后，直接对小智说：
「帮我查一下笔记里关于 显卡散热 的内容」 「把这段记到笔记本里：服务器重启流程是先停服务再启动」
也可以用 curl 手工验证端点（把 $API_TOKEN 换成真实值）：
curl -H "Authorization: Bearer $API_TOKEN" \
"https://zhangchong-biji-web.pages.dev/api/mcp/search?query=显卡"
curl -X POST -H "Authorization: Bearer $API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content":"小智记录：这条来自 REST 测试"}' \
"https://zhangchong-biji-web.pages.dev/api/mcp/add_note"
一直 401？ 九成是 Bearer 后面填成了网页访问口令。API_TOKEN 在 .secrets.local 的
API_TOKEN= 行，两者是不同的密钥。
搜索两字词搜不到？ 正常。三个字以上走全文索引，两个字自动降级模糊匹配，返回里会有
mode 字段标明走的是哪条路径。
想屏蔽账号密码类笔记的正文？ 默认返回正文（Agent 才能回答问题）。需要收紧时把环境变量
MCP_MASK_SENSITIVE 设为 1 重新部署，敏感笔记就只给标题和标签。
协议细节？ 端点实现了 initialize / tools/list / tools/call /
ping，协议版本协商 2025-06-18（默认）/ 2025-03-26 / 2024-11-05，无状态模式，无 SSE 推送流。