企业官网建设流程全解析

如何用 MCP 让本地 Hermes Agent 对话式管理 Hermes Cloud 实例（列出、启停、查费用）

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent

Hermes Cloud 托管运行 Hermes Agent 实例，默认你要在 Nous Portal 的/agents页面里管理它们。如果你的本地 Hermes Agent 连上 Portal 的 MCP 服务器，就可以直接在终端里用自然语言完成这些事：“列出我的云实例”“把停掉的那个重启”“这个实例大概花多少钱”，不需要离开终端去点网页。本文覆盖连接、验证和日常使用的完整路径，适用前提是：你已有可访问 Hermes Cloud 的 Nous Portal 账号，且本地机器上装着 Hermes Agent（标准安装脚本已包含 MCP 支持；否则需先补装，见下文）。

准备条件

• 一个 Nous Portal 账号，且能访问 Hermes Cloud（至少有一个实例，或具备创建实例的权限）。
• 本地 Hermes Agent 已装好 MCP 支持。标准安装脚本会自动装好；如果不是，手动补装：

cd ~/.hermes/hermes-agent uv pip install -e ".[mcp]"

不需要额外的 API key 或 client secret：该服务器走 OAuth 2.1（带 PKCE），登录就是一次浏览器跳转，用的就是你 Portal 已有的账号。

第一步：添加 MCP 服务器

hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

--auth oauth告诉 Hermes 这是一个带 OAuth 保护的 HTTP 服务器。首次连接时 Hermes 会自动完成四件事：

1. 自动发现服务器的 OAuth 端点（RFC 9728 / 8414 元数据）；
2. 以客户端身份向服务器注册（RFC 7591 动态客户端注册）——没有 secret 需要你复制；
3. 打开浏览器让你登录 Portal 并授权；
4. 把得到的 token 存到~/.hermes/mcp-tokens/下并复用，过期后自动刷新。

如果你的 Portal 账号属于多个组织，授权时浏览器会弹出一个组织选择器，选这个连接要管理哪个组织即可——选择只在浏览器里做，命令行不用传参；单组织账号会自动绑定，跳过这一步。以后想换绑到另一个组织，删除后重新添加即可：

hermes mcp remove hermes-cloud hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

第二步：验证连接

先在终端验证连接本身：

hermes mcp test hermes-cloud

然后启动（或重载）一个会话，让工具注册进来：

hermes chat

在会话里执行：

/reload-mcp

再问一个只读问题确认工具真的可用：

List my Hermes Cloud agents and their current status.

预期结果是拿回与 Portal/agents页面一致的实例列表。Hermes 会报告每个工具的实际返回值，你可以据此判断操作是否真正落到了云上。

第三步：日常对话式操作

连接完成后，模型可以在你的 Hermes Cloud 组织上调用两组工具：

对应的直接问法示例（实例名research-bot、scratch是文档示例，替换成你自己的名字）：

Which of my cloud agents is currently running, and roughly what is each one costing?

Restart the instance called research-bot.

Create a new Hermes Cloud instance named scratch, then tell me when it's ready.

每次调用都以你的 Portal 身份跑在你的组织上，且每次调用都会重新检查成员资格——这个连接只能碰你本来就能在网页端管理的实例。

可选分支：只读模式

如果只想要“列出、查看”，绝不让它 start/stop/create/destroy，可以把连接限制在agents这一个只读工具上。编辑~/.hermes/config.yaml：

mcp_servers: hermes-cloud: url: "https://portal.nousresearch.com/mcp" auth: oauth tools: include: [agents]

改完配置后在会话里执行/reload-mcp生效。完整的 include/exclude 过滤模型见 Use MCP with Hermes。

配置落点

执行hermes mcp add之后，服务器配置写在~/.hermes/config.yaml：

mcp_servers: hermes-cloud: url: "https://portal.nousresearch.com/mcp" auth: oauth

凭据不进config.yaml——OAuth token 单独存放在~/.hermes/mcp-tokens/下，auth: oauth字段含义等完整字段说明见 MCP Config Reference。

常见问题排查

连接时报 “invalid_client” 或 “unknown client”

说明本地缓存的客户端注册和服务器对不上了（比如你之前连过别的环境）。需要清掉这个服务器的 OAuth 缓存状态再重新添加。下面命令会删除该服务器在~/.hermes/mcp-tokens/下的 token 文件（仅限hermes-cloud这一个服务器的缓存，之后需要重新走一遍浏览器登录）：

hermes mcp remove hermes-cloud rm -f ~/.hermes/mcp-tokens/hermes-cloud.* hermes mcp add --url https://portal.nousresearch.com/mcp --auth oauth hermes-cloud

工具添加后没出现

先在会话里重载并检查：

/reload-mcp

Tell me which MCP-backed tools are available right now.

仍然没有的话，跑hermes mcp test hermes-cloud，它会直接显示连接错误。

被要求重新登录

OAuth token 会自动刷新，但如果 Portal 那边作废了你的会话（改密码、吊销、过期），下一次调用就会要求重新授权。重新执行一遍hermes mcp add命令即可，浏览器流程会重新签发 token。

在 SSH / 无图形界面的远程主机上

OAuth 的浏览器回调监听在 Hermes 所在的那台机器上。远程主机有两种完成方式（详见 OAuth over SSH / Remote Hosts）：

• 交互终端里直接把浏览器重定向后的完整 URL 粘贴回 Hermes 的提示符（无需任何配置）；
• 或者开一条 SSH 本地端口转发ssh -N -L <port>:127.0.0.1:<port> user@remote-host，端口以 Hermes 打印的Waiting for callback on ...行为准。

另外注意：如果在运行中的会话里通过编辑config.yaml添加 OAuth MCP 服务器，CLI 的自动重载只有 30 秒超时，不够完成交互式 OAuth；应改用hermes mcp login <server>单独完成登录，它没有这个限制，最多等 5 分钟。

下一步

• Use MCP with Hermes——MCP 服务器连接与过滤的通用做法；
• MCP 功能总览——MCP 是什么、Hermes 如何使用它；
• Nous Portal——同一个登录背后的订阅、模型与 Tool Gateway。

【免费下载链接】hermes-agentThe agent that grows with you项目地址: https://gitcode.com/GitHub_Trending/he/hermes-agent