GeckoFlag 的 Claude 集成功能通过在 Claude 桌面应用中添加扩展程序,让您可以通过与 Claude 对话来操作 GeckoFlag。只要用日常语言提出请求,例如“列出由我负责、本周到期的事项”“把今天的会议记录追加到 Wiki”,Claude 就会选择所需的操作,对事项、项目、Wiki 和笔记进行搜索、查看、创建和更新。还可以将甘特图导出为 Excel。
与“用 AI 创建”的区别
GeckoFlag 已经提供了使用 AI 的“用 AI 创建”功能。“用 AI 创建”是在 GeckoFlag 页面中生成录入建议的功能,而 Claude 集成是通过与 Claude 对话来操作 GeckoFlag 的功能。两者的设置相互独立。
| 用 AI 创建 | Claude 集成 | |
|---|---|---|
| 使用位置 | GeckoFlag 的各个录入页面 | Claude 桌面应用中的对话 |
| 功能 | 生成事项、评论、项目和 Wiki 的录入建议(由人来保存) | 搜索、查看、创建和更新事项、项目、Wiki 和笔记,将甘特图导出为 Excel 等 |
| 所需条件 | Anthropic 的 API 密钥(由管理员在设置页面注册) | Claude 桌面应用,以及每位用户各自的 API 令牌 |
| 费用 | 按 API 使用量计费(支付给 Anthropic) | GeckoFlag 不收取额外费用(需要 Claude 的订阅计划) |
| 支持版本 | v1.9.0 及以上 | v1.11.0 及以上 |
Claude 集成可以做什么
Claude 会根据对话内容,自动选用合适的 GeckoFlag 操作。只有在管理员和用户双方都允许写入时,才能进行创建和更改。
- 搜索和查看事项 ― 按项目、状态、负责人、报告人、优先级、关键词、截止日期和父事项筛选搜索,并读取详情和评论。
- 创建和更新事项 ― 可以创建事项(也可指定父事项和通知对象)、更改字段、发表评论和更改状态。还可以在发表评论的同时更改负责人、优先级和日期。
- 项目 ― 可以查看列表和详情、新建项目、更改名称、说明、所有者和期间、切换已完成/未完成,以及添加和移除成员(移除前一定会先确认)。
- Wiki ― 可以读取项目的 Wiki、改写正文,或在末尾追加内容。
- 笔记 ― 可以列出、搜索、查看、创建、改写和追加自己的笔记。
- 主数据设置(管理员) ― 可以添加事项类型、状态、优先级、职务(部门),并更改其名称和颜色。
- 将甘特图导出为 Excel ― 将项目的事项生成为甘特图格式的 Excel 文件,并保存到电脑中。
- 用编号指定事项 ― 可以用“WEB-12”这样的事项编号来指定事项。Claude 在回复中会同时给出事项编号和页面 URL。
- 保留格式 ― 读写说明、评论、Wiki 和笔记时,会保留标题、项目符号、表格、链接、粗体等格式。
- 使用您的语言 ― Claude 会用用户提问时使用的语言回复。
请求示例
无需记住任何特殊命令。只要用日常语言提出请求,Claude 就会选择并执行所需的操作。
| 想做的事 | 请求示例 |
|---|---|
| 查找事项 | “列出由我负责、本周到期的事项” |
| 创建事项 | “在 WEB 项目中创建一个名为‘修复联系表单’的事项” |
| 记录处理情况 | “在 WEB-3 中评论处理内容,并把状态改为已完成” |
| 创建项目 | “创建一个项目,标识为 SAMPL,名称为‘示例项目’” |
| 添加成员 | “把张伟添加到 SAMPL” |
| 记录到 Wiki | “把今天的会议记录追加到 SAMPL 的 Wiki” |
| 调整设置 | “添加一个紫色的状态‘待审核’” |
| 甘特图 | “把 WEB 项目的甘特图导出为 Excel” |
| 汇总整理 | “写一份 SAMPL 的本周报告”“把 Wiki 中的待办事项创建为事项” |
将甘特图导出为 Excel
只需说“把甘特图导出为 Excel”,就会把项目的事项(最多 5,000 个)生成为甘特图格式的 Excel 文件,并保存到电脑中。
- 父子关系一目了然 ― 每个事项占一行,子事项缩进排列在父事项的正下方。右侧是时间线。
- 支持较长期间 ― 可以指定期间和按日/按周的单位。期间超过 120 天时,会自动切换为每列 1 周(最长约 5 年)。
- 可在 Excel 中调整 ― 修改开始日期或结束日期后,横条也会随之移动(不会反映到 GeckoFlag 中)。
- 未填写日期的事项也会显示 ― 以创建日期等代替,并以灰色斜体显示,同时注明原因。
- 支持 15 种语言 ― 标题等文字会以 GeckoFlag 用户设置中的语言导出(阿拉伯语为从右到左的工作表)。
- 不会覆盖 ― 如果已有同名文件,会加上编号另存为新文件。
使用所需条件
- GeckoFlag v1.11.0 及以上 ― Claude 集成已在 v1.11.0 中新增。如果您使用的是更早的版本,请先进行更新。
- Claude 桌面应用(Windows、macOS) ― 添加 GeckoFlag 的扩展程序(.mcpb 文件)后使用。扩展程序文件包含在购买 GeckoFlag 后可下载的文件中。扩展程序运行所需的 Node.js 已包含在应用中,无需另行安装。
- Claude 的订阅计划 ― GeckoFlag 不收取额外费用。使用 Claude 需要 Anthropic 的 Claude 订阅计划。
- 通过 HTTPS 访问的 GeckoFlag ― 扩展程序连接 GeckoFlag 时需要使用 HTTPS。
引入流程
- 管理员在 GeckoFlag 的“设置 → Claude 集成”中启用该功能,并根据需要允许写入。
- 管理员为每位使用者开启“允许使用 Claude 集成(API)”。
- 用户在个人资料页面中创建 API 令牌。
- 用户在 Claude 桌面应用中安装扩展程序,并输入 GeckoFlag 的 URL 和 API 令牌。
- 对 Claude 说“确认一下是否已连接到 GeckoFlag”,即可完成准备。
权限与安全
- 三项授权齐备时才能使用 ― 只有在“管理员启用功能”“按用户授予使用权限”“用户的 API 令牌”三项齐备时才能使用。功能未启用时,API 本身处于不存在的状态。
- 权限与页面操作相同 ― 所有操作都以 API 令牌所有者的权限执行。在 GeckoFlag 页面中看不到或无法执行的操作,通过 Claude 同样无法进行。没有权限的项目和事项会被视为“不存在”。
- 写入需要双重授权 ― 创建和更改需要同时具备站点的“允许写入”和令牌的“读写”权限。也可以仅以只读方式使用。
- 无法通过 Claude 删除 ― 无法通过 Claude 删除项目、事项、评论、Wiki、笔记等。如果请求删除,Claude 会引导您在 GeckoFlag 页面中操作。
- 安全的令牌管理 ― API 令牌是无法推测的随机字符串,服务器上只保存其哈希值。令牌仅在创建后显示一次,创建时本人会收到通知邮件。更改密码后,该用户的所有令牌都将失效。
- 频率限制与访问限制 ― 每个令牌每分钟最多 60 次请求;连续使用错误令牌的来源会被暂时封禁。GeckoFlag 基于 IP 地址的访问限制同样适用于 API。
- 每次写入前都可确认 ― 在 Claude 的设置中将 GeckoFlag 的写入操作设为“每次确认”后,执行前一定会请求您确认(推荐设置)。
数据处理
- 扩展程序在您的电脑上运行 ― 扩展程序只与您的 GeckoFlag 直接通信,不经过 GeckoFlag 开发方或第三方的服务器。
- Claude 读取的内容会发送给 Anthropic ― Claude 读取的事项、Wiki、笔记等内容,会作为对话的一部分发送给 Anthropic(Claude)。我们已指示 Claude 仅在用户请求时才读取笔记。
- 不执行内容中写入的指令 ― 我们已指示 Claude 将事项等中的文字视为“数据”,不执行其中写入的指令。
- 操作记录 ― 通过 Claude 进行的操作,会记录为 API 令牌所有者的操作(不会显示“通过 Claude”)。
- 引入前请确认 ― 引入前,请确认公司内部规定或与客户的合同中是否限制向外部服务发送信息。
无法执行的操作与使用注意事项
- 无法删除(项目、事项、评论、主数据、Wiki、笔记)、编辑评论,也无法附加或查看图片和文件。
- 无法添加或编辑用户、更改站点设置、操作 Kanban 看板、书签和通知设置,也无法查看其他人的笔记(管理员也不行)。
- 每次只写入 1 条。一次请求多个事项时,Claude 会逐个依次执行。
- 通过评论更改状态等时,会像在页面中操作一样留下历史记录,并发送通知邮件。
- 扩展程序在电脑上运行,因此只能在运行着 Claude 桌面应用的电脑上使用。
- AI 的回复可能有误。创建或更改的内容,也请在 GeckoFlag 页面中确认。