常见设置
UserJot 不需要本地 MCP 软件包。将客户端直接连接到远程 UserJot MCP 服务器 URL,然后使用 OAuth 登录或提供 API 令牌。
https://api.userjot.com/v1/mcp使用 OAuth 登录(推荐)
在 UserJot 控制面板中打开 设置 → MCP 和 API,即可使用一键安装按钮和可复制的命令。当客户端提示你登录时,浏览器会打开 UserJot,你可以选择一个工作区并点击 允许。
Claude(网页、桌面和移动端):在 设置 → MCP 和 API 中选择 Claude,然后点击 添加到 Claude。Claude 会打开预先填入连接器的页面;确认点击 添加,然后登录。
VS Code(Copilot 代理模式):在设置 → MCP & API中打开更多 → VS Code,然后点击添加到 VS Code,接着确认安装并登录。
Gemini CLI:在设置 → MCP & API中打开更多 → Gemini CLI,或在终端中运行此命令,然后在 Gemini CLI 中运行
/mcp auth userjot以登录:
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp专属指南:请参阅 Claude Code、Cursor、Codex 和 ChatGPT。
已连接的应用会显示在设置 → MCP & API下的已连接的应用中,并标明授权它们的所有者或管理员。只有当该人员仍是工作区的所有者或管理员时,已连接的应用才会保持活跃。在此处使用按住以撤销,即可立即断开访问权限。
使用 API 令牌
对于需要自定义标头(例如 Windsurf)的客户端或无头环境,请在 设置 → MCP 和 API 中创建令牌并传入:
Server URL: https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN大多数远程 HTTP MCP 客户端都接受类似这样的 JSON 配置(对于 OAuth 客户端,请省略 headers 块):
{
"mcpServers": {
"userjot": {
"type": "http",
"url": "https://api.userjot.com/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_USERJOT_API_TOKEN"
}
}
}
}验证连接
连接后,让客户端检查 userjot 服务器或调用 getWorkspace。如果连接正常,客户端会列出你的工作区详情和可用工具,无需进行任何本地设置。
故障排除
如果连接失败,请先检查以下事项:
如果你使用 OAuth 登录,请确认该应用仍列在 设置 → MCP 和 API 中的 已连接的应用 下方,并且你仍是该工作区的所有者或管理员。
如果你使用 API 令牌,请确认该令牌未被撤销,并且
Authorization标头以Bearer开头。确认客户端支持远程 HTTP(Streamable HTTP)MCP 服务器。
确认配置文件位于正确的位置,并在编辑后重启客户端。
检查是否已达到套餐的 API 速率限制。