WEIR
获取 API Key
语言English
主题

Cherry Studio MCP 配置教程：添加远程服务器，读取推特数据

Cherry Studio 添加远程 MCP 服务器的两种写法：从 JSON 导入和快速创建。附请求头格式、OAuth 登录授权、服务器启动失败的排查，以及一次真实的推特搜索。


发布于 · 更新于 · 阅读约 6 分钟

封面图：在 Cherry Studio 里读推特

在 Cherry Studio 里配置远程 MCP 服务器，只要在设置的 MCP 页面填一个 URL。

这篇以 Weir 为例。它是只读的远程 MCP 服务器，能让 Cherry Studio 里的模型搜索 X（推特）、读推文和用户资料。我们做的就是 Weir。

在 MCP 服务器页点“添加”，选“从 JSON 导入”，粘贴这段，再换上你自己的 key：

{
  "mcpServers": {
    "weir": {
      "type": "streamableHttp",
      "url": "https://api.weirapp.io/mcp",
      "headers": {
        "Authorization": "Bearer weir_live_xxxxxxxx"
      }
    }
  }
}

Cherry Studio MCP 配置：四步接入 Weir

你需要 Cherry Studio v1.2.4 或更新的版本，这一版加入了自定义请求头。

我们没能在这里实际运行 Cherry Studio。下面的步骤来自它的官方文档和 v2.1.7 的源码，v2.1.7 是 2026 年 10 月 19 日发布的最新版。

  1. 创建 key在 Weir 控制台的 API keys 页面新建一个。它以 weir_live_ 开头，只显示一次。
  2. 打开 MCP 设置进入“设置 → MCP → MCP 服务器”，点“添加”。
  3. 导入 JSON选“从 JSON 导入”，粘贴上面的配置，换上你的 key 后确认。
  4. 检查工具导入后会自动启用。状态显示“已连接”，详情的“工具”页就会列出 Weir 的工具。

一次只加一个服务器。 Cherry Studio 文档建议先启用一个、验证通过再加下一个。几个服务同时出错，很难定位。

没写 type 时，Cherry Studio 看 URL 结尾。 以 /mcp 结尾按 streamableHttp 处理，其他一律按 SSE。Weir 的地址正好以 /mcp 结尾，不过写上 type 更保险。

不想写 JSON？用“快速创建”填表

“添加”菜单里的“快速创建”是一张表单，Weir 只需要填这几项：

  • 名称： Weir。
  • 类型： 可流式传输的 HTTP (streamableHttp)。表单默认是“标准输入 / 输出 (stdio)”，记得改。
  • URL： https://api.weirapp.io/mcp。
  • 请求头： 展开“高级设置”，每行一个 KEY=value，写成 Authorization=Bearer weir_live_xxxxxxxx。

注意这里用等号连接，不是 JSON 里的冒号。

快速创建的服务器默认是关着的。点“添加”后，在服务器列表里打开 Weir 的开关，它才会去连接。超时默认 60 秒，一般不用改。

请求头还是 OAuth：Cherry Studio 怎么授权 Weir？

看你愿不愿意复制 key。v2.1.7 源码里的规则很直接：请求头里有 Authorization 就用它，没有就走 OAuth。

方式 怎么配 适合谁
Authorization 请求头 填 Bearer 加你的 key 想一次配好，我们推荐
OAuth 登录授权 删掉 headers，留空即可 不想碰 key

走 OAuth 时，Cherry Studio 以“Cherry Studio”的名字做动态客户端注册，你不用填 Client ID。它在 127.0.0.1:12346 上等浏览器回调，Weir 接受这种本机地址。

登录成功后，浏览器会显示“认证成功”，回到 Cherry Studio 即可。按 Weir 文档，这个连接会出现在控制台的 API keys 页，名为 Cherry Studio (MCP)，不用时在那里撤销。

这套登录流程我们还没在 Cherry Studio 里实际走过，所以请求头是主路线。

给 key 只开 X 权限。 建 key 时 Sources 只勾 X，Weir 就不会列出 12 个 Reddit 工具，模型要挑的工具少一些。

在对话和智能体里怎么使用 MCP 工具？

Cherry Studio 有两个地方能用 Weir，入口不一样：

  • 对话里的助手。 在输入框点“+”或输入 /，选“MCP”，启用 Weir。想让某个助手一直带着它，就右键助手，在“编辑助手”的 MCP 标签页里启用。
  • “工作”里的智能体。 打开 Agent 菜单，选“编辑”，在“MCP”里绑定 Weir。没启动的服务器绑不上。

在提示词里写明工具名，比如“用 Weir 的 search_x”，模型更容易选对。

实测：让 Cherry Studio 查 DeepSeek 最近发了什么

接上 Weir 后，可以直接这样问：

用 Weir 查一下 @deepseek_ai 最近 30 天在 X 上发了什么，
跳过转推和回复，列出和模型或 API 更新有关的。

模型该调用的是 search_x。我们在 2026 年 10 月 24 日通过 Weir 的 MCP 服务器跑了这次调用：

→ search_x {"fromUsers": ["deepseek_ai"], "query": "-filter:nativeretweets",
            "since": "2026-09-24T00:00:00Z", "onlyOriginal": true, "limit": 3}
← 3 posts · 4 credits (1 + 3 × 1) · nextCursor set
  2026-10-20  42,938 likes  开源自研推理框架 DeepInfer
  2026-10-17  37,125 likes  DeepSeek-V4.1-Flash-1017 上线网页、App 和 API
  2026-10-02   4,848 likes  DeepSeek Harness 推出桌面版

onlyOriginal 去掉回复，-filter:nativeretweets 去掉转推，X 搜索默认会带上转推。这类搜索怎么写，可以看推特高级搜索语法大全。

三条都和模型或产品更新有关。先拿 3 条确认方向，只花了 4 积分。

返回里还带着 nextCursor。按 Weir 文档，只有它为 null 才算到底，所以还能再翻一页。

想看某条推文下面大家怎么说，可以接着让模型调用 get_x_replies，或用 get_x_thread 读完整个推文串。

4积分：这次 3 条推文的搜索
21积分：一次搜 20 条推文
0积分：查用量的 get_usage
5,000每月免费积分

Weir 每次调用收 1 积分，每条 X 推文再收 1 积分，失败的调用不收费。截至 2026 年 10 月，积分包 $5（美元）起，含 25,000 积分，永不过期。各项单价见价格页（英文）。

Cherry Studio MCP 服务器启动失败怎么办？

连接失败时，Cherry Studio 文档建议先看服务器详情里的日志。常见的几种情况：

  • 找不到 uv、bun，或提示命令不存在。 这是本地 stdio 服务器缺运行环境，到“设置 → 环境依赖”里安装。Weir 是远程服务器，用不到它们。
  • 报 -32000 错误。 在 MCP 的 TypeScript SDK 1.x 里，它表示连接已关闭，多半是本地服务器进程启动后就退出了。
  • 导入后提示“连接失败”。 检查类型是不是 streamableHttp，URL 是否完整。
  • 一直“等待浏览器授权”。 没带请求头，Cherry Studio 在走 OAuth。去浏览器里完成登录，或者加上请求头。
  • 无法在 127.0.0.1:12346 监听 OAuth 回调。 这个端口被别的程序占了，关掉它再试，或者改用请求头。
  • 已连接，模型却不调用工具。 确认当前助手或智能体绑定了 Weir，工具没被关掉，再发一条新消息。
  • 工具返回 401、402 或 403。 401 是 key 错了或过期，402 是积分用完、重试没用，403 是 key 缺这个权限。

什么时候不适合用 Weir

  • 模型要发推或私信。 Weir 只读，不能发推、点赞或关注。
  • 你要读自己的私密数据。 Weir 只读公开推文，读不到书签、私信和首页时间线。
  • 最在意单价。 截至 2026 年 10 月，TwitterAPI.io 标价每 1,000 条推文 $0.15，比我们 $5 积分包的单价低。
  • 你需要稳定保证。 Weir 没有获得 X 授权，也和 X 没有关联，访问方式可能会变。

常见问题

Cherry Studio 支持哪些 MCP 传输方式？

支持 STDIO、SSE 和可流式传输的 HTTP，另有内置服务器。本地程序用 STDIO，远程服务看对方给的地址。Weir 是远程服务，用 streamableHttp，地址 https://api.weirapp.io/mcp。

Cherry Studio 有推荐的 MCP 服务器吗？

内置服务器里有 Browser、Python、QVeris 等。MCP 设置的“市场”页还链接了魔搭、mcp.so、Smithery 等外部目录。要读推特数据，按本文用 URL 添加 Weir，它的工具和用途见推特 MCP 服务器。

用 Weir 必须要 API key 吗？

不一定。不填请求头，Cherry Studio 会走 OAuth，在浏览器里登录 Weir 就行。填了 Authorization 请求头就直接用 key。两种方式连的是同一个地址。

Cherry Studio 能通过 Weir 发推吗？

不能。Weir 只读公开的 X 数据，不能发推、点赞或关注。要发推，得用持有你 X 账号权限的工具。

参考来源

以下均于 2026 年 10 月 24 日查阅：

继续阅读