<!-- 来源: https://hostanagent.com/docs/mcp/quickstart/ | 协议: 1.0 | 更新: 2026-09-30 -->

# 连接 MCP 与授权

HostAnAgent 的远程 MCP 地址是 `https://api.hostanagent.com/mcp`，用于管理自己的 Agent、版本、工具集和执行绑定，并查询平台模型售价。它采用 Streamable HTTP 与 OAuth；不运行 Agent、不读取个人账单、不充值。

## 连接步骤

1. 在支持远程 MCP 与 OAuth 的客户端添加上述地址。
2. 客户端打开 HostAnAgent 的网页登录与授权页面；使用你的账号登录，核对客户端名称和申请的权限。
3. 先授予 `configuration:read` 可读取现状、模型目录、销售价格和验证配置；要创建/更新时再同意 `configuration:write`，并同时保留读取权限。
4. 回到客户端，先执行 `list_agents` 或 `list_models` 确认已连接；需要写入时使用[任务配方](/docs/mcp/recipes/)并回读确认。

资源发现默认申请读取权限。支持权限升级的客户端在写工具收到 `insufficient_scope` 后，会再次打开授权页。`offline_access` 用于轮换刷新令牌；用户仍可在控制台“MCP 接入”页撤销授权。撤销后该客户端同一 `client_id` 的授权立即失效。

网页 Cookie 只用于登录与同意，不是 MCP token。MCP OAuth token 也不能访问 `/v1/runs`；产品运行请用受限[应用 Key 和 SDK](/docs/integration/overview/)。发现与授权端点位于 API 域名，旧主域名 `/mcp` 不能当成可继续使用的入口。

读取价格或配置不会调用模型。创建、修改和发布配置也不预扣余额；真正启动 Run 时另检查余额、模型能力和权限。连接或授权失败，先按[身份与权限](/docs/reference/authentication/)检查地址、scope、账号和撤销状态。
