配置与执行

以 Markdown 格式查看

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

必需的基础 URL

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

权限模式

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

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

VK 模式

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

$ALEPHANT_API_BASE_URL=https://alephant.io
$ALEPHANT_VIRTUAL_KEY=vk-...

VK 模式可以读取：

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

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

Manager 模式

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

$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 服务器运行：

$npx -y @alephantai/mcp

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

CLI 审计模式

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

$npx --yes --package=@alephantai/mcp alephant-mcp --audit

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