@fidacy/mcp

中文文档
0.24.13发布于 2026/11/04Apache-2.0TypeScriptES Module近 30 天下载 5651

AI特工防火墙。 在采取相应行动之前执行签字授权,并保护执行边界的敏感数据。 需要免费 API 密钥 .

中文使用文档
文档目录22 节
  1. 给所有安装Fidacy的人
  2. 10秒内见效(没有账户,没有代理)
  3. 快速启动: Codex 和 Claude 代码
  4. 管理连接边界
  5. 高级:一般工作空间密钥和地方评价
  6. 为什么
  7. 执行模式
  8. 一个安装,两个后端
  9. 工具
  10. assess_action
  11. 安装
  12. Codex 桌面、 CLI 和 IDE
  13. 克劳德代码
  14. Claude 桌面 ( claude_desktop_config.json (中文(简体) )
  15. 赫尔墨斯 config.yaml (中文(简体) )
  16. 打开Claw
  17. 卸载
  18. 连接您的免费账户
  19. 安全锁
  20. 连接真核(生产)
  21. 遥测
  22. 德维

@fidacy/ mcp (英语)

是你负责你的人工智能探员 但它不知道你的极限。 授权, 否认,释放和记录。 保持冷静.

滴入的 MCP 服务器,用于检查相应的动作 加密签署的任务规定 在此之前 他们运行,然后签署是和 没有 随之而来的是钱离开,数据离开,记录被删除, 正在阅读证书。 非监禁:信仰授权和证明,从未 持有资金.

你的助手没有被保护。 得到你的自由API键现在. 安装 软件包不激活保护。 在 app.fidacy.com/签名设置 FIDACY_ENGINE_API_KEY 代理运行和连接拥有的执行器 下游的证书。 随之而来的行动在此之前一直被阻断.

4个产品来自这个决定:

权力确切地说,这个代理人可以做什么,多久,多少.
证据向审计师、保险公司或反对律师证明它做了什么.
开支警卫经纪人不能筹到的上限.
保证显示策略越来越好,使用数字而不是形容词.

MCP服务器连接了MCP相容的代理. 执法是代理人不可知的 因为它生活在执行边界: 保留条纹、 CMM、 电子邮件、 文件或 fidacy连接器内的基础设施证书 需要准确的签名, 副作用前的单用途补助金。 本地主机适配器可以附加 闸口本地工具。 单是平地MCP连接从未被描述为硬门.

npm license 工作单位: 克洛德代码 克洛德桌面 OpenClaw Hermes Brex CrabTrap 互联网电影数据库(IMDb)上"克洛德桌面"的资料(英文)

你的经纪人可能正在付钱给骗子. 快速注入错误 收款人,一个膨胀的金额,或者同一个发票两次, 你的日志不是 证据。 Fidacy挡住它了 在此之前 金钱移动,手拿回来一个签名的判决 任何人都可以核实 对公用钥匙。 你不必相信我们 你检查 自己签名.

给所有安装Fidacy的人

你是一个 588个装置在他们之间,防火墙已经打开 4 069个 动作, (中文(简体) ), 89%的区块,以引擎和公众在 api.fidacy.com/v1/pulse (英语) 如果你想检查 数字你自己。 谢谢你参与其中 有两件事值得你花一分钟 时间 :

  1. 看见并宣称你的安装被封锁. 你的安装带有一个私人, 在你的机器上匿名的id(除非你选择,否则我们永远不会知道你是谁). 运行 :

    grep anon_id ~/.fidacy/config.json
    

    然后打开 https://fidacy.com/claim?ref=<that id>。一击就将您的本地 历史进入自由账户:服务器签名的判决 比特币-安克雷德审计, 没有你的机器留下它.

  2. 创始合伙人,5个座位. 证据层全年10 800美元 而不是一万八千元 由创始人输入你的堆栈 30天的全额退款: fidacy.com/ 合作伙伴

卢卡斯·德·利马,创始人

10秒内见效(没有账户,没有代理)

指着任何文件:

npx -y @fidacy/mcp anchor contract.pdf

文件被散列在您的机器上, 并且从未上传 。 回来的是 任何人可以打开一个公共链接 检查文件与 记录,没有帐户,也没有问我们。 更改一字节和散列 停止匹配 .

用于一个人以后可能争议的任何事项:合同、发票、 要求,处方,你的经纪人写的报告.

快速启动: Codex 和 Claude 代码

打开 快速启动/ 连接选择 主机,请命名连接并选择允许的动作。 仪表盘创建 一个特工,一个30天的启动任务和一个与两者相关的有限密钥.

运行显示的命令, 然后在提示时粘贴连接密钥 :

npx -y @fidacy/[email protected] connect --host codex
# For Claude Code, use --host claude-code instead.

重新启动选中的主机 。 在代码CLI中,打开 /hooks,检查和批准 信仰的定义。 Codex 跳过新的或已更改的钩子直到信任. 别 绕过此审查。 以可支配数据测试一项被拒绝和允许的行动. 没有身份证明 JWK或 cnf 需要复制此无记名键连接 。 每个主机都有自己的 选中的连接 。 一般工作空间密钥不同且没有约束 给个人特工.

本地钩子申请为关联下确认的行动签名的补助金 任务和组织政策。 过期、拒绝或无法核实的授权 未关闭 。 启动任务可采取多达1 000起行动,但不 限制选定行动类别内的资源。 原主机拦截 必须在您的环境中进行验证; MCP 安装本身不是保护 任意代码或每个工具。 限制性连接密钥不提供 一般评估、账户管理或遗留的遥测API访问.

管理连接边界

政策变更属于仪表板上授权的管理员. 聊天协议 不得推翻拒绝。 当地 protect 向导拒绝管理配置文件 . 丢失、 无效或不匹配的安装连接配置失败 . 被管理的钩子使用Fidacy生产授权端点,而不是本地的URL覆盖. 地方限制仍可拒绝采取额外行动;取消限制并不准许 由服务器方授权。 警告不会产生批准请求.

此放出不是终点隔离. 控制主机的操作员可以 关闭它的钩子。 对于雇员的部署,管理人员必须分开 控制主机配置,证书,网络访问和下游执行器. 一般工作空间钥匙和地方遗留评价没有管理部署.

高级:一般工作空间密钥和地方评价

第一步 免费的 API 密钥 时间 app.fidacy.com/签名 (免费等级,无卡). 这个 密钥激活账户所有权限边界、服务器签名的判决和 比特币 - 安乔德证明.

第2步 复制 API 密钥,然后运行一个命令:

npx -y @fidacy/mcp connect --evaluation

安装者从剪贴板上读取密钥而不打印、校验 账户,检测已安装的代理主机,并给 MCP 服务器供电。 这个 自动配置 Claude, Cursor, Windsurf, VS 代码, Codex 和双子座. 当本地大门可用时,也证明一次性删除 执行前被封锁。 否则它会报告主机没有连接 谎称其本地工具被封门.

对于应用程序拥有或自定义代理运行时间,使用现有的公用SDK. 它使用相同的账户 API 密钥,并且已经曝光评估, Action 当局授权、一次性赠款决定、决策资料和事故包:

import { Fidacy, hashActionContext } from "@fidacy/sdk";

const fidacy = new Fidacy({
  apiKey: process.env.FIDACY_ENGINE_API_KEY,
});

const contextHash = await hashActionContext(localRequest);
const decision = await fidacy.actionMandates.decide(mandateId, {
  action: "stripe.refund.create",
  resource: "stripe:payment_intent:pi_123",
  contextHash,
});

if (!decision.grant) throw new Error("Action refused");
// Give the grant only to the connector that owns the downstream credential.

如果代理人保留原始证书或进入受保护系统的另一种路径, 这条路是外部覆盖。 代理不可知论并不意味着绕行不可知论.

MCP防火墙的本地决定 运行在您的机器上, 离线和拒绝默认。 添加信任的收款人+ 盖入 ~/.fidacy/config.json核实任何针对公众的判决 键在 /.well-known/jwks.json。 。 。 .

还没有钥匙吗? 你的人工智能特工没有保护 恋情拒绝 后果 动作与 activation_required 而不产生权威的判决 赠款。 拿到免费的密钥, 设定 FIDACY_ENGINE_API_KEY 并连接受保护的 重试前执行器 。 仍然持有原始证书的特工有一条路 在信仰之外,没有得到充分的保护.

为什么

毒剂可以产生幻觉 或被迅速注入付款: 错误的收款人, 金额错误,伪造的发票。 快速的护卫设施是概率高的 可绕行. Fidacy是介于特工意图和 执行器: 动作在到达时即已失效, 除非它能对签名进行验证 每项决定都处于不可改变的散列式审计线索中.

执行模式

  1. 登记册 @fidacy/mcp 作为经纪人的 仅限 可支付工具。 别 向代理商提供原始支付工具。 工具盘点是运行时间防火墙.
  2. 经纪人打电话来 request_payment. 联系任务检查 (付费人许可列表,每tx上限,总上限,货币,时间窗口,撤销).
  3. ALLOW 返回一个短暂的 Ed25519 赠款. DENY不归还赠款和 违反规则 下游执行官MUST需要补助,所以被拒绝 行动不能继续.
  4. 每项决定都附在散列记录后. get_audit_proof 返回时 便携式、可核查的证据.

一个安装,两个后端

@fidacy/mcp 单一安装的两个辅助能力:

  • 判决层(决定和标志)数字 : assess_action 打电话叫Fidacy引擎 返回 a 签名信任判决。它不移动钱;它返回判断 其证明:riskPayloadJws + 键 signingKeyId任何人通过下列途径均可核查: @fidacy/verify 对引擎 JWKS在 /.well-known/jwks.json。 。 。 .
  • 支付防火墙(执行)数字 : request_payment 编号 : verify_mandate 编号 : get_audit_proof 并证明通过 核心,返回寿命短的Ed25519赠款.

心理模式: assess_action - > (中文) 引擎 (签署判决); request_payment 和朋友 - > 核心项目 (支付防火墙).

工具

工具后端目的
assess_action引擎在代理代理代表某人行事之前,签署一项拟议诉讼的Fidacy信托判决。 什么都没有.
request_payment核心项目授权付款行动。 ALLOW + 赠款,或 DENY + 规则.
verify_mandate核心项目读取授权信封+Fidacy公钥.
get_audit_proof核心项目链条上的证据 以决定ID.
anchor_artifact引擎任何文件(合同、发票、处方、索赔、图像、音频、视频、谈话)的比特币保证完整性证明。 当地出土;只有SHA-256叶. 返回一张签名的收据.
check_artifact引擎检查一个文件( 或散列) 是否被锁定, 以及它的 Bitcoin 检查站状态 。 一个不匹配是篡改信号.
upgrade无开始将本地安装升级为真实的Fidacy账户; 保存和迁移匿名使用 .

assess_action

从实时引擎中返回已签名的 Fidacy 信任裁决 行动。 签名的证明是 riskPayloadJws + 键 signingKeyId,可核查 任何人通过 @fidacy/verify 反对 {engineUrl}/.well-known/jwks.json。 。 。 .

输入 :

  • kind (可选,默认) ap2_payment: 一个 ap2_payment, (中文(简体) ), message_send, (中文(简体) ), voice_call, (中文(简体) ), custom, (中文(简体) ), claim_document。 。 。 .
  • mandate (必需):此动作/任务对象 kind。 。 。 .
  • mandateType, (中文(简体) ), spendingMandate, (中文(简体) ), idempotencyKey, (中文(简体) ), a2a.task_id (可选).

环境:

瓦尔默认目的
FIDACY_ENGINE_URLhttps://api.fidacy.comFidacy引擎的基础 URL.
FIDACY_ENGINE_API_KEY(无)一个 fky_live_ 编号 : fky_test_ 带有范围的密钥 assess:write。 。 。 .

服务器靴子没有 FIDACY_ENGINE_API_KEY;工具总是被注册. 仅 电话 assess_action 没有密钥返回一个有用的错误告诉 你来设定它。 密钥从未被记录、回放或附在任何错误上.

安装

npm install -g @fidacy/mcp   # or run via npx, no install

Codex 桌面、 CLI 和 IDE

npx -y @fidacy/mcp install --write

注册 MCP 服务器并合并本地 PreToolUse 钩入 ~/.codex/hooks.json编码显示 Fidacy is checking authority 时 门运行。 拒绝执行的行动在处决前被停止,并出现在 特工作为联邦安全警报 保护结果、理由和证据 状态。 已存在的钩子被保存并备份了上个文件.

Codex要求操作者审查并信任一个新的钩子. 重新启动编码和 打开 /hooks 如果信任提示在等待。 桌面应用程序、 CLI 和 IDE 使用 相同的代码配置.

克劳德代码

claude mcp add fidacy -- npx -y @fidacy/mcp

然后运行 npx -y @fidacy/mcp install-hooks 以启用相同的可见 用于支持 Claude 代码工具调用的预执行体验.

Claude 桌面 (claude_desktop_config.json(中文(简体) )

{
  "mcpServers": {
    "fidacy": { "command": "npx", "args": ["-y", "@fidacy/mcp"] }
  }
}

赫尔墨斯config.yaml(中文(简体) )

mcp_servers:
  fidacy:
    command: npx
    args: ["-y", "@fidacy/mcp"]

打开Claw

通过工具面板或 mcpServers 块 情报员 任何MCP相容的主机使用相同的命令.

卸载

安装会写入一个 MCP 服务器条目, 并使用 install-hooks页:1 PreToolUse (单位:千美元) SessionEnd 钩. 钩子挂了 每个项目中的每个工具调用, (中文(简体) ), 不仅是利用菲达西的人, 所以移除他们就是阻止大门.

东道主文件删除
克劳德代码~/.claude.json页:1 fidacy 条目 mcpServers
克劳德代码~/.claude/settings.json命令提到的钩子条目 fidacy
克劳德桌面~/Library/Application Support/Claude/claude_desktop_config.json页:1 fidacy 条目 mcpServers
光标~/.cursor/mcp.json页:1 fidacy 条目 mcpServers
风起浪起~/.codeium/windsurf/mcp_config.json页:1 fidacy 条目 mcpServers
代码~/.codex/config.toml页:1 [mcp_servers.fidacy] 块
代码~/.codex/hooks.json命令提到的钩子条目 fidacy

安装器所触碰的每个文件都有一个 .fidacy-backup 拷贝在它旁边 持有 添加 Fidacy 之前的配置 。 当一个会话被读取 启动, 因此编辑后重新启动主机 .

然后去掉本地证书和审计线索, 以及软件包本身:

rm -rf ~/.fidacy          # account key + local audit trail; export first if you need it
npm uninstall -g @fidacy/mcp

删除安装时 没有 取消您的 API 密钥或活动作 任务。 在权威构建器的设置和任务中撤销密钥并导出 关闭账户前要保存的任何事件包。 签名收据 没有API的钥匙,没有我们,对公众的JWKS进行核查.

完全离线引导, 顺序 : https://fidacy.com/docs/uninstall (中文(简体) )

连接您的免费账户

最后一个步骤 npx -y @fidacy/mcp install --write 连接此选项 机器到一个免费的 Fidacy 账户 :

[fidacy] Connect this machine to your free Fidacy account.
[fidacy]   Your code: BCDF-GHJK
[fidacy]   Press Enter to open https://app.fidacy.com/connect?code=BCDF-GHJK

按 Enter 键,签名或签名,检查控制台是否显示相同的代码,以及 点击连接。 终端接收它的钥匙,储存在 ~/.fidacy/config.json 使用0600模式,并连接您的主机。 按 S 键跳过 . 随时用:

npx -y @fidacy/mcp login

只有公司的所有人或管理人员才能批准一台机器。 代码过期 10分钟后就把钥匙拿出来一次 没有终端安装 从不等待按键; 使用 npx -y @fidacy/mcp connect --key-stdin 带有 键取自控制台.

安全锁

安全事故后,比如另一个装置接管了这个 机器,Fidacy可以锁机器或代理机. 当它被锁上,钩子 并且告诉特工为什么. 引擎也拒绝同一代理的钥匙,所以一个副本也被锁上.

一个人以两种方式解锁它:

npx @fidacy/mcp unlock XXXX-XXXX-XXXX-XXXX

单是机器上的 API 密钥就永远解锁不开它 密码一次就起作用了 使用时会发送所有者电子邮件。 整个组织的锁解除了 只有在控制台上。 任何机器上都有密码.

连接真核(生产)

MCP 层通过一个接口对您的核心说话( MCP )FidacyCore) (中文(简体) ).  仓库保持隐私。 设定 FIDACY_MODE=http 并执行三个终点:

  • POST /v1/mandate/get - > (中文) Mandate
  • POST /v1/decide - > (中文) Decision (运行您的 Ed25519/AP2 校验+审计附件)
  • POST /v1/audit/proof - > (中文) AuditProof

无需修改MCP层.

遥测

安装发射 选择退出 使用遥测方法来测量领养 (安置,主动代理,宿主家庭,裁判计数,拒绝率). 没错 所以它永远无法阻挡或阻止 慢判决.

  • 它只携带随机安装ID和计数器(安装时间,包) 版本,主机家族,决定计数). 这个 永远 包括付款 内容、命令、文件路径或信件文本:没有收款人、金额、发票或 授权永远离开你的机器。 有效载荷类型被一个 严格的计划.
  • IP 和国家: 当 Fidacy 引擎运行时 FIDACY_INSTALL_TELEMETRY=1 (默认关闭),它也会存储每个报告来自和来自的IP地址 因此报告不是匿名的。 恋情 使用此选项可联系使用连接器的团队; 见 https://fidacy.com/privacy (英语)。 。 。 .
  • 如果您连接账户, 账户名称、 拥有者电子邮件和机器 命名您的钩状报告与 Fidacy 管理控制台中的安装连接 . 设定 FIDACY_DISABLE_IDENTITY=1 以保持机器名称从它.
  • 完全关闭遥测 FIDACY_DISABLE_TELEMETRY=1 (或 true) (中文(简体) ). 没有发送,所以也没有IP或国家的记录.

与产品一致:你不必相信我们,你可以核实. 这个 防火墙运行时完全禁用遥测.

德维

npm install
npm run build
npm start      # stdio server, in-memory demo mandate

版本与发布记录

@fidacy/mcp 共发布 114 个版本,首次发布于 2026/06/27;过去 12 个月发布了 114 个版本。

版本发布日期距今
0.24.13latest2026/11/0410 天前
0.24.122026/11/0411 天前
0.24.112026/11/0212 天前
0.24.102026/11/0212 天前
0.24.92026/10/3015 天前
0.24.82026/10/2817 天前

其他发布通道:hermes-preview → 0.21.9。

关于 @fidacy/mcp 的常见问题

@fidacy/mcp 是什么?

AI特工防火墙。 在采取相应行动之前执行签字授权,并保护执行边界的敏感数据。 需要免费 API 密钥 .

如何安装 @fidacy/mcp?

在项目目录运行 npm install @fidacy/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp、fidacy-mcp、fidacy-hook、fidacy-hermes-hook,可以用 npx mcp 直接运行。

@fidacy/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@fidacy/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@fidacy/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@fidacy/mcp 可以商用吗?

@fidacy/mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@fidacy/mcp 的下载量有多少?

根据 npm 官方下载统计,@fidacy/mcp 在 2026/10/15 – 2026/11/13 这 30 天内被下载 5,651 次,日均约 188 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fidacy/mcp 还在维护吗?

最新版本 0.24.13 发布于 2026/11/04(10 天前);至今共发布 114 个版本,其中过去 12 个月发布了 114 个;首次发布于 2026/06/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。