Waper 提供 MCP(Model Context Protocol)服务,走 Streamable HTTP。你的 Agent 客户端可以通过它读简报、查资料库、写文档、创建跟踪、把音视频转成逐字稿,也能直接问你自己的 Waper Agent。
最省事的办法:打开 Waper → 设置 → API 与 MCP,先 创建密钥,再在「接入应用」里选你用的客户端,复制现成的配置或命令——刚创建的密钥会自动填进去。
API Key 以 wpr_ 开头,创建方法见 API Key。下面的 wpr_xxx 换成你的密钥。
在终端里运行:
把下面这段加进 ~/.cursor/mcp.json(没有就新建),然后重启 Cursor:
设置里的 添加到 VS Code 按钮可以一键添加;也可以在终端里运行:
waper,URL 填 https://waper.ai/mcp;authorization,值填 Bearer wpr_xxx(要带上 Bearer 和空格)。Request headers 还在逐步开放,看不到这一栏时先用 Claude Code 或其他客户端。
把下面这段加进 ~/.codex/config.toml:
ChatGPT 只能连接支持在 ChatGPT 里登录授权(OAuth)的服务,不能带 API Key。Waper 还不支持这种登录授权,正在做;在那之前可以先用上面的客户端。
支持 Streamable HTTP 的客户端都可以:填上面的端点,请求头 Authorization 带上密钥。服务是无状态的,只接受 POST,直接返回 JSON;握手 initialize 返回服务器信息与使用说明,工具清单用 tools/list 取。
工具的形状和你自己的 Waper Agent 在对话里的一样:搜和读各一个工具,其余都在应用 waper 里,先取说明、再调一次执行。这些操作就是你的 Agent 用的那些,只定义一次:参数、审批规则、工作记录和撤销都一样。结果是 JSON(同时放在 structuredContent 里)。
search、read:搜索你自己的东西——文档、资料库、简报条目、音视频的逐字稿(in 选其中几种,不填就都搜)——并按类型和 ID 读一条(文档的 Markdown、网页与文件存下的正文、简报条目和它引用的文章、逐字稿);app_tools:Waper 的说明。{"app":"waper"} 列出各个模块和里面的操作;加上 "module":"watches" 给这个模块的说明与每个操作的参数,加上 "tool" 给一个操作的完整参数;app_run:执行一个操作,例如 {"app":"waper","tool":"create_doc","args":{"title":"计划","markdown":"# 计划"}}。参数不对时会连同完整的参数说明一起返回;ask_agent、read_conversation:给你的主 Agent(Kiki)发一轮消息、读这次调用的对话:它可以把要花时间的事放到后台自己做,不会去找你别的 Agent,也碰不到你自己的对话(它知道你的跟踪、资料、文档和记忆,也能用你连接的应用);带上 watchId 问某一个跟踪,带上 skill(list_skills 里的 slug)时这一轮 Agent 按这个技能做。ask_agent 会等一会儿:这句话引出的事都有了结论、它说完了,拿到的就是最终回答;没等到时返回对话 ID,之后用 read_conversation 查,它说完之前一直是还在答。事停在等你批准时,它说明在等什么就算答完,你批准之后结论在这个对话里另起一条。API Key 能用的模块(以 app_tools 给出的为准):
space)与文档——list_spaces、list_docs、create_doc、edit_doc(写之前先读资源 waper://spec/markdown),以及 start_research:在后台做深度研究,写成一篇带出处的文档;另有知识库、文件夹与文档的新建、改名、删除,移动文档、以前的版本、关联跟踪。删掉的文档和知识库进回收站留 30 天,list_trash、restore_trash_item 能找回来;image_generate 按一句描述画一张图;要改一张图时把它放进 images(资料库里的文件 fil_…,或之前生图返回的任务 ID tsk_…,目前一次一张),说要改什么,其余不动。在后台做(约半分钟),返回任务 ID,用 get_task 看,做好时产出里的 fileId 就是那张图,也进资料库;可选 aspectRatio:1:1、3:2、2:3、16:9、9:16(例如手机壁纸选 9:16、头像选 1:1);不传时生成是方图、改图取最接近原图的受支持比例。quality 默认 standard,仅明确需要高质量时用 high;回退服务可能使用默认质量,每张价格不变,清晰度由服务默认决定;save_link 把网页收进资料库;transcribe_media 在后台把音视频转成逐字稿(和听记里的是同一份,过几分钟用 read 读);update_library_item、retry_library_item、delete_library_item 改备注或归属、重新读取网页或没读到的文件、把一条资料放进回收站;search_watches、list_watches、latest_brief、get_knowledge 找跟踪(公开的和你自己的)、读最新一期简报、读跟踪的知识库(周报、时间线、实体);create_watch 新建跟踪(计入每月额度;第一期简报在后台写);update_watch 改你建的跟踪的范围、名字、公开范围与地址(改范围或地址按用量扣积分,马上按新范围写一期)。凡是参数里有 watchId 的,填跟踪的 ID 或 slug 都可以;list_skills、read_skill——你的技能(Waper 自带的,包括你关掉的,以及你自己的),和某个技能的说明与参考文件;另有隐藏或显示技能、删掉你自己的技能;list_tasks、cancel_task、retry_task 看、停、重试后台的活;check_action——查一个等你批准的动作你是怎么决定的。你连接的应用(Gmail、Notion……)不能经 MCP 直接用:外部 Agent 用 ask_agent 交给你的 Agent,它能用。
外部 Agent 通过 MCP 做的事,和你自己的 Agent 遵守同一套规则:
{"status":"blocked_by_review",…},什么都没做(你可以在设置的「规矩」里「最近拦下」把它改为批准并重试一次);{"status":"waiting_for_user_approval","actionId":"…"}。这时什么都还没发生;ask_agent 引出的都一样);API Key 不能批准、不能设「始终允许」或可信收件人,也不能撤销。你会照常收到通知;app_run 用 actionId 调 check_action:executed 表示你批准了并且已经做完;ask_agent 按实际模型成本扣积分(它放到后台做的事、做完回来说结论的那一轮都算),transcribe_media 按时长扣积分,start_research 按篇扣积分,image_generate 按张扣积分,生成与改图各按各的价(出了图才扣),create_watch 计入每月创建跟踪的额度;RATE_LIMITED 开头的说明,等一分钟再调。工具只操作你自己的数据。