MCP 接入

Waper 提供 MCP(Model Context Protocol)服务,走 Streamable HTTP。你的 Agent 客户端可以通过它读简报、查资料库、写文档、创建跟踪、把音视频转成逐字稿,也能直接问你自己的 Waper Agent。

最省事的办法:打开 Waper → 设置 → API 与 MCP,先 创建密钥,再在「接入应用」里选你用的客户端,复制现成的配置或命令——刚创建的密钥会自动填进去。

端点

https://waper.ai/mcp Authorization: Bearer <你的 API Key>

API Key 以 wpr_ 开头,创建方法见 API Key。下面的 wpr_xxx 换成你的密钥。

各客户端配置

Claude Code

在终端里运行:

claude mcp add --transport http waper https://waper.ai/mcp --header "Authorization: Bearer wpr_xxx"

Cursor

把下面这段加进 ~/.cursor/mcp.json(没有就新建),然后重启 Cursor:

{
	"mcpServers": {
		"waper": {
			"url": "https://waper.ai/mcp",
			"headers": { "Authorization": "Bearer wpr_xxx" }
		}
	}
}

VS Code

设置里的 添加到 VS Code 按钮可以一键添加;也可以在终端里运行:

code --add-mcp '{"name":"waper","type":"http","url":"https://waper.ai/mcp","headers":{"Authorization":"Bearer wpr_xxx"}}'

Claude Desktop

  1. 打开 Customize → Connectors → + Add → Add custom connector;
  2. Name 填 waper,URL 填 https://waper.ai/mcp;
  3. Authentication 选 No sign-in;
  4. Request headers 选 authorization,值填 Bearer wpr_xxx(要带上 Bearer 和空格)。

Request headers 还在逐步开放,看不到这一栏时先用 Claude Code 或其他客户端。

Codex

把下面这段加进 ~/.codex/config.toml:

[mcp_servers.waper]
url = "https://waper.ai/mcp"
http_headers = { "Authorization" = "Bearer wpr_xxx" }

ChatGPT

ChatGPT 只能连接支持在 ChatGPT 里登录授权(OAuth)的服务,不能带 API Key。Waper 还不支持这种登录授权,正在做;在那之前可以先用上面的客户端。

其它 MCP 客户端

支持 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 给出的为准):

  • knowledge:知识库(参数里叫 space)与文档——list_spaces、list_docs、create_doc、edit_doc(写之前先读资源 waper://spec/markdown),以及 start_research:在后台做深度研究,写成一篇带出处的文档;另有知识库、文件夹与文档的新建、改名、删除,移动文档、以前的版本、关联跟踪。删掉的文档和知识库进回收站留 30 天,list_trash、restore_trash_item 能找回来;
  • images: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;回退服务可能使用默认质量,每张价格不变,清晰度由服务默认决定;
  • library:save_link 把网页收进资料库;transcribe_media 在后台把音视频转成逐字稿(和听记里的是同一份,过几分钟用 read 读);update_library_item、retry_library_item、delete_library_item 改备注或归属、重新读取网页或没读到的文件、把一条资料放进回收站;
  • watches:search_watches、list_watches、latest_brief、get_knowledge 找跟踪(公开的和你自己的)、读最新一期简报、读跟踪的知识库(周报、时间线、实体);create_watch 新建跟踪(计入每月额度;第一期简报在后台写);update_watch 改你建的跟踪的范围、名字、公开范围与地址(改范围或地址按用量扣积分,马上按新范围写一期)。凡是参数里有 watchId 的,填跟踪的 ID 或 slug 都可以;
  • skills:list_skills、read_skill——你的技能(Waper 自带的,包括你关掉的,以及你自己的),和某个技能的说明与参考文件;另有隐藏或显示技能、删掉你自己的技能;
  • routines:你的例行任务执行过的与接下来的几次(建与改例行任务在 Waper 里或交给你的 Agent);
  • settings:读和改你的设置(语言、时区、简报几点送到、收不收简报邮件),列出你能选的模型,找你的邀请链接;
  • tasks:list_tasks、cancel_task、retry_task 看、停、重试后台的活;check_action——查一个等你批准的动作你是怎么决定的。

你连接的应用(Gmail、Notion……)不能经 MCP 直接用:外部 Agent 用 ask_agent 交给你的 Agent,它能用。

审批与撤销

外部 Agent 通过 MCP 做的事,和你自己的 Agent 遵守同一套规则:

  • 经 MCP 来的调用没有你在场:读的、在 Waper 里能撤销的直接做,其余交给自动审核。审核放行就直接做;拦下时返回 {"status":"blocked_by_review",…},什么都没做(你可以在设置的「规矩」里「最近拦下」把它改为批准并重试一次);
  • 要你决定时(以你的名义发给别人、付款、删掉恢复不了的东西、单个动作预估超过 600 积分或超过剩下的积分、审核拿不准),工具不直接做,而是返回 {"status":"waiting_for_user_approval","actionId":"…"}。这时什么都还没发生;
  • 只有你本人能在 Waper 里批准,卡在 Kiki 的对话里(直接调工具的和 ask_agent 引出的都一样);API Key 不能批准、不能设「始终允许」或可信收件人,也不能撤销。你会照常收到通知;
  • Agent 之后可以经 app_run 用 actionId 调 check_action:executed 表示你批准了并且已经做完;
  • 通过 MCP 做的每件事都会出现在你的工作记录里,在通常的期限内可以撤销(文档与资料 7 天)。修改文档例外:每次修改都留在这篇文档的历史版本里,从那里恢复以前的版本。

计费与限制

  • ask_agent 按实际模型成本扣积分(它放到后台做的事、做完回来说结论的那一轮都算),transcribe_media 按时长扣积分,start_research 按篇扣积分,image_generate 按张扣积分,生成与改图各按各的价(出了图才扣),create_watch 计入每月创建跟踪的额度;
  • 速率见 API Key:每把 Key 每分钟最多发起 10 个花积分的动作,超出时工具返回一句以 RATE_LIMITED 开头的说明,等一分钟再调。工具只操作你自己的数据。