手册

Claude 集成功能通过在 Claude 桌面应用（Windows、macOS）中添加扩展程序，让您可以通过与 Claude 对话来操作 GeckoFlag。可以搜索、查看、创建和更新事项、项目、Wiki 和笔记，并将甘特图导出为 Excel。扩展程序在用户的电脑上运行，只与用户的 GeckoFlag 直接通信。所有操作都以 API 令牌所有者的用户权限执行。

管理员设置

1. 1打开侧边栏中的设置，点击Claude 集成卡片中的编辑。
2. 2开启启用 Claude 集成（默认禁用）。如果还要让 Claude 进行创建和更改，请同时开启允许写入并保存。不允许写入时，所有令牌都将变为只读。
3. 3在用户中打开目标用户的编辑，开启允许使用 Claude 集成（API），然后点击更新。这与“允许 AI 辅助登记”是不同的设置。取消授权后，该用户的所有 API 令牌都会被删除。

创建 API 令牌

1. 1打开侧边栏中的个人资料，在API 令牌栏中指定令牌名称、有效期（30 天、90 天、365 天或永不过期，默认为 90 天）和权限（只读或读写），然后创建令牌。
2. 2复制显示的令牌（以 gfk_ 开头的字符串）。令牌只会在创建后显示一次。同一栏中显示的“在扩展程序中输入的 URL”也请一并记下。

• 每人最多可创建 5 个令牌，不再使用的令牌可以随时在个人资料中删除。
• 创建令牌后，本人会收到通知邮件。更改密码后，该用户的所有令牌都会被删除。

在 Claude 桌面应用中设置

1. 1打开 Claude 桌面应用的Settings（设置）→Extensions（扩展程序），拖放 GeckoFlag 扩展程序文件（.mcpb），然后点击Install（安装）。也可以双击文件，或通过Advanced settings（高级设置）进行安装。扩展程序文件包含在购买 GeckoFlag 后可下载的文件中。
2. 2在设置页面中输入以下各项，然后点击Save（保存）。
   • GeckoFlag URL（必填）：之前记下的 URL。必须使用 https://（http:// 仅限 localhost、*.test 和 *.local）。
   • API token（必填）：复制的令牌。保存后以打码形式显示。
   • Export folder（可选）：甘特图 Excel 的保存位置。留空时保存到“下载”文件夹。
   
3. 3对 Claude 说“确认一下是否已连接到 GeckoFlag”。如果显示了令牌所有者、GeckoFlag 的版本以及能否写入，即表示设置完成。

附截图的详细步骤，请参阅Claude 集成的使用步骤。建议在 Claude 的扩展程序设置中将写入操作设为“每次确认”。

可以做什么

• 事项: 搜索（项目、状态、负责人、报告人、优先级、关键词、截止日期、父事项），查看详情和评论，创建（也可指定父事项和通知对象），更改字段，发表评论，更改状态。
• 项目: 查看列表和详情，创建（访客以外的用户），更改名称、说明、所有者和期间，切换已完成／未完成，添加和移除成员（所有者、管理员）。
• Wiki: 查看，改写标题和正文，在末尾追加内容（项目成员、管理员）。
• 笔记: 列出、搜索、查看、创建、改写和追加自己的笔记。
• 主数据: 添加事项类型、状态、优先级、职务（部门），并更改其名称和颜色（管理员）。
• 甘特图: 将项目的事项（最多 5,000 个）生成为 Excel 文件并保存到电脑中。期间超过 120 天时，每列为 1 周。
• 搜索用户: 按姓名查找用户（仅返回 ID 和角色，不返回电子邮件地址）。

可以用“WEB-12”这样的编号指定事项。写入需要同时具备“读写”令牌和站点的“允许写入”设置。