# MCP

两种不同的东西：智能体调用其工具所经过的受治理 MCP 网关，以及让助手读取您工作区的 MCP 服务器。

## 受治理的 MCP 网关

- 一个端点 `POST /api/v1/mcp`，适用于任何标准 MCP 客户端（Streamable HTTP），使用在**智能体 › MCP 工具**中创建、绑定到某一个智能体的密钥。
- 由所有者或管理员维护目录：服务器、Azoth 如何向其认证（凭据加密保存，绝不发送给智能体），以及对每个工具及其可逆性的审核。只有已批准的工具才会公开，定义发生变化的工具会重新进入审核。
- 每次工具调用都要经过智能体的授权和 Azoth Guard；不可逆或涉及资金的调用会等待人工批准。结果会被扫描并标记为不可信。不保留任何参数或结果：调用以代码和一个哈希封存。
- 目前仅支持工具：不提供资源、提示词和采样。除非部署将其开启（`FEATURE_MCP_GATEWAY`），否则网关处于关闭状态。

```
URL      https://www.azothos.ai/api/v1/mcp
Header   Authorization: Bearer az_live_…     # a key bound to one agent (Agents › MCP tools)
```

## Azoth MCP 服务器

- `@azothos/mcp` 是一个无依赖的 MCP 服务器，以 Apache-2.0 许可证开源：它在您的电脑上通过 Node.js 18 或更高版本运行，基于 stdio，并通过 API 密钥读取您的工作区。
- 其工具返回控制台本身的数字：授权以及谁为某项决策负责、生效中的规则、阻止的决策、适用法律、合规覆盖情况、证明状态、支出和足迹，以及支持资源。
- 所有工具都只读取，注释表明会记录内容的工具除外：`azoth_export_dossier`（每次导出都会被锚定、加盖时间戳并封存，与在**证据 › 档案**中导出相同），以及完整配置中的 `azoth_preflight` 和 `azoth_compress`。不提供助手的草稿：草稿需要人员在其页面上确认。

## 安装

该服务器尚未发布：其 npm 包和 Claude Desktop 扩展发布后将在此处提供链接。

## 配置

- `public`（默认）：授权、规则、证明、支出和支持资源，即下列工具。
- `full`，使用 `AZOTH_MCP_PROFILE=full`（扩展中的 **Full profile** 开关）：另外提供优化和 FinOps 工具、需要部署开启的功能所对应的工具，以及保留一个版本的旧工具名称。
- 配置之外的工具不会列出，调用它会被拒绝，并指明提供该工具的配置。

- `azoth_spend` — Spend and budgets by mandate
- `azoth_block_decisions` — Blocked decisions
- `azoth_unmandated_uses` — Unmandated AI uses
- `azoth_mandates_overview` — Mandates overview
- `azoth_accountability` — Who answers for a decision
- `azoth_journal_entry` — Sealed decision
- `azoth_model_choice` — Why this model and region
- `azoth_proof_status` — Proof status
- `azoth_active_rules` — Rules in force
- `azoth_data_flows` — Data flows
- `azoth_applicable_law` — Applicable law
- `azoth_regulatory_changes` — Regulatory changes
- `azoth_compliance_coverage` — Compliance coverage
- `azoth_evidence_summary` — This quarter's evidence
- `azoth_workspace_health` — Workspace health
- `azoth_footprint` — Energy and carbon
- `azoth_support_docs` — Search the documentation
- `azoth_support_changelog` — What changed in Azoth
- `azoth_support_status` — Service status
- `azoth_support_error` — Error code explained
- `azoth_journal_query` — Search the decision journal
- `azoth_evidence_export` — Evidence pack
- `azoth_export_dossier` — Export a verifiable dossier
- `azoth_system_modules` — System modules

## API 密钥

在**设置 › 访问权限**中创建。最好使用个人密钥，赋予只读角色、设置到期时间，并只授予其配置所需的权限范围：

```
public  insights:read journal:read usage:read
full    advisory:read agents:read insights:read journal:read policy:read usage:read
```

公共配置中的大多数工具读取控制台本身的功能：需要 Starter 或更高套餐，并且工作区的助手已开启（**设置 › 组织**）。密钥永远不会收到成员的电子邮件地址。

## 隐私

- 该服务器不会在您的电脑上保存任何内容，也不发送任何遥测数据。
- 每次调用都会将密钥和工具参数发送到 `AZOTH_API_URL`（Azoth 的服务或您自己的部署），不会发送到其他任何地方。该地址必须使用 HTTPS（纯 HTTP 仅限您自己的电脑），并且不会跟随任何重定向。
- 工具返回的内容会交给您的 MCP 客户端及其使用的模型，受该客户端自身隐私政策的约束：标识符、代码、计数、成本以及成员起的名称，绝不包含成员的电子邮件地址。

Azoth 对这些调用保留的内容见其[隐私政策](https://www.azothos.ai/legal/privacy)。

## 远程连接器

此部署未启用远程连接器。
