@内贝洛夫/尤吉尔·麦克普
](https://www.npmjs.com/package/@nebelov/yougile-mcp)   ](https://nodejs.org/)
MCP服务器 尤吉尔 项目管理。 57工具 覆盖100%的YouGile API v2。
使用 克劳德, ChatGPT, Gemini CLI, VS代码, 光标，以及任何兼容MCP的客户端。
AI agent creates project, boards, columns, and tasks with rich descriptions — all via MCP
快速开始
自动设置（推荐）
npx @nebelov/yougile-mcp --setup将您登录到YouGile，获得API密钥，并为您的人工智能工具编写配置。
手动设置
- 从YouGile获取API密钥（设置>API或
POST /auth/keys) - 添加到您的AI工具配置中：
克劳德代码 (~/.claude.json):
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": ["-y", "@nebelov/yougile-mcp"],
"env": { "YOUGILE_API_KEY": "your-key" }
}
}
}克劳德桌面 (claude_desktop_config.json):
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": ["-y", "@nebelov/yougile-mcp"],
"env": { "YOUGILE_API_KEY": "your-key" }
}
}
}Gemini CLI (~/.gemini/settings.json):
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": ["-y", "@nebelov/yougile-mcp"],
"env": { "YOUGILE_API_KEY": "your-key" }
}
}
}VS代码 (.vscode/mcp.json):
{
"mcpServers": {
"yougile": {
"command": "npx",
"args": ["-y", "@nebelov/yougile-mcp"],
"env": { "YOUGILE_API_KEY": "your-key" }
}
}
}ChatGPT设置
选项A：托管（推荐）
使用托管服务器 you-mcp.com --无需安装。
在ChatGPT（网络）中：
- 设置>应用程序和连接器>高级> 开发人员模式 开
- 点击 创建 >粘贴
https://you-mcp.com/mcp>保存 - 打开任何聊天>点击 + >更多>开发者模式>启用连接器
- ChatGPT将重定向您使用YouGile电子邮件和密码登录
- 您的凭据直接进入YouGile的API（零确认代理-服务器永远看不到您的密码）
选项B：自托管（ngrok）
需要 吸烟 （免费）。
步骤1。 使用HTTP传输启动服务器：
YOUGILE_API_KEY=your-key npx @nebelov/yougile-mcp --http --port 3000步骤2。 在第二个终端中，创建HTTPS隧道：
ngrok http 3000复制 https://...ngrok-free.app 来自ngrok输出的URL。
步骤3。 在ChatGPT（网络）中：
- 设置>应用程序和连接器>高级> 开发人员模式 开
- 点击 创建 >粘贴
https://YOUR-URL.ngrok-free.app/mcp>保存 - 打开任何聊天>点击 + >更多>开发者模式>启用连接器
可用工具（57）
| 模块 | 工具 | 说明 |
|---|---|---|
| 项目 | 4 | 列表、获取、创建、更新 |
| boards | 4 | 列表、获取、创建、更新 |
| 列 | 4 | 列表、获取、创建、更新 |
| 任务 | 6 | 列出、获取、创建、更新、获取/设置聊天订阅者 |
| 聊天 | 8 | 消息（列表、发送、获取、删除）+群聊（列表、获取、创建、更新） |
| 用户 | 5 | 列表、获取、邀请、更新、删除 |
| 公司 | 2 | 获取、更新 |
| 部门 | 4 | 列表、获取、创建、更新 |
| 项目角色 | 5 | 列表、获取、创建、更新、删除 |
| 字符串贴纸 | 6 | CRUD+创建/更新状态 |
| 冲刺贴纸 | 6 | CRUD+创建/更新状态 |
| webhook | 3 | 列表、创建、更新 |
捆绑技能
该套餐包括 skill/SKILL.md --通过人工智能与YouGile合作的最佳实践指南。将其复制到您的项目或Claude Code技能目录中，以更好地进行任务管理。
API模式
- 软删除:
PUT {deleted: true}适用于所有实体。DELETE该方法仅适用于项目角色。 - 分页:
{paging: {count, limit, offset, next}, content: [...]}.例外情况：/webhooks返回原始数组。 - 贴纸字段：使用
name（不是title)用于贴纸和州。 - 已分配任务：UUID数组
["uuid1", "uuid2"]，不是一个物体。 - 聊天消息:
PUT仅支持{deleted: true}--无法编辑文本。 - 州ID：12个字符的十六进制字符串（不是UUID）。
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
YOUGILE_API_KEY | 是 | YouGile API密钥 |
YOUGILE_API_HOST_URL | 否 | 自定义API URL（默认值： https://yougile.com/api-v2) |
发展
git clone https://github.com/nebelov/yougile-mcp
cd yougile-mcp
npm install
npm run dev许可证
麻省理工学院