连接器指南阅读约 4 分钟33 个 MCP 工具7 种语言

将 YouGile MCP 连接到 Gemini CLI

YouGile 项目管理:项目、看板、列、带截止日期的任务、检查清单和指派人、任务聊天消息、员工、部门、自定义和冲刺贴纸以及 webhook 订阅。API 密钥。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

无需信用卡 · 7 天试用 · 提供自托管方案

YouGile

YouGile

YouGile project management: projects, kanban boards, columns, tasks with deadlines, checklists and assignees, task chat messages, employees, departments, custom and sprint stickers and webhook subscriptions. API key.

个工具

33

区域

INTL

类别

项目管理

身份验证

Bearer Token

所需环境变量

YOUGILE_API_KEY
在 Cloud 上一键安装

7 天免费试用 · 无需信用卡

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

YouGile 项目管理:项目、看板、列、带截止日期的任务、检查清单和指派人、任务聊天消息、员工、部门、自定义和冲刺贴纸以及 webhook 订阅。API 密钥。

引导式设置

2 分钟将 YouGile 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 YouGile,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

无需信用卡 · 7 天试用 · 提供自托管方案

试试这样问

YouGile 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

YouGile · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

💡 没有安装?直接使用 cloud.anythingmcp.com。 登录,点击 Connectors → YouGile,粘贴你的凭据,生成一个 MCP API 密钥,完成。无需 Docker,无需 git clone,无需本地服务器。

YouGile + Gemini

YouGile 项目管理:项目、看板、列、带截止日期的任务、检查清单和指派人、任务聊天消息、员工、部门、自定义和冲刺贴纸以及 webhook 订阅。API 密钥。

前提条件

请查看连接器中包含的完整设置说明(在选择连接器时可在应用内商店中查看)。此连接器所需的环境变量为:

YOUGILE_API_KEY

第一步 — 获取凭据

设置大约需要 5 分钟。

YouGile 没有显示 API 密钥的页面:密钥是通过一次 API 调用创建的,该调用需要你的 YouGile 登录和密码。从终端运行一次;连接器本身不会看到你的密码。

  1. 找到你的公司 ID:在 YouGile 网络应用中按 Ctrl+Alt+Q(在 Mac 上为 Ctrl+Option+Q),或运行 curl -X POST https://yougile.com/api-v2/auth/companies -H "Content-Type: application/json" -d '{"login":"<your email>","password":"<your password>"}' 并获取 content[].id 的公司 ID。
  2. 创建密钥:curl -X POST https://yougile.com/api-v2/auth/keys -H "Content-Type: application/json" -d '{"login":"<your email>","password":"<your password>","companyId":"<company id>"}'。返回结果为 {"key":"..."}。
  3. 将密钥粘贴到 YOUGILE_API_KEY 中。

密钥不会过期。一个账户最多可以持有 30 个密钥;使用 POST /auth/keys/get 列出它们(相同的登录主体),并使用 DELETE /auth/keys/<key> 删除一个。密钥的权限与创建它的员工相同,只能看到该员工能看到的内容,因此请使用可以打开你想要工作的项目的账户创建它。

从哪里开始:yougile_get_current_user 检查密钥。然后逐步进行:yougile_list_projects,yougile_list_boards(带项目 ID),yougile_list_columns(带看板 ID),yougile_list_tasks(带列 ID)。

结构:yougile_get_project,yougile_get_board,yougile_get_column;使用 yougile_create_project,yougile_create_board,yougile_create_column 创建;使用 yougile_update_project,yougile_update_board,yougile_update_column 修改。任务属于列,列属于看板,看板属于项目。

任务:yougile_list_tasks(按列、指派人、标题或贴纸状态过滤),yougile_get_task,yougile_create_task,yougile_update_task,以及 yougile_move_task 来更改列。yougile_delete_task 默认关闭;使用 yougile_update_task 设置 archived 来标记已完成的工作。

聊天:每个任务都有一个聊天,其 ID 为任务 ID。使用 yougile_list_task_messages 读取聊天,使用 yougile_send_task_message 发送消息。yougile_list_group_chats 列出公司聊天,使用相同的两个工具。

人员:yougile_list_users,yougile_get_user,yougile_list_departments,yougile_get_department。

贴纸:任务的自定义字段是贴纸。yougile_list_string_stickers 和 yougile_get_string_sticker 返回具有固定状态集(优先级、类型)的贴纸;yougile_list_sprint_stickers 和 yougile_get_sprint_sticker 返回冲刺。使用 yougile_create_string_sticker 和 yougile_create_sprint_sticker 创建它们,使用 yougile_update_board 在看板上启用它们,然后将其作为贴纸 ID 设置为状态 ID。

Webhook:yougile_list_webhooks 显示订阅及其失败计数器。

列表和分页:列表工具返回 paging(计数、限制、偏移量、下一个)和 content。默认页面大小为 50,最多 1000;当 paging.next 为真时,使用增加 limit 的 offset 再次调用。删除的对象将被排除,除非 include_deleted 为真。

时间:任务和消息时间为自 1970 年以来的毫秒数(timestamp,deadline.deadline,消息 id);冲刺 begin 和 end 为秒。ID 为 UUID;贴纸状态 ID 为短十六进制字符串。

速率限制:整个公司每分钟 50 个请求,所有密钥共享。使用较大的 limit 进行分页,而不是多个小调用。

错误:失败的调用状态为 4xx 或 5xx,并具有 error 或 message 字段。401 表示密钥错误或已删除;403 或 404 表示对象存在但密钥所有者无权访问。

第二步 — 安装适配器

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

第三步 — 在 Gemini 中添加连接器

你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json(Windows 上为 %USERPROFILE%\.gemini\settings.json)读取 MCP 服务器。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换 YOUR_MCP_API_KEY。
  2. 保存文件并重启 gemini。
  3. 在 Gemini CLI 中运行 /mcp(或在终端运行 gemini mcp list)— anythingmcp 应显示为已连接。
  4. 开始输入提示 — Gemini CLI 现在可以调用 YouGile 的工具。

可用工具

工具功能
yougile_get_current_user读取 API 密钥所属的员工:id、email、realName、isAdmin、status(在线或离线)和 lastActivity。用于检查…
yougile_list_users列出公司的员工:id、email、realName、isAdmin、messengerOnly、status 和 lastActivity。按 email 或项目过滤。…
yougile_get_user通过 id 读取一个员工:email、realName、isAdmin、messengerOnly、status、lastActivity 和 customStatus。只读
yougile_list_departments列出公司的部门:id、title、parentId(上级部门,顶层缺失)和 users(员工 id 映射到…
yougile_get_department通过 id 读取一个部门:title、parentId 和 users(员工 id 映射到经理或成员)。只读
yougile_list_projects列出密钥所有者可以看到的项目:id、title、timestamp(创建时间,毫秒)和 users(员工 id 映射到角色…
yougile_get_project通过 id 读取一个项目:title、timestamp、用户及其角色和部门及其角色映射。只读
yougile_create_project创建一个项目并返回其 id。提供参与的员工及其角色;未列出的员工无法看到…
yougile_update_project重命名项目或更改参与人员。仅传递的字段会更改;在 users 和 departments 中,值为 - 将移除…
yougile_list_boards列出看板:id、title、projectId 和贴纸(看板显示的任务贴纸:截止日期、指派人、时间跟踪、计时器、秒表…
yougile_get_board通过 id 读取一个看板:title、projectId 和为其任务启用的贴纸。只读
yougile_create_board在项目中创建一个看板并返回其 id。新看板没有列:使用 yougile_create_column 添加它们。写入 YouGile
yougile_update_board重命名看板、将其移动到另一个项目或更改其任务显示的贴纸。仅传递的字段会更改。返回看板 id。…
yougile_list_columns列出看板的列:id、title、color(1 到 16)和 boardId。任务位于列中,因此这是看板与其…
yougile_get_column通过 id 读取一列:title、color 和所属看板。只读
yougile_create_column在看板上创建一列并返回其 id。新列在现有列之后添加。写入 YouGile
yougile_update_column重命名一列、更改其颜色或将其移动到另一个看板。仅传递的字段会更改。返回列 id。写入 YouGile
yougile_list_tasks列出任务:id、title、columnId、description、completed、archived、assigned(员工 id)、deadline(毫秒)、timeTracking…
yougile_get_task通过 id 读取一个任务及其所有字段:title、description(HTML)、columnId、completed 和 completedTimestamp、archived、assigned…
yougile_create_task在一列中创建一个任务并返回其 id。没有列的任务在任何看板外创建,仅通过 id 可访问,因此始终…
yougile_update_task更改任务:title、description、指派人、截止日期、时间跟踪、检查清单、贴纸、子任务、颜色、完成或归档。仅传递的…
yougile_move_task将任务移动到另一列,无论是在同一看板还是另一个看板。这是任务改变阶段(待办、进行中、已完成)的方式。…
yougile_delete_task将任务标记为已删除。它从所有人的看板中消失;仍可通过 include_deleted 读取。默认关闭…
yougile_list_task_messages读取任务或群聊的聊天:按消息 id(以及其创建时间,毫秒)、fromUserId、text、textHtml、label…
yougile_send_task_message作为密钥所有者向任务(或群聊)发送消息。所有订阅该聊天的人都会收到通知。返回…
yougile_list_group_chats列出公司的群聊:id、title、users(员工 id 映射到通知设置)和 userRoleMap。id 是聊天 id…
yougile_list_string_stickers列出具有状态集(优先级、类型、状态等)的自定义贴纸:id、name、icon 和状态(id、name 和颜色)。一个…
yougile_get_string_sticker通过 id 读取一个状态贴纸:name、icon 及其状态(id、name、color)。只读
yougile_create_string_sticker创建一个具有状态集的自定义贴纸,例如优先级为高和低,并返回其 id。使用…
yougile_list_sprint_stickers列出冲刺贴纸:id、name 和状态,其中每个状态是一个冲刺,具有 id、name、begin 和 end(自 1970 年以来的秒数;状态…
yougile_get_sprint_sticker通过 id 读取一个冲刺贴纸:name 及其冲刺(id、name、begin 和 end,以自 1970 年以来的秒数表示)。只读
yougile_create_sprint_sticker创建一个冲刺贴纸及其冲刺并返回其 id。在任务可以放入之前,使用 yougile_update_board 为看板启用它…
yougile_list_webhooks列出公司的 webhook 订阅:id、url、事件(例如任务创建,或模式如 task-*)、disabled、lastSuccess 和…

示例提示

  • "看板 Marketing 上哪些任务已过期,谁负责?"
  • "在列 In progress 中创建任务 Prepare the Q1 report,截止日期为下周五,指派给 Anna。"
  • "将任务 Landing page copy 移动到列 Done。"
  • "本周在任务 Website relaunch 的聊天中讨论了什么?"
  • "按指派人显示当前冲刺的任务。"

常见问题

我如何获取 YouGile API 密钥? YouGile 没有显示密钥的页面:你通过一次 API 调用创建一个密钥,该调用需要你的 YouGile 登录、密码和公司 ID,并将答案粘贴到 YOUGILE_API_KEY 中。连接器从未看到你的密码。密钥不会过期,并且作为创建它的员工使用,因此请使用可以打开你需要的项目的账户创建它。

它涵盖了什么? 项目、看板和列、带截止日期的任务、检查清单、指派人和贴纸、在列之间移动任务、任务和群聊消息、员工和部门、自定义和冲刺贴纸,以及 webhook 订阅。整个公司在所有密钥之间共享每分钟 50 个请求。

哪些工具默认关闭? yougile_delete_task。仅在连接器页面上切换它,只有当 AI 应该使用它时;对于已完成的工作,AI 会归档任务。

Gemini CLI 从哪里读取 MCP 服务器? 用户级配置位于 ~/.gemini/settings.json,项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

这份指南对你有帮助吗?

2 分钟将 YouGile 连接到 Gemini

开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 YouGile,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。

相关指南