MCP 概览

Shayan Taslim更新

UserJot MCP 服务器可让 AI 工具通过远程 HTTP 直接连接到你的 UserJot 工作区,无需安装本地程序包或桥接进程。

服务器 URL

UserJot 提供一个远程 MCP 端点:

text
https://api.userjot.com/v1/mcp

身份验证

大多数现代 MCP 客户端都直接支持通过 OAuth 登录。粘贴服务器 URL(或使用 设置 → MCP & API 中的一键安装按钮或命令;VS Code 和 Gemini CLI 位于 更多 菜单中),登录 UserJot,选择工作区,然后点击 允许。

客户端

推荐的身份验证方式

设置指南

Claude(网页、桌面、移动端)

OAuth(在 Settings → MCP & API 中一键设置)

常规设置

Claude Code

OAuth(或 API 令牌)

Claude Code

Cursor

OAuth(在 Settings → MCP & API 中一键设置)或 API 令牌

Cursor

Codex

OAuth(或 API 令牌)

Codex

ChatGPT

OAuth(或在桌面端使用 API 令牌)

ChatGPT

VS Code(Copilot)

OAuth(位于 设置 → MCP & API 中的 更多 下)

常规设置

Gemini CLI

OAuth(位于 设置 → MCP & API 中的 更多 下)

常规设置

Windsurf 和无头/CI 工具

API 令牌标头

Windsurf / 常规设置

通过 OAuth 连接的应用会显示在 设置 → MCP & API 中的 已连接的应用 下,并显示每个应用的连接者。使用 按住以撤销,即可在应用下次发出请求时切断其访问权限。

Note

只有工作区所有者和管理员可以连接 OAuth 应用;而且,只有在连接该应用的用户仍是所有者或管理员时,已连接的应用才能继续运行。

对于要求使用静态标头的客户端或自动化脚本,请在 Settings → MCP & API 中创建 API 令牌,并传入:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

MCP 服务器的功能

远程 MCP 服务器提供 98 个工具,涵盖工作区的数据和工作流程(两项 REST 操作——createAsset分段上传和deleteMember GDPR 数据删除——仅支持 REST):

  • 工作区和看板:查看工作区元数据,以及创建、列出、更新或删除看板。

  • 请求、评论、投票和标签:列出、创建、更新、移动、合并或取消合并请求,查找相似请求,管理订阅,发布或置顶评论,添加或移除投票,管理标签,以及附加图片。

  • 更新日志:列出、创建、更新和删除条目,并管理关联的请求、作者和标签。

  • 对话:列出、读取和发起外发对话(createConversation需要付费套餐:Starter 每天 5 次,Professional 每天 15 次),读取时间线、发布回复和内部备注,以及更新状态或负责人。

  • 成员和公司:查找、列出、同步和更新成员及公司,并管理公司成员关系。

  • 帮助中心:创建、更新、删除、发布、取消发布和搜索合集及文章。

  • 资源:导入远程图片,或创建预签名上传链接,以便在更新日志和帮助文章中使用。

所有写入和删除工具都拥有完整的工作区权限,并标记为具有破坏性,因此客户端会在更改数据前提示确认。

速率限制和套餐权限

所有套餐(包括免费套餐)均可使用 MCP。工具调用共用工作区的 REST API 速率限制:免费套餐为 10 次请求/分钟(150 次/小时),Starter 套餐为 60 次请求/分钟(1,500 次/小时),Professional 套餐为 120 次请求/分钟(5,000 次/小时)。密集的智能体会话可能很快触及免费套餐的限制。

MCP 与 REST API

连接支持 Model Context Protocol 的 AI 助手或编程工具时,请使用 MCP。构建自己的后端集成、脚本或应用程序代码时,请使用 REST API。

令牌管理

如果使用 API 令牌而非 OAuth,请像对待其他机密信息一样妥善保护它:

  • 不要将令牌硬编码到已提交的配置文件中。

  • 建议使用环境变量或本地密钥管理器。

  • 为不同环境或团队成员使用不同的令牌。

  • 前往 设置 → MCP & API,使用 按住以撤销 撤销未使用的令牌。

后续步骤

这是否解答了您的问题?