摘要
YouGile 项目管理:项目、看板、列、带截止日期的任务、检查清单和指派人、任务聊天消息、员工、部门、自定义和冲刺贴纸以及 webhook 订阅。API 密钥。
引导式设置
2 分钟将 YouGile 连接到 Gemini
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 YouGile,再把你的 MCP URL 添加到 Gemini。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
YouGile 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
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 登录和密码。从终端运行一次;连接器本身不会看到你的密码。
- 找到你的公司 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。 - 创建密钥:
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":"..."}。 - 将密钥粘贴到
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" }
}
}
}
- 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥,并用它替换
YOUR_MCP_API_KEY。 - 保存文件并重启
gemini。 - 在 Gemini CLI 中运行
/mcp(或在终端运行gemini mcp list)—anythingmcp应显示为已连接。 - 开始输入提示 — 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 会列出每个服务器及其连接状态。
下一步
这份指南对你有帮助吗?