连接你的 agent

每种 agent 的连接步骤。最快的方法是发一句话，让 agent 自己完成设置。

每个 agent 只需要连接一次。不需要 API key：在浏览器里登录 scholarmuse.ai，点击允许即可。之后这个 agent 就能使用 ScholarMuse 的全部工具。

最快的方法：发一句话

如果你的 agent 能运行命令或修改文件（Claude Code、Codex、Gemini CLI、Cursor、Trae、CodeBuddy、Qwen Code 等），把下面这句话当作普通消息发给它：

阅读 https://scholarmuse.ai/install/agent.md，按说明连接 ScholarMuse。需要时打开浏览器授权，然后告诉我你现在能帮我的研究做哪三件事。

agent 会读取安装说明，添加服务器，打开浏览器授权，并确认工具可以使用。浏览器打开后，登录并点击允许。有些 agent 需要重启一次，才会显示 ScholarMuse 已连接。

如果你的 agent 在网页或桌面应用里，不能自己修改设置，就按下面对应的步骤手动添加。服务器地址始终是：

https://scholarmuse.ai/mcp

连接页面里也有同样的步骤，还有 Cursor、VS Code、Trae 和 Cherry Studio 的一键安装链接。

Claude

**Claude.ai 和 Claude 桌面版：**打开“设置 → 连接器”，选择“添加自定义连接器”，粘贴服务器地址，然后按提示登录。

**Claude Code：**在终端运行这条命令，然后在 Claude Code 里输入 /mcp，选中 scholarmuse，选择 Authenticate。

claude mcp add --transport http --scope user scholarmuse https://scholarmuse.ai/mcp

ChatGPT

在网页版 ChatGPT 里打开 Plugins 页面，点加号，选 Add custom MCP server。名称填 ScholarMuse，把服务器地址填为服务器 URL，认证方式选 OAuth。确认风险提示并创建后，在 scholarmuse.ai 登录授权。新建对话，输入 @ 选中 ScholarMuse 即可。

能否添加自定义 MCP 服务器取决于你的 ChatGPT 套餐；在团队工作区里，还取决于管理员的设置。

Codex

codex mcp add scholarmuse --url https://scholarmuse.ai/mcp
codex mcp login scholarmuse

第二条命令会打开浏览器登录。

Gemini CLI

gemini mcp add --transport http --scope user scholarmuse https://scholarmuse.ai/mcp

然后在 Gemini CLI 里运行 /mcp auth scholarmuse。

Cursor

把下面的内容写进 ~/.cursor/mcp.json（文件不存在就新建；如果里面已有别的服务器，只加上 scholarmuse 这一条）：

{
  "mcpServers": {
    "scholarmuse": {
      "url": "https://scholarmuse.ai/mcp"
    }
  }
}

在 Cursor 的 MCP 设置里找到 scholarmuse，确认它已开启，从这个条目开始登录。

VS Code（Copilot agent 模式）

code --add-mcp '{"name":"scholarmuse","type":"http","url":"https://scholarmuse.ai/mcp"}'

其他 agent

WorkBuddy

**在哪里：**连接器 → 自定义连接器 → 配置 MCP，或文件 ~/.workbuddy/mcp.json

{
  "mcpServers": {
    "scholarmuse": {
      "type": "streamableHttp",
      "url": "https://scholarmuse.ai/mcp"
    }
  }
}

WorkBuddy 不会直接加载新添加的服务器，需要你先在应用里确认信任，然后再完成浏览器授权。

Trae

**在哪里：**设置 → MCP → 添加 → 手动添加（运行环境选“本地”）

{
  "mcpServers": {
    "scholarmuse": {
      "url": "https://scholarmuse.ai/mcp"
    }
  }
}

确认后，在 Trae 打开的浏览器页面里完成授权。

Qoder

**在哪里：**扩展 → 连接器 → 添加 → 添加自定义 MCP，或文件 ~/.qoder/settings.json（Qoder CLI）

{
  "mcpServers": {
    "scholarmuse": {
      "type": "http",
      "url": "https://scholarmuse.ai/mcp"
    }
  }
}

在 Qoder CLI 里输入 /mcp，选中 scholarmuse 并完成认证。

CodeBuddy

**在哪里：**CodeBuddy Code：在终端运行这条命令。CodeBuddy IDE：设置 → MCP → Add MCP，填同一个地址，type 写 "http"。

codebuddy mcp add --scope user --transport http scholarmuse https://scholarmuse.ai/mcp

启动 CodeBuddy，输入 /mcp，为 scholarmuse 完成授权。

Kimi Code

**在哪里：**在 Kimi Code 里输入 /mcp-config，或编辑 ~/.kimi-code/mcp.json

{
  "mcpServers": {
    "scholarmuse": {
      "url": "https://scholarmuse.ai/mcp"
    }
  }
}

运行 /mcp-config login scholarmuse。

Qwen Code

**在哪里：**在终端运行这条命令

qwen mcp add --transport http --scope user scholarmuse https://scholarmuse.ai/mcp

启动 qwen，输入 /mcp，为 scholarmuse 完成认证。

Cherry Studio

**在哪里：**设置 → MCP → MCP 服务器 → 添加：类型选 Streamable HTTP，请求头留空

https://scholarmuse.ai/mcp

保存并启用该服务器，浏览器会打开登录页。

Antigravity

**在哪里：**文件 ~/.gemini/config/mcp_config.json（在 IDE 里：agent 面板的“…” → MCP Servers → Manage MCP Servers → View raw config）

{
  "mcpServers": {
    "scholarmuse": {
      "serverUrl": "https://scholarmuse.ai/mcp"
    }
  }
}

在 Settings → Customizations 里点击该服务器的 Authenticate。

Windsurf

**在哪里：**Cascade → MCP 菜单 → Open MCP config file

{
  "mcpServers": {
    "scholarmuse": {
      "serverUrl": "https://scholarmuse.ai/mcp"
    }
  }
}

刷新服务器列表，按提示登录。

OpenCode

**在哪里：**文件 opencode.json

{
  "mcp": {
    "scholarmuse": {
      "type": "remote",
      "url": "https://scholarmuse.ai/mcp",
      "enabled": true
    }
  }
}

运行 opencode mcp auth scholarmuse。

OpenClaw

**在哪里：**在终端运行这两条命令

openclaw mcp set scholarmuse '{"url":"https://scholarmuse.ai/mcp","transport":"streamable-http","auth":"oauth"}'
openclaw mcp login scholarmuse

打开它打印出的授权链接。

修改配置文件时，保留里面原有的条目。

无法打开授权页面的应用

有些应用可以添加 MCP 服务器，但自己没法完成浏览器登录，比如通义灵码插件、百度 Comate、MiniMax Code，以及没有弹出授权页面的豆包桌面版。在这些应用里，通过 mcp-remote 把 ScholarMuse 添加为本地服务器。mcp-remote 是一个小工具，会替应用打开浏览器登录。需要 Node.js 18 或更高版本。

{
  "mcpServers": {
    "scholarmuse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://scholarmuse.ai/mcp"
      ]
    }
  }
}

其他 MCP 应用

在设置里找“自定义连接器”“MCP 服务器”或“添加服务器”，粘贴服务器地址即可。如果应用有命令行，也可以运行：

npx -y add-mcp https://scholarmuse.ai/mcp

确认连接成功

问你的 agent：“列出 ScholarMuse 的能力，告诉我你现在能帮我的研究做哪三件事。”如果看不到工具，请看常见问题排查。

目录