关于 Audifact
Audifact 为 Agent 提供签名且只追加的决策与结果凭据，面向需要核验 Agent 关键操作的团队。它记录简短事件并生成公开证明链接，而非完整追踪对话。
主要功能
- 01记录决策、结果及外部操作
- 02签名并哈希链式追加记录
- 03生成事件证明链接
- 04支持注册及查询 Agent 记录
- 05写入前自动删减敏感信息
适用场景
- 01审查 Agent 执行的关键操作
- 02核验 Agent 委派子 Agent 的记录
- 03查看决策对应的公开证明链接
MCP 相关
提供托管 MCP 服务，向客户端开放记录决策、记录结果、获取证明及查询 Agent 记录等工具。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://api.audifact.io/mcpclaude mcp add --transport http io-audifact-audifact https://api.audifact.io/mcp{"mcpServers":{"io-audifact-audifact":{"type":"http","url":"https://api.audifact.io/mcp"}}}在 Cursor 中打开{"servers":{"io-audifact-audifact":{"type":"http","url":"https://api.audifact.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"io-audifact-audifact":{"type":"http","url":"https://api.audifact.io/mcp"}}}{"mcpServers":{"io-audifact-audifact":{"serverUrl":"https://api.audifact.io/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://api.audifact.io/mcp需要授权工具
5| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| ts | string | 否 | ISO-8601 时间戳 |
| signature | string | 否 | 客户端签名：对规范 JSON 正文进行 base64 签名。 |
| agent_name | string | 否 | Managed Mode：组织内的 Agent 身份（默认值：default-agent）。Audifact 会自动配置并使用托管签名密钥。 |
| context_json | object | 否 | |
| decision_type | string | 否 | |
| metadata_json | object | 否 | |
| scenario_hash | string | 否 | 高级可选项：已知时可传入 64 位十六进制场景哈希。通常省略——服务器会根据 scenario_name + scenario_definition 计算。 |
| scenario_name | string | 否 | 场景标识符。服务器根据 scenario_name + scenario_definition（+ 可选的 context_schema）解析 scenario_hash。 |
| context_schema | object | 否 | 用于验证 context_json 的可选 JSON 架构。 |
| decision_label | string | 否 | |
| decision_value | string | 否 | |
| agent_public_key | string | 否 | 客户端签名：base64 公钥（与 signature 配套时必填）。 |
| context_schema_json | object | 否 | 向后兼容的 context_schema 别名。 |
| public_context_json | object | 否 | 可选的公开结构化上下文（显示在证明页面上）。以 gzip 压缩存储；事件哈希仅包含内容哈希。 |
| scenario_definition | object | 否 | 场景定义对象。提供 scenario_name 时必填。 |
| public_decision_type | string | 否 | 可选的 decision_type 公开镜像（显示在证明页面上）。 |
| agent_private_key_b64 | string | 否 | 客户端签名：base64 编码的 Ed25519 私钥。提供时会覆盖托管模式。 |
| public_decision_label | string | 否 | 可选的公开决策摘要（显示在证明页面上）。 |
| public_decision_value | string | 否 | 可选的 decision_value 公开镜像（显示在证明页面上）。 |
| scenario_definition_json | object | 否 | scenario_definition 的向后兼容别名。 |
详细介绍
Audifact Agent 插件
你的 Agent 会为其决策保留一份签名回执。
此仓库打包了 Audifact 托管的 MCP 服务（https://api.audifact.io/mcp），以及一项技能：指导 Agent 记录重要决策、外部操作和子 Agent 委派，然后向你提供证明链接（https://audifact.io/e/{event_hash}）。
这是回执，而不是静默的完整追踪。目标是每个活跃日记录约 3–10 个事件。
安装
1. 获取 Audifact API 密钥（所有客户端通用）
- 在 https://audifact.io/signup 创建账户（插件不会创建账户）。
- 前往 Dashboard → API Keys → 创建密钥（
af_...，仅显示一次）。 - 仅将其粘贴到客户端的机密／遮蔽字段中。切勿粘贴到聊天或文件中。
2. 选择客户端
官方 MCP Registry／VS Code／Copilot／其他注册表客户端
在 MCP Registry 中列为 io.audifact/audifact（搜索“audifact”）。从注册表或客户端的 MCP 库中添加远程服务。根据提示提供 X-API-Key。元数据：server.json。
Claude Code（自托管市场 — 无需排队审核）
/plugin marketplace add audifact/audifact-plugin
/plugin install audifact@audifact
将密钥粘贴到 Audifact API key（userConfig，存储在操作系统钥匙串中）。
Grok Bot／Cursor（x.ai 目录）
目录中列出后即可安装。将密钥粘贴到 AUDIFACT_API_KEY。
（仓库已从 grokbot-plugin 重命名为 audifact-plugin；重新提交会替换 2026-10-16 的草稿。）
仅安装 Agent Skills（npx skills add）
npx skills add audifact/audifact-plugin
这会安装技能说明。你仍需在同一客户端中连接 MCP 服务，否则该技能没有可调用的工具。
3. 确认
请 Agent 确认 Audifact 连接。它应记录一条 plugin_connected 决策并返回证明 URL。
⚠️ 仅追加账本
所有记录都会经过签名并进行哈希链接，且无法编辑或删除。技能会在写入前进行脱敏：不包含机密、令牌、密码、完整消息正文或文件内容——仅包含简短摘要。
计费
每个事件都会消耗拥有该 API 密钥的 Audifact 账户中的额度。
隐私
- 默认关闭公开标签。
- 每个 Agent 都使用自己的
agent_name记录（例如grokbot-cos、claude-code）。
工具
log_decision、log_outcome、get_proof、register_agent、list_agent_decisions（已弃用的别名：list_my_recent_decisions）、list_agent_outcomes。
仓库结构
| 路径 | 作用 |
|---|---|
.mcp.json | Grok/Cursor：X-API-Key: ${AUDIFACT_API_KEY} |
.grok-plugin/ | x.ai／Grok Bot 插件清单 |
.claude-plugin/ | Claude Code 市场 + userConfig 密钥（会覆盖 Claude 的 MCP 身份验证） |
skills/audifact/ | Agent Skills SKILL.md |
server.json | 官方 MCP Registry 远程元数据 |
assets/logo.svg | 品牌 AF 字母组合 |
许可证
MIT
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。