使用Cedar策略和Ed25519签名收据来管理AI Agent工具调用的指南。本技能教授如何为MCP服务器编写访问控制策略，在shadow模式下运行以观察结果，以及验证加密审计追踪。

protect-mcp拦截MCP工具调用，对照Cedar策略（与AWS Verified Permissions使用的相同策略引擎）进行评估，并将每个决策签署为Ed25519收据。该收据是一个加密证明，证明特定策略在特定时间针对特定工具调用进行了评估。

Agent → protect-mcp → Cedar策略评估 → MCP服务器
                ↓
        Ed25519签名收据

Cedar是一种专为授权设计的策略语言。策略通过WASM在本地评估——无需网络调用。

// 允许只读文件操作
permit(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name in ["read_file", "list_directory", "search_files"]
};

// 拒绝破坏性操作
forbid(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name in ["execute_command", "delete_file", "write_file"]
  && resource has args
  && resource.args.contains("rm -rf")
};

每个策略决策都会生成一个签名收据：

收据格式遵循IETF Internet-Draft draft-farley-acta-signed-receipts。

# 安装并初始化钩子（Claude Code集成）
npx protect-mcp init-hooks

# 或作为独立MCP网关运行
npx protect-mcp serve

这会在项目根目录创建protect-mcp.config.json和一个入门级Cedar策略。

// 从宽松模式开始——在shadow模式下允许所有操作
permit(
  principal,
  action == Action::"call_tool",
  resource
);

3. 在Shadow模式下运行（先观察）

# Shadow模式是默认模式——记录决策而不阻止
npx protect-mcp --policy policy.cedar -- node your-mcp-server.js

在编写限制性策略之前，审查shadow日志以了解你的Agent在做什么。

一旦你了解了工具调用模式，编写具体策略：

// 允许文件读取，拒绝在src/目录外写入
permit(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name == "read_file"
};

permit(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name == "write_file"
  && resource has args
  && resource.args.path like "src/*"
};

// 拒绝所有其他操作
forbid(
  principal,
  action == Action::"call_tool",
  resource
);

npx protect-mcp --policy policy.cedar --enforce -- node your-mcp-server.js

# 验证单个收据
npx @veritasacta/verify receipt.json --key <public-key-hex>

# 验证审计包（多个收据+密钥）
npx @veritasacta/verify bundle.json --bundle

# 自测试验证器（证明其离线工作）
npx @veritasacta/verify --self-test

退出码：0 = 签名有效（已验证为真实），1 = 签名无效（已验证为篡改），2 = 验证器错误（输入格式错误）。

# 初始化钩子
npx protect-mcp init-hooks

# Claude Code现在为每次工具调用生成签名收据。
# 收据存储在.protect-mcp/receipts/目录下

说明： 初始化后，Claude Code的每次工具调用都会记录签名收据。不会阻止任何工具调用（shadow模式）。

// 仅允许经过批准的工具，并带频率限制
permit(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name in [
    "get_customer",
    "search_orders",
    "list_products"
  ]
};

forbid(
  principal,
  action == Action::"call_tool",
  resource
) when {
  resource.tool_name in [
    "delete_customer",
    "modify_payment",
    "execute_sql"
  ]
};

说明： 一个服务于客户数据的生产MCP服务器。只读操作被允许；破坏性操作被阻止。

# 导出会话的审计包
npx protect-mcp export-bundle --session sess_abc123 --out audit.json

# 验证包中的每个收据
npx @veritasacta/verify audit.json --bundle

# 预期输出：
# ✓ 包：有效
#   总计：    47
#   通过：    47
#   失败：    0

说明： 事件发生后，导出审计包并验证没有收据被篡改。该包包含会话中的所有收据以及验证所需的签名密钥。

问题：收据验证失败，显示no_public_key

症状： npx @veritasacta/verify receipt.json返回退出码2，显示no_public_key

解决方法： 显式提供公钥：--key 。收据默认不嵌入公钥。检查protect-mcp.config.json中颁发者的公钥。

问题：Shadow模式显示意外的拒绝

症状： Shadow日志显示你预期允许的工具出现了deny决策

解决方法： 检查你的Cedar策略顺序。Cedar先评估forbid规则，再评估permit规则——宽泛的forbid会覆盖特定的permit规则。

问题：Enforce模式阻止了合法的工具调用

症状： Agent报告切换到enforce模式后工具调用被拒绝

解决方法： 将工具添加到你的允许策略中，或切换回shadow模式：移除--enforce标志。查看收据的deny_reason字段以了解具体的策略违规。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Protect Mcp Governance 实用指南

MCP工具调用的Agent治理技能——Cedar策略编写、shadow-to-enforce分阶段部署和Ed25519收据验证。

开发工具

安全

人工智能

protect-mcp是MCP工具调用的Agent治理方案，基于Cedar策略和Ed25519签名收据，支持Shadow、Enforce和Hooks三种模式，实现可防篡改的审计追踪和逐步策略部署，提供从初始化、策略编写到收据验证的完整操作指南。

漏洞扫描

安全审计

服务器

AI Agent

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

Protect Mcp Governance 实用指南

Protect Mcp Governance 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐