免费开始 →

SDK 与 CLI

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 对这些调用保留的内容见其隐私政策。

远程连接器

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