MCP 云端 SSE 接入教程

Ai4Scholar-MCP 通过云端服务提供多源学术检索能力。配置完成后，你可以在 AI 对话中搜索论文、查询论文详情和引用信息，无需自行部署 MCP 服务。

接入前准备

1. 登录 Ai4Scholar，在 API Key 管理 中创建或复制自己的密钥。
2. 准备一个支持 远程 SSE 和 自定义请求头 的 MCP 客户端。
3. 按下面对应客户端的步骤添加服务，保存后启用工具并测试一次检索。

本页示例中的 YOUR_API_KEY 都是占位符，请替换为自己的 Ai4Scholar API Key。保留前面的 Bearer ，包括末尾的一个空格。密钥应填写在客户端的 MCP 配置中，不要发送到对话里或提交到公开代码仓库。

连接信息

如果客户端把请求头拆成「名称」和「值」两栏，分别填写上表的两项。如果使用单行输入，按客户端要求填写；例如 Cherry Studio 使用 Authorization=Bearer YOUR_API_KEY。

SSE 与 Streamable HTTP 是不同的 MCP 传输方式。有明确传输选项时，请为本页地址选择 SSE；只有 HTTP 选项的客户端需要支持 SSE 回退，才能使用这个地址。

选择你的客户端

点击客户端名称，跳转到对应步骤。配置方式不同，请使用自己客户端的示例。

Cherry Studio

1. 打开 设置 → MCP 服务器 → 添加服务器。
2. 名称填写 ai4scholar，描述可填写「Ai4Scholar 学术检索」。
3. 类型选择 服务器发送事件（SSE），URL 填写 https://mcp.ai4scholar.net/sse。
4. 在请求头中填写下面这一行，替换其中的 API Key。

Authorization=Bearer YOUR_API_KEY

5. 保存，并打开服务器的启用开关。等待工具列表加载完成。
6. 回到对话，在输入框的 MCP 菜单中选择「手动」，勾选 ai4scholar，再发送检索问题。使用新版 Agent 界面时，在 工作 → Agent 菜单 → 编辑 → MCP 中启用该服务器。

保存服务器后，还需要在当前对话或 Agent 中启用它。若没有看到工具调用，先检查这两个位置的开关。新版入口见 Cherry Studio MCP 文档。

Cursor

打开 Cursor 的 MCP 设置，或编辑项目下的 .cursor/mcp.json。希望所有项目都能使用时，可编辑 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "ai4scholar": {
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

如果文件里已经有其他服务，只把 ai4scholar 这一项合并到已有的 mcpServers 中，与其他服务并列，保留原有配置。

保存后回到 MCP 设置，确认服务已启用、工具已加载，再在 Agent 对话中发起检索。配置位置及字段说明见 Cursor MCP 文档。

Claude Code

在终端执行以下命令，将云端服务添加到用户配置，供不同项目使用：

claude mcp add --transport sse --scope user ai4scholar https://mcp.ai4scholar.net/sse --header "Authorization: Bearer YOUR_API_KEY"

添加后，在 Claude Code 对话中输入 /mcp，查看 ai4scholar 的连接状态和工具列表。如果只想在当前项目使用，可以去掉 --scope user。

Claude Code 官方文档提供 SSE 与自定义请求头的配置方式。遇到连接失败时，先更新客户端并检查请求头，再按文末的常见问题排查。

Chatbox

在设置中打开 MCP 管理，添加远程服务器。填写名称 ai4scholar、服务地址 https://mcp.ai4scholar.net/sse，并添加请求头 Authorization，值为 Bearer YOUR_API_KEY。

如果当前版本提供 JSON 导入入口，可以使用：

{
  "mcpServers": {
    "ai4scholar": {
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

点击「测试」验证连通，通过后保存并启用该服务，再在支持工具调用的工作模式中使用。菜单入口随版本可能不同，可参照 Chatbox 工作模式配置。

Dify

1. 进入工作区的 工具 → MCP，添加 MCP 服务器；部分版本的入口名称为「添加 MCP 服务器（HTTP）」。
2. 名称填写 ai4scholar，Server URL 填写 https://mcp.ai4scholar.net/sse。
3. 在 Headers 中添加 Authorization，值为 Bearer YOUR_API_KEY。如果显示传输选项，选择 SSE。
4. 保存并完成连接验证，确认工具列表已加载。
5. 在 Workflow 或 Agent 中选择刚添加的 MCP 工具，配置查询词后运行一次测试。

如果所在版本没有 MCP 入口，或该入口不能传递请求头、不能连接 SSE，可以使用 Ai4Scholar 的 Dify 插件。

Kimi Code

在 Kimi Code 中输入 /mcp-config 管理服务器，或编辑 MCP 配置文件。当前官方文档中的用户配置路径为 ~/.kimi-code/mcp.json，项目配置为 .kimi-code/mcp.json；旧版本的路径可能不同。

{
  "mcpServers": {
    "ai4scholar": {
      "transport": "sse",
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

这里必须明确填写 "transport": "sse"。保存后新建会话，输入 /mcp 检查连接状态。配置格式与版本差异见 Kimi Code MCP 文档。

Gemini CLI

在终端中添加服务：

gemini mcp add --transport sse --scope user ai4scholar https://mcp.ai4scholar.net/sse --header "Authorization: Bearer YOUR_API_KEY"

也可以编辑 ~/.gemini/settings.json，或项目下的 .gemini/settings.json，合并以下配置：

{
  "mcpServers": {
    "ai4scholar": {
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

两种方式选择一种即可。启动 Gemini CLI 后输入 /mcp 查看工具，也可运行 gemini mcp list 检查连接。

Gemini CLI 用 url 表示 SSE 端点，httpUrl 表示 Streamable HTTP；本页示例使用 url。详见 Gemini CLI MCP 文档。

OpenCode

编辑项目下的 opencode.json，或全局配置 ~/.config/opencode/opencode.json，在 mcp 中添加：

{
  "mcp": {
    "ai4scholar": {
      "type": "remote",
      "url": "https://mcp.ai4scholar.net/sse",
      "enabled": true,
      "oauth": false,
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

保存后重新加载 OpenCode，运行 opencode mcp list 检查服务状态。这里使用 API Key 鉴权，因此将 oauth 设为 false。字段说明见 OpenCode MCP 文档。

TRAE

打开 MCP → 添加 → 手动添加，粘贴配置并替换 API Key：

{
  "mcpServers": {
    "ai4scholar": {
      "type": "sse",
      "url": "https://mcp.ai4scholar.net/sse",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

保存后检查服务状态，并在使用的智能体中启用 ai4scholar 工具。

Claude Desktop

云端服务通过 自定义连接器 接入。先检查自己的连接器设置是否提供 Request headers（请求头）：这一功能仍有账号或组织范围限制。

如果有该选项：

1. 在 Customize → Connectors 中添加自定义连接器；组织管理员的入口可能位于组织设置中。
2. 名称填写 ai4scholar，MCP server URL 填写 https://mcp.ai4scholar.net/sse。
3. 在认证方式中选择 No sign-in，再在 Request headers 中添加 Authorization，值为 Bearer YOUR_API_KEY。
4. 保存后，在对话的连接器菜单中启用它并测试检索。

这里的 No sign-in 表示不走 OAuth 登录，API Key 仍通过请求头发送。如果没有 Request headers 入口，暂时使用本页其他支持 SSE 和自定义请求头的客户端。适用范围及界面说明见 Claude 自定义连接器文档。

Codex

Codex 官方 MCP 文档列出的远程连接方式是 Streamable HTTP，并支持 Bearer Token 或自定义请求头。本页提供的是 SSE 端点，两种传输不能直接混用。

请先确认所用版本和服务端是否兼容这一 SSE 地址。仅能填写 HTTP URL，不代表已经支持 SSE；如果客户端仅支持 Streamable HTTP，请使用上面支持 SSE 的客户端完成接入。

CC-Switch

CC-Switch可以集中管理 MCP 配置，并同步到所选客户端。

1. 打开 MCP 管理，添加自定义服务器。
2. 传输类型选择 SSE，URL 填写 https://mcp.ai4scholar.net/sse。
3. 添加请求头 Authorization，值为 Bearer YOUR_API_KEY。
4. 选择要同步的兼容客户端，例如 Claude Code 或 Gemini CLI，保存并启用。
5. 回到目标客户端检查连接状态和工具列表。

同步配置后，仍需按目标客户端的步骤完成验证。目标客户端的传输支持不会因配置同步而改变。

验证连接与开始使用

先确认客户端显示服务已连接，工具列表中能看到 Ai4Scholar 的检索工具。再在已启用 MCP 的对话中发送：

使用 Ai4Scholar 搜索 Semantic Scholar 上关于 Transformer 的论文，返回 5 篇，列出标题、作者、年份和来源链接。

出现工具调用记录，并返回论文信息，就说明配置与调用已完成。之后可以继续追问某篇论文的摘要、引用或相关研究；可用能力以当前加载的工具列表为准。

MCP 的学术接口调用按 Ai4Scholar 对应服务规则消耗积分，详见 积分与套餐。客户端的模型订阅或模型 API 费用由相应平台另行计算。

常见问题

提示 401 或 Unauthorized

检查请求头名称是否为 Authorization，值是否为 Bearer 加上完整密钥。确认已替换 YOUR_API_KEY，没有多余引号、空格或换行，且使用的是 Ai4Scholar API Key。必要时在 API Key 管理 中检查密钥状态。

提示连接超时、405 或传输不匹配

先核对完整地址 https://mcp.ai4scholar.net/sse 和 SSE 传输选项，再检查客户端及其运行环境能否访问该地址。如果客户端只支持 Streamable HTTP，请按上面的兼容说明选择可用方式。

已连接，但对话没有调用工具

检查服务器是否启用、当前对话或智能体是否勾选了 Ai4Scholar，以及所选模型和对话模式是否支持工具调用。重新加载工具或新建会话后，用上面的检索示例再试一次。

已经配置过其他 MCP 服务

将新条目合并到现有配置中即可，不要覆盖整个文件。多数示例使用 mcpServers，OpenCode 使用 mcp；相邻条目之间需要英文逗号，最后一项后面不要多写逗号。