在 AI 助手里连接 Vara

连接地址

所有客户端都用同一个地址。不用装软件，也不用建 API key，按提示登录 Vara 并点「允许」就行。

https://varaapp.site/api/mcp

开始前请确认账号已开通 API 访问（试用或订阅，和 API key 是同一个开关），可以在 设置 → API 查看和开通。没开通时授权能完成，但连接会被拒绝，并提示到设置 → API 开通。

Claude（claude.ai 网页版和桌面版）

1. 打开 设置 → 连接器 → 添加自定义连接器。
2. 名称随意填（例如 Vara），地址填上面的连接地址。
3. 点「连接」，在弹出的页面登录 Vara，确认权限后点「允许」。
4. 回到 Claude，在对话里说「列出我的 Vara 实验」试一下。

Claude Code

在终端运行：

claude mcp add --transport http vara https://varaapp.site/api/mcp

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

Cursor

装了 Cursor 的电脑上可以直接点下面的按钮添加：

按钮没反应时，手动在 mcp.json 里写入下面的配置，保存后按提示登录 Vara 并点「允许」：

{
  "mcpServers": {
    "vara": { "url": "https://varaapp.site/api/mcp" }
  }
}

其他客户端

支持远程 MCP 和 OAuth 登录的客户端都可以用同一个地址连接。需要本地 server 或 API key 的接法见 MCP 参考。

权限：只读或读写

授权页会显示申请连接的应用和它授权后跳回的地址，由你选择权限：

• 只读：可以查看你的实验、子实验、运行记录、计划、文献和物料。
• 读写：在只读之外，还能新建和修改这些记录、上传附件，以及删除计划条目、附件和文献挂接。
• 无论哪种权限，实验、子实验和运行记录这些核心数据都删不了。
• 连接不会读取你的 AI 提供商 key、账号设置和密码。
• 授权后客户端拿到的访问令牌也能直接调用 Vara 的 /api/v1 数据接口，准入、权限和限流与 API key 相同。LLM 网关（/v1/chat/completions、/v1/models）不接受这种令牌。

如果授权页上的应用名或跳回地址不是你刚刚发起连接的那个，请点「拒绝」。

如何断开

• 在 设置 → API 的「已连接的应用」里找到对应的应用，点「断开」。断开立即生效，之后它无法再访问你的 Vara 数据，要用需重新授权。
• 也可以在 AI 客户端里移除 Vara 连接器。只在客户端里移除时，Vara 这边的授权不会马上作废，想立即失效请同时在设置里断开。

数据会发到哪里

• 连接后，你让 AI 助手做的事会调用 Vara 的工具，工具返回的 Vara 数据（例如实验名称、步骤、参数、运行备注）会发给这个 AI 平台，成为你和它对话的一部分。
• 这些数据在该平台上是否被用于训练、保存多久，取决于你在该平台的设置和它的隐私政策，不由 Vara 决定。
• Vara 只把数据发给你授权的那个客户端，不会发给其他应用。已经进入对话的内容，需要在该 AI 平台里删除。

详见 隐私政策。

附件限制

远程连接读不到你电脑上的文件。AI 助手上传附件时，可以给一个公开的文件链接（不超过 25MB），或直接上传小文件（不超过 3MB）。本机上更大的文件，请在 Vara 网页里直接拖入。

常见问题