常见设置

Shayan Taslim更新

UserJot 不需要本地 MCP 软件包。将客户端直接连接到远程 UserJot MCP 服务器 URL,然后使用 OAuth 登录或提供 API 令牌。

text
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 以登录:

Bash
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp

已连接的应用会显示在设置 → MCP & API下的已连接的应用中,并标明授权它们的所有者或管理员。只有当该人员仍是工作区的所有者或管理员时,已连接的应用才会保持活跃。在此处使用按住以撤销,即可立即断开访问权限。

使用 API 令牌

对于需要自定义标头(例如 Windsurf)的客户端或无头环境,请在 设置 → MCP 和 API 中创建令牌并传入:

text
Server URL:    https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN

大多数远程 HTTP MCP 客户端都接受类似这样的 JSON 配置(对于 OAuth 客户端,请省略 headers 块):

JSON
{
  "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 速率限制。

后续步骤

  • 请在MCP 概览中查看全部 98 项可用工具及安全详情。

  • 如果你正在编写直接调用后端的代码,请使用 REST API。

这是否解答了您的问题?