连接 HyperAI MCP

在 Claude Code 或 Cursor 中注册 HyperAI MCP 服务器,登录 HyperAI 账号并验证连接。

本文介绍如何在 Claude Code 和 Cursor 中连接 HyperAI MCP 服务器(https://mcp.hyper.ai)。

前置条件

一个 HyperAI 账号。OAuth 授权流程会在浏览器中通过 HyperAI 账号门户完成登录。
已安装受支持的 MCP 客户端:Claude Code 或 Cursor。

注意

HyperAI 的授权服务暂不支持动态客户端注册(DCR),因此下面的配置需要显式传入预注册的 OAuth 客户端 ID。仅支持 DCR 的客户端(如 Codex CLI 和 ChatGPT 连接器)目前无法完成登录流程。

Claude Code

使用 claude mcp add 命令注册服务器:

claude mcp add --transport http \
  --client-id fpmu80lf8syq0omg7xpww --callback-port 8080 \
  hyperai https://mcp.hyper.ai

默认情况下,该命令只在当前项目中注册服务器。加上 --scope user 可以使其在本机所有项目中可用。

然后启动 claude 并执行 /mcp(或在终端中运行 claude mcp login hyperai),完成浏览器登录和授权确认。状态显示已连接后,HyperAI 工具即可在会话中使用。

如需移除服务器:

claude mcp remove hyperai

回调端口

OAuth 回调地址固定为 http://localhost:8080/callback。如果登录时 8080 端口被其他进程占用,请先释放该端口——回调端口是 OAuth 应用注册信息的一部分,无法在客户端侧修改。

Cursor

Cursor 通过 JSON 文件配置:~/.cursor/mcp.json(全局)或项目内的 .cursor/mcp.json。使用静态 OAuth 客户端添加服务器:

{
  "mcpServers": {
    "hyperai": {
      "url": "https://mcp.hyper.ai",
      "auth": {
        "CLIENT_ID": "fpmu80lf8syq0omg7xpww",
        "scopes": ["mcp:access"]
      }
    }
  }
}

打开 Cursor 的 MCP 设置,按提示在浏览器中完成登录。Cursor 的 OAuth 回调地址固定为 http://localhost:8787/callback。

验证连接

让 AI 助手调用 user_get_profile 工具,例如:

我在 HyperAI 上的账号信息是什么?

调用成功会返回你的 HyperAI 用户名、显示名称、邮箱、会员状态、余额与所属组织。如果能正常返回,说明连接已建立。

只启用部分功能组

如需精简工具列表,可以在注册服务器时通过 features 查询参数指定需要的功能组(user、compute、resources、dataset、org):

claude mcp add --transport http \
  --client-id fpmu80lf8syq0omg7xpww --callback-port 8080 \
  hyperai "https://mcp.hyper.ai/?features=compute,dataset"

同样的 URL 也适用于 Cursor 的 mcp.json。

常见问题

浏览器窗口没有打开——重新执行登录命令(Claude Code 中运行 /mcp,Cursor 中重新打开 MCP 设置中的服务器条目),并确认防火墙没有拦截本地回调端口。
工具用了一段时间后消失——访问令牌已过期,重新执行登录流程刷新会话即可。