在 AI 助手里连接 Vara

Claude（网页版和桌面版）

1. 打开 Claude，进入「设置 → 连接器」，点「添加自定义连接器」。
2. 名称填 Vara，地址填上面的连接地址，保存。
3. 点「连接」。浏览器会打开 Vara 的登录和授权页，登录后点「允许」。
4. 回到 Claude，新开一个对话，说「列出我的 Vara 实验」试一下。

如果 Claude 没有用上 Vara，在输入框的工具菜单里确认 Vara 已打开（菜单位置以当前界面为准）。

ChatGPT

Vara 还没有上架 ChatGPT 的插件目录，目前需要把它手动添加成自定义 MCP 服务器。按 OpenAI 帮助中心的说明，现在直接在「插件」里添加，不需要先打开开发者模式。只能在网页版 ChatGPT 添加，手机上不行。

能不能添加、能不能写入以你在 ChatGPT 里看到的为准。连上后不确定能不能写，用下面常见问题里的「检查连接」试一下。

1. 在网页版 ChatGPT 打开侧栏的「插件」（Plugins），点加号，选「添加自定义 MCP 服务器」（Add custom MCP server）。菜单名以 ChatGPT 当前界面为准。
2. 名称填 Vara，描述可以不填。在「连接」（Connection）一栏填上面的连接地址 https://varaos.com/api/mcp。
3. 身份验证选 OAuth。阅读风险提示，勾选「I understand and want to continue」，点「Create as a plugin」，核对列出的 Vara 工具。
4. 按提示安装这个插件。浏览器打开 Vara 的登录和授权页时，登录后点「允许」。
5. 新开一个对话，在输入框输入 @ 选择 Vara，再说「列出我的 Vara 实验」试一下。

写入数据前 ChatGPT 可能会先请你确认，按提示点确认即可。

腾讯 WorkBuddy、豆包等国内客户端

这些客户端添加自定义 MCP 的入口和支持的方式各不相同。一般在设置里的「MCP」「连接器」或「工具」页，找「添加自定义 MCP」或「添加远程服务器」一类的按钮，名称以客户端当前界面为准。客户端会走下面两种方式之一。

方式一：能打开浏览器授权

1. 服务器地址填上面的连接地址。
2. 传输类型有得选时，选 Streamable HTTP（有的客户端叫 HTTP）。
3. 保存后按提示打开浏览器，登录 Vara 点「允许」。

方式二：只能填地址和请求头

1. 在 设置 → API 新建一个 API key，复制保存（只显示一次）。要让 AI 写入数据（建实验、记运行、排计划等）就选「读写」，默认是只读。
2. 服务器地址填 https://varaos.com/api/mcp，传输类型选 Streamable HTTP。
3. 添加一个请求头，名称是 Authorization，值是 Bearer 加一个空格再加你的 key：

Authorization: Bearer vara_sk_...

• 这种方式不经过授权页，key 本身就是凭证，不用开通 API 访问，用量规则和授权连接相同。
• 用 key 的连接不会出现在「已连接的应用」里。要断开，在 设置 → API 撤销这个 key，撤销后立即失效。
• key 等同于密码：不要发给别人，不要贴进对话或截图。怀疑泄露就撤销，再新建一个换上。

进阶：Claude Code

1. 在终端运行：

claude mcp add --transport http vara https://varaos.com/api/mcp

2. 打开 Claude Code，输入 /mcp，选中 vara 完成授权。浏览器会打开 Vara 的登录和授权页，点「允许」后回到终端。

进阶：Cursor

1. 在装了 Cursor 的电脑上点下面的按钮：

2. 按钮没反应时，手动在 mcp.json 里写入下面的配置并保存：

{
  "mcpServers": {
    "vara": { "url": "https://varaos.com/api/mcp" }
  }
}

3. 按提示登录 Vara 并点「允许」。

进阶：Codex

1. 在 ~/.codex/config.toml 里加入下面的配置并保存：

[mcp_servers.vara]
url = "https://varaos.com/api/mcp"

2. 在终端运行下面的命令，浏览器会打开 Vara 的登录和授权页，点「允许」：

codex mcp login vara

3. 完全退出 Codex 再打开，新开一个会话说「列出我的 Vara 实验」试一下。

ChatGPT 桌面版、Codex 命令行和编辑器插件共用这份配置，配一次就都能用。以前用 API key 和本地版接过 Vara 的，删掉原来的 [mcp_servers.vara] 再按上面配置。