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_spendSpend and budgets by mandate
azoth_block_decisionsBlocked decisions
azoth_unmandated_usesUnmandated AI uses
azoth_mandates_overviewMandates overview
azoth_accountabilityWho answers for a decision
azoth_journal_entrySealed decision
azoth_model_choiceWhy this model and region
azoth_proof_statusProof status
azoth_active_rulesRules in force
azoth_data_flowsData flows
azoth_applicable_lawApplicable law
azoth_regulatory_changesRegulatory changes
azoth_compliance_coverageCompliance coverage
azoth_evidence_summaryThis quarter's evidence
azoth_workspace_healthWorkspace health
azoth_footprintEnergy and carbon
azoth_support_docsSearch the documentation
azoth_support_changelogWhat changed in Azoth
azoth_support_statusService status
azoth_support_errorError code explained
azoth_journal_querySearch the decision journal
azoth_evidence_exportEvidence pack
azoth_export_dossierExport a verifiable dossier
azoth_system_modulesSystem 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 对这些调用保留的内容见其隐私政策。
远程连接器
此部署未启用远程连接器。