# @apono-io/apono-mcp 中文文档

规范地址：https://npmcn.com/package/%40apono-io/apono-mcp/

版本：0\.2\.53
npm 元数据更新时间：2026-11-05T20:21:31.750Z
中文译文更新时间：2026-11-06T11:04:50.146Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40apono-io/apono-mcp
原文对照：https://npmcn.com/package/%40apono-io/apono-mcp/?lang=original
项目主页：https://github.com/apono-io/apono-cli-agentic#readme
源码仓库：https://github.com/apono-io/apono-cli-agentic

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：16.1 kB，5 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2026-03-22T20:21:14.547Z
- 最新版本发布：2026-11-05T20:21:31.603Z
- 近 30 天下载量：6777（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：110（近 12 个月 110 个）

## 中文简介

Claude 代码、 Claude 桌面和光标的 Apono MCP 服务器

## 安装

```sh
npm install @apono-io/apono-mcp
```

也可以使用：`pnpm add @apono-io/apono-mcp`、`yarn add @apono-io/apono-mcp`、`bun add @apono-io/apono-mcp`

## README

# 阿波诺 MCP

AI代理人员及时进入您的基础设施和 SaaS 工具,由 [阿莫诺](https://www.apono.io/)。 。 。 .

`@apono-io/apono-mcp` 运行 Apono Agentic Gateway: 用于克洛德代码, Cursor 和克洛德桌面的本地MCP服务器. 特工问网关需要什么. Apono通过您现有的访问流量授予范围化,有时间限制的访问权限,网关执行您对每个工具调用的信任政策,每个调用都经过审计.

-   **没有长期有效的全权证书.** 特工从来不持有长生不老的秘密. Apono按请求签发证书,并在访问期满时撤销.
-   **每一通电话都要遵守信托政策.** 每个工具呼叫都按意向分类(读取,写出,删除,.),并允许,拒绝,或送人批准.
-   **一个服务器,许多目标.** 数据库,云账户,Kubernetes和SaaS工具 您的 Apono 管理员连接, 全部在 MCP 服务器后方 .

## V0.2.53中的新内容

### 改进

-   **现在每次安装都包含网关内开源代码的许可** - 档案只有网关自己的执照 每个归档和Linux软件包现在都包含一个 `credits.html` 页面,并附有Go本身的完整许可证、通知和专利文本。 npm 软件包将页面保存到 `~/.local/share/apono-agentic/` ,并在安装一个版本时打印其路径.
-   **每一个稳定的发布也作为容器图像发布,它支撑着每个平台的建设** 将网关装入自己应用程序的合作伙伴必须一次收集一个平台。 现在每个稳定发行版本还发布一个容器图像,其中包含macOS、Windows和Linux档案及其校验和 `docker pull`。 Linux 构建的图像可以在桌面应用程序主机内运行.
-   **一个因为呼叫器停止而终止的工具呼叫不再作为网关错误报告** - 一个工具呼叫,其呼叫者停止等待 被记录 与一个工具服务器相同的通用内部错误 已经损坏,所以一个会话的活动无法区分两者。 这种呼吁现在有自己的理由,将一般性错误留给真正的失败.
-   **访问请求现在从访问政策中抽取时间** - 要求获得比保险单允许的更多访问时间的代理人收到错误而不是访问,而且工具表面没有任何东西说明这一限制. `create_access_request` 不再需要时间:访问政策规定了时间,在需要明确时间的情况下,网关要求10分钟,但不得超过政策允许的时间.

### 可靠性

-   **连接工具的调用失败, 现在记录它为什么失败** \- 一个调用网关对一个只记录到它失败的连接工具运行,所以一个停止等待的调用器无法从一个被破解的工具中得知. 每一个失败现在都有其原因,这使得一个反复出现的问题可以识别,而不是隐藏在同一工具的其他失败中.
-   **一个被拒绝的工具呼叫现在记录了为什么被拒绝** - 一个被拒绝的电话记录了哪个工具失败了,但不是原因,所以当问题再次发生时,无法从另一个原因中得知。 每次拒绝现在都有其原因,这使得重复的失败可以识别,而不是与同一工具的所有其他拒绝相去甚远.
-   **失去证书的会话现在从已经刷新过的另一会话恢复过来** - 当一个会话刷新一个被拒绝的证书时,同一个用户的其他会话保留了旧的会话,并且每个电话都失败,直到重新启动为止。 现在有一个会话接回刷新的证书 并重复通话.
-   **无法启动工具服务器的网关不再旋转其它会话中的证书** - 当一个被管理的工具服务器未能启动时,通常因为其命令在机器上缺失,网关将故障视为被否决的证书并进行旋转. 同一用户的其他会话随后失去访问权限,直到重新启动. 当失败发生在工具服务器使用之前时,该网关现在只留下证书.

## 所需资源

-   节点.js 16或以后,用于 `npx`。 。 。 .
-   一个Apono账户。 请您的 Apono 管理员为您提供代理访问权限 .

## 设置

### 1\. 登录到 Apono

```shell
npx -y @apono-io/apono-mcp@latest login
```

此打开您的浏览器可以登录 。 您每次登录一次; 网关会自动刷新会话 .

### 2\. 将网关添加到您的代理中

**克劳德代码**

```shell
claude mcp add apono -- npx -y @apono-io/apono-mcp@latest --agent-type claude-code
```

**光标** (单位:千美元)`~/.cursor/mcp.json`(中文(简体) )

```json
{
  "mcpServers": {
    "apono": {
      "command": "npx",
      "args": ["-y", "@apono-io/apono-mcp@latest", "--agent-type", "cursor"]
    }
  }
}
```

**克劳德桌面** (单位:千美元)`claude_desktop_config.json`(中文(简体) )

```json
{
  "mcpServers": {
    "apono": {
      "command": "npx",
      "args": ["-y", "@apono-io/apono-mcp@latest", "--agent-type", "claude-desktop"]
    }
  }
}
```

更改代理配置后重新启动代理 .

### 3\. 问需要什么

用平话询问代理商,例如"在中转数据库中清空订单表". 代理通过 Apono 找到资源, 请求访问, 并在访问获准后运行呼叫 。 当电话需要批准时,批准人会收到请求,代理商会等待决定.

## 版本数

`@latest` 总是运行 最新的稳定网关。 标出一个版本, 代之以名称, 例如 `@apono-io/apono-mcp@0.2.51`。首先运行软件包,将匹配的网关二进制下载到 `~/.local/bin`,然后运行复用.

## 支助

联系您的 Apono 管理员, 或者联系 Apono 支持 [支持@ apono.io](mailto:support@apono.io)。 。 。 .

## 常见问题

### @apono-io/apono-mcp 是什么？

Claude 代码、 Claude 桌面和光标的 Apono MCP 服务器

### 如何安装 @apono-io/apono-mcp？

在项目目录运行 npm install @apono-io/apono-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 apono-mcp，可以用 npx apono-mcp 直接运行。

### @apono-io/apono-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/apono-io\_\_apono-mcp 是否存在。

### @apono-io/apono-mcp 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=16。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @apono-io/apono-mcp 可以商用吗？

@apono-io/apono-mcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @apono-io/apono-mcp 的下载量有多少？

根据 npm 官方下载统计，@apono-io/apono-mcp 在 2026/10/07 – 2026/11/05 这 30 天内被下载 6,777 次，日均约 226 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @apono-io/apono-mcp 还在维护吗？

最新版本 0\.2\.53 发布于 2026/11/06（2 天前）；至今共发布 110 个版本，其中过去 12 个月发布了 110 个；首次发布于 2026/03/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。