> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# 配置与执行

> 配置 Alephant MCP 凭据、执行模式、限流和审计运行

Alephant MCP 完全通过环境变量配置。服务器会在启动时验证凭据，并在配置无效时退出。

## 必需的基础 URL

| 变量                      | 必需 | 说明                                                    |
| ----------------------- | -- | ----------------------------------------------------- |
| `ALEPHANT_API_BASE_URL` | 是  | SaaS API 基础 URL，例如 `https://alephant.io`。接受并会规范化末尾斜杠。 |

## 权限模式

| 模式            | 必需变量                                     | 权限                   | 工具数量 |
| ------------- | ---------------------------------------- | -------------------- | ---- |
| **虚拟密钥 (VK)** | `ALEPHANT_VIRTUAL_KEY`                   | 单个虚拟密钥的只读 Cockpit 范围 | 8    |
| **Manager**   | `ALEPHANT_PAT` + `ALEPHANT_WORKSPACE_ID` | 全工作区读写访问             | 27   |

只要 `ALEPHANT_PAT` 非空，Manager 模式即优先。如果设置了 `ALEPHANT_PAT` 但未设置 `ALEPHANT_WORKSPACE_ID`，启动会失败。如果既未设置 `ALEPHANT_VIRTUAL_KEY` 也未设置 `ALEPHANT_PAT`，启动会失败。

## VK 模式

对于只应检查一个虚拟密钥的使用量和预算的个人开发者、代理或自动化，请使用 VK 模式。

```bash
ALEPHANT_API_BASE_URL=https://alephant.io
ALEPHANT_VIRTUAL_KEY=vk-...
```

VK 模式可以读取：

* 当前密钥范围
* 当前密钥预算状态
* 最近的按密钥范围请求
* 允许范围内的使用量汇总、每日成本和模型成本

它不能创建密钥、修改预算、查看其他部门或管理工作区策略。

## Manager 模式

对于需要工作区级分析和管理操作的 FinOps 管理员、工作区所有者和团队负责人，请使用 Manager 模式。

```bash
ALEPHANT_API_BASE_URL=https://alephant.io
ALEPHANT_PAT=pat_...
ALEPHANT_WORKSPACE_ID=00000000-0000-0000-0000-000000000000
```

Manager 模式可以：

* 列出、创建、更新和撤销虚拟密钥
* 检查工作区、部门、代理、成员和模型分析
* 检查订阅和预算状态
* 设置工作区预算策略
* 运行复合分析工具，例如异常检测、管理层仪表盘、支出下钻、空闲资源扫描和实体周期比较

仅应在获得用户明确确认后调用 `create_virtual_key`、`update_key_budget`、`revoke_virtual_key` 和 `set_budget_policy` 等写入工具。

## 客户端限流

| 变量                        | 必需 | 默认值  | 说明                                                      |
| ------------------------- | -- | ---- | ------------------------------------------------------- |
| `ALEPHANT_RATE_LIMIT_RPM` | 否  | `60` | 每分钟最多进行的受 HTTP 约束工具调用数。设置为 `0` 可禁用客户端限流。无效或负值会回退为 `60`。 |

此限流仅作用于本地 MCP 服务器进程，独立于任何 API 侧限流。

## 传输

当前 npm 软件包作为**本地 stdio MCP 服务器**运行：

```bash
npx -y @alephantai/mcp
```

每个凭据范围使用一个 MCP 服务器条目。对于多个工作区，请创建多个具有唯一名称且使用不同 `ALEPHANT_PAT` / `ALEPHANT_WORKSPACE_ID` 值的条目。

## CLI 审计模式

`alephant-mcp` 二进制文件还支持一次性审计运行：

```bash
npx --yes --package=@alephantai/mcp alephant-mcp --audit
```

在 VK 模式下，审计会输出计费周期的 Cockpit `scope` 和 `usage-summary`。在 Manager 模式下，审计会输出工作区 id 和工作区概览。