用途
Laver MCP 服务器为 AI 智能体提供在 Laver（laver.app）中读取和操作看板、工单与工作区 Wiki 的工具。它连接的是与网页应用相同的公开 REST API，每个工具都是对 API 的薄调用，服务器本身没有本地状态、没有缓存，也不存在第二套实现。
主要能力
工单与看板
list_workspace_tickets是站会式读取：无需board_uuid，可回答“什么逾期了”和“什么没人负责”，默认一页 50 条、最多 200 条，无游标。get_ticket_flow从工单历史中的移动记录推导数据；gaps会指出历史与当前列不一致的情况。- 可通过
list_tickets传入上次返回的server_time作为updated_since来跟踪看板变化。 - 看板结构工具包括
get_board（可传include_tasks: false缩小返回）与两个重排工具，重排需要完整列表。 - 标签是工作区级共享对象，重命名会影响所有看板；其返回的 uuid 可作为
update_ticket的label_uuids。
评论、附件与子任务
- 评论写入不受版本控制，后写覆盖先写；只有作者可编辑或删除，他人的评论表现为与不存在相同的 404。
mark_comments_read是唯一标记已读的调用，标记到当时存在的最新评论。- 附件方面，
get_ticket报告attachment_total；二进制内容不穿越工具边界，只有文本、CSV 和小于 4 MB 的图片内联返回，其余需要save_to写入运行服务器的机器路径；上传通过file_path从该机器读取。图片以 MCP 图像块返回。
Wiki
- 工具集包括
list_wikis、search_wiki、get_wiki_tree、get_wiki_page、get_wiki_page_version、append_wiki_page、update_wiki_page、create_wiki_page和restore_wiki。 - 归档 Wiki 后其及所有子页面会从
list_wikis消失，传archived: true可查看；restore_wiki可一次取消归档整个 Wiki。 append_wiki_page追加到页面末尾，不取版本，两个智能体同时追加都可保留文本；update_wiki_page替换页面内容，需从get_wiki_page获取版本，若期间他人写入则返回 409 及当前版本。- 无删除页面的工具。
自动化规则
- 规则由触发器、可选条件和最多二十个动作组成并存储在看板上。
- 通过工具创建的规则立即生效；规则是一种长期授权，以密钥对应用户的身份运行，撤销密钥不会停止规则，禁用或删除规则才会。
update_automation传enabled: false可立即停止异常规则并保留历史，删除则连历史一并销毁。
公开链接
list_published_links列出工作区当前公开在互联网上的内容，包括分享令牌、发布者、时间及访问人数。仅工作区所有者或管理员可用，普通成员返回 403。没有下线链接的工具。
使用方式
在 Laver 的 Admin → API keys 中创建以工作区为范围的 API 密钥。密钥以创建者的身份行事，能力不超过创建者，且可吊销而不影响其账户。环境变量 LAVER_API_URL 可覆盖 API 主机，默认 https://api.laver.app；LAVER_API_KEY_FILE 是 LAVER_API_KEY 的替代，指向仅含密钥的文件或含 LAVER_API_KEY=… 行的 .env 风格文件。LAVER_API_URL 必须为 https（localhost 除外）。仓库根目录的 .mcp.json 已注册该服务器，从 gitignored 的 .env 读取密钥。它运行已发布的包 npx -y @laver/mcp。编辑时若指向工作副本，提交前需改回。客户端仅在启动时连接 MCP 服务器，运行中执行 claude mcp add 不会回溯注入工具，需新开会话或重连。
适用场景
适用于希望让 AI 智能体参与 Laver 项目管理流程的团队，例如读取站会所需工单、按看板跟踪变更、阅读与追加团队 Wiki、查看公开链接清单等。
限制
- 尚未提供：通知（受后端插件
session_only限制，密钥访问返回 401）、单独列出子任务、看板模板、附件缩略图、最近位置、看板分析、看板关联的 Wiki 页、指挥计分板、手动触发自动化按钮、工单历史与复制/循环、Sprint（与通知受阻于同一处）。 - 评论不受版本控制，后写覆盖先写。
- 附件只有文本、CSV 和小于 4 MB 的图片内联，其余需写入文件路径。
- 无删除 Wiki 页面、无下线公开链接、无恢复 Wiki 历史版本的工具。