Weegloo Docs - Claude 设置

将 WEEGLOO MCP 服务器连接到 Claude 后，Claude 就能直接创建、读取和修改 Space、Content Type、Content、Media 等资源。MCP 是什么、需要哪些准备，请参阅 MCP。本页仅针对 Claude，分步骤介绍连接方法。

Claude 可在两种环境中连接：网页版（claude.ai）和桌面应用。两种环境的差异如下。

网页版：仅连接 HTTP 方式的 weegloo 服务器。创建、读取和修改资源的操作均可执行。
桌面应用：除 weegloo 服务器外，还会连接处理文件的 weegloo-upload 服务器。要执行 Media 上传或 Web Hosting 部署等涉及文件传输的操作，需要使用桌面应用。

两种环境都需要 Claude 付费套餐（Pro 及以上）才能连接 MCP 服务器。

连接所需的 Personal Access Token 的签发，请参阅签发 Personal Access Token。在下面的设置中标有 <Personal Access Token> 的位置，直接填入签发到的值。

连接到网页版（claude.ai）

网页版仅连接 HTTP 方式的 weegloo 服务器。文件上传服务器（weegloo-upload）只能在桌面应用中连接，如需文件操作，请按照下面的桌面应用说明操作。

登录 claude.ai 后，打开添加连接器画面。
输入服务器信息。名称填入 weegloo，服务器地址填入 https://ai.weegloo.com/mcp。
按照提示完成登录（认证）。
点击输入框的工具图标，若能看到 weegloo 服务器的工具，即表示已连接。

在服务器地址末尾附加 ?group= 值，可以更改可用的工具组。例如要使用全部工具，则填入 https://ai.weegloo.com/mcp?group=all。各组之间的差异，请参阅 MCP 中的 MCP 服务器组表格。

连接到桌面应用

桌面应用会分别连接两个服务器。用于资源操作的 weegloo 服务器与网页版一样采用 HTTP 方式连接，用于文件操作的 weegloo-upload 服务器则以在本机直接运行的方式连接。

服务器	连接方式	注册位置
`weegloo`	HTTP（远程）	设置 > 连接器
`weegloo-upload`	在本机直接运行	配置文件（`claude_desktop_config.json`）

要运行 weegloo-upload 服务器，需要安装 Node.js 18 及以上版本。

连接 weegloo 服务器

weegloo 服务器的连接方法与网页版相同。

在桌面应用的设置中打开连接器（Connectors）画面。
点击添加连接器按钮。
名称填入 weegloo，服务器地址填入 https://ai.weegloo.com/mcp。
按照提示完成登录（认证）。

连接 weegloo-upload 服务器

用于文件操作的 weegloo-upload 服务器，通过直接写入配置文件来注册。

打开 Claude 桌面应用的配置文件。各操作系统的位置如下。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

在文件中填入以下内容。如果已经注册了其他服务器，则只需在 mcpServers 中添加 weegloo-upload 项。

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

在 AUTH_BEARER_TOKEN 的值（<Personal Access Token> 位置）填入签发到的 Personal Access Token。
完全退出 Claude 桌面应用后再重新打开。macOS 用 Cmd+Q，Windows 在任务栏图标上退出，使应用完全关闭。
点击输入框的工具图标，若 weegloo 和 weegloo-upload 两个服务器的工具都能看到，即表示已连接。

使用 npx weegloo@latest 安装工具，可以自动完成上述配置文件的编写。安装工具的用法，请参阅 MCP。

无法连接时

npx: command not found 错误：表示未安装 Node.js，或其未被纳入执行路径。请从 Node.js 官方网站安装 LTS 版本。
在 Windows 上看不到服务器时：在配置文件中将 command 改为 cmd、将 args 改为 ["/c", "npx", "-y", "weegloo-upload"]，然后重试。
认证错误：确认填入 AUTH_BEARER_TOKEN 的 Personal Access Token 是否正确，以及是否尚未过期。

后续操作

MCP：介绍安装工具、服务器组、可执行的操作等 MCP 连接的整体概览。
签发 Personal Access Token：介绍如何签发连接所用的令牌。
用 AI 迁移静态页面：跟随这一流程，用已连接的 MCP 将实际页面迁移为基于内容的服务。