Agentvalet

AgentValet

面向 AI Agent 和 MCP 服务的身份与凭证治理代理。它为每个 Agent 提供独立的加密身份，为每个平台提供范围受限且有效期短的凭证，在关键操作上设置人工审批关卡，并为所有操作留下不可篡改的审计日志。

开放核心。 本仓库包含采用 MIT 许可证的开源客户端部分：MCP 服务、命令行、Claude Desktop 套件和运行时适配器。托管代理运行凭证库、策略引擎和审计存储。代理的可自托管参考实现已列入路线图。

访问 agentvalet.ai。文档见 docs.agentvalet.ai。

快速入门

npx @agentvalet/register

这会为你的 Agent 生成一对 RS256 密钥、注册 Agent 并配置好相关设置。私钥不会离开你的计算机。从此以后，你的 Agent 会为每个请求签署一个短期 JWT，并通过 AgentValet 代理调用各个平台。在控制面板中批准该 Agent，为其授予范围，即可开始使用。

用作 MCP 服务

npx @agentvalet/register 会自动将此代码块写入客户端的 MCP 配置。若要手动配置——在 Claude Desktop、Claude Code、Cursor 或任何兼容 MCP 的客户端中——请添加：

{
  "mcpServers": {
    "agentvalet": {
      "command": "npx",
      "args": ["-y", "@agentvalet/mcp-server"],
      "env": {
        "AGENT_ID": "agt_your_agent_id",
        "OWNER_ID": "your_owner_id",
        "PROXY_URL": "https://api.agentvalet.ai",
        "AGENT_PRIVATE_KEY_PATH": "~/.agentvalet/agent.key"
      }
    }
  }
}

该服务提供七种工具：list_platforms、use_platform、authzen_evaluate、agent_register、agent_status、list_my_pending_actions 和 report_self_diagnostic。私钥从 AGENT_PRIVATE_KEY_PATH 读取，不会离开你的计算机；每次平台调用都会经过代理，并进行范围检查、审计记录，以及针对关键操作的人工审批。

问题：凭证继承

当 AI Agent 使用你的凭证而非自己的凭证运行时，就会发生凭证继承。一旦令牌出现在 .mcp.json 或环境变量中，该项目中的每个 Agent 都会继承该令牌的全部权限。它可以在该令牌涉及的所有平台上执行你能执行的任何操作，而且没有任何记录能说明是哪个 Agent 做了什么。

家门钥匙式 Agent（当前默认方式）	代客钥匙式 Agent（AgentValet）
持有你的真实令牌	持有短期签名令牌，从不接触你的凭证
在令牌涉及的每个平台上拥有完整权限	仅限于你授予的具体操作
配置泄露，所有信息都会泄露	配置泄露，也不会泄露可重复使用的信息
没有记录说明是哪个 Agent 做了什么	每次调用都归属于一个 Agent 身份
撤销意味着要在所有地方轮换令牌	一次撤销，即刻生效，无需轮换

工作原理

Agent (holds its RS256 private key)
    |
    |  signs a 60-second JWT per request
    v
+-------------------------------------------+
|              AgentValet proxy             |
|  1. verify JWT signature                  |
|  2. check scope grant (deny by default)   |
|  3. scan request for leaked secrets       |
|  4. AuthZEN policy evaluation             |
|  5. human approval gate, if required      |
|  6. inject real credential in memory      |---> SaaS platform
|  7. append-only audit log entry           |
+-------------------------------------------+
    |
    v
Dashboard: approve registrations, manage scopes, review the audit log, monitor usage
MCP server: exposes AgentValet as tools for Claude and any MCP-compatible agent

凭证采用信封加密：每个凭证使用唯一的 AES-256 数据密钥，该密钥由存放在 Key Vault HSM 中的主密钥封装；数据密钥仅在调用时于内存中解密，绝不会写入日志。

功能

• 为每个 Agent 提供基于 RS256 的加密身份、SPIFFE 格式的 URI 和 60 秒有效期的签名 JWT
• 默认拒绝的作用域，以及细化到每个 Agent、平台和操作的授权
• 对破坏性操作或涉及财务的作用域实行人工审批，并支持一键魔法链接
• 不可变、仅追加的审计日志，可筛选和导出
• 三次违规即触发断路器，自动暂停行为不当的 Agent
• 原生 MCP 服务，另附一条命令即可使用的 CLI
• 可自托管：由 PostgreSQL 支持，可在自己的基础设施中运行
• 符合标准：SPIFFE、RFC 7591 Dynamic Client Registration、AuthZEN 1.0、IETF AIMS

AgentValet 对比

客观说明。这些工具从相邻领域切入，发展出了强大的 Agent 治理能力。

	AgentValet	Aembit	Akeyless	Infisical Agent Vault
起点	面向 Agent 的身份与治理	工作负载身份	密钥管理	密钥保险库
所在位置	身份层凭据代理	工作负载附近的边缘代理	网络中的网关	网络层转发代理
接入方式	自助接入，不到 5 分钟	以企业销售为主导	以企业销售为主导	自托管或云端
开源情况	开放核心，MIT*	否	否	核心开源
突出优势	符合 AIMS、审批关卡、审计、入门成本低	基于证明的身份	分布式片段加密	网络级拦截

* 此仓库中的客户端部分（MCP 服务、CLI、套件、适配器）采用 MIT 许可。代理目前是一项托管服务，自托管参考实现已列入路线图。

如果你已经在企业规模上运行 Aembit 或 Akeyless，AgentValet 并不打算取代你的身份提供商。如果你是开发者或小团队，希望本周就部署 Agent，那么 AgentValet 就是为你打造的。

路线图与已知限制

我们选择公开开发，因此在这里列出尚待完善之处，而不是让你自行发现。

当前已知限制

• 等待时间较长时，用于审批状态的 SSE 流可能会提前关闭。计划加入重连逻辑。
• CLI 的速率限制功能较为基础。
• 目前没有用于清除或删除已过期待处理注册的界面。

路线图

• 代理的自托管参考实现（开放的客户端部分现已可在任何环境中运行）
• 审计日志的 SIEM 导出（企业版）
• 多区域自托管指南
• 自定义集成界面（目前需通过路线图系统提出请求）
• PII 处理第二阶段：在代理层检测

开源部分与托管服务

此仓库中采用 MIT 许可的开源内容：MCP 服务、@agentvalet/register CLI、Claude Desktop 套件、运行时适配器和 @agentvalet/mcp-broker。

这两个 MCP 软件包功能互为镜像：@agentvalet/mcp-server 允许 Agent 通过 AgentValet 代理调用平台；而 @agentvalet/mcp-broker 允许你将 AgentValet 策略和凭据强制执行机制嵌入自己的 MCP 服务，并提供真正实用的本地模式，无需注册账户。

当前的托管服务：用于保存凭据保险库、运行策略引擎和写入审计日志的代理。代理的自托管参考实现已列入路线图。有关开源软件包的本地开发，请参阅 CONTRIBUTING.md。

安全

发现漏洞？请参阅 SECURITY.md，并私下报告。请勿公开提交安全问题。

许可证

MIT。请参阅 LICENSE。