Transcend MCP Server
Consent Management
技能简介
Transcend MCP Server — Consent Management(简称 Consent MCP)是由隐私合规平台 Transcend 提供的官方 MCP 服务器,专门面向 AI 编程工具(Claude Code、Cursor 等)暴露同意管理相关的工具接口。它让 AI 代理能够直接查询、修改和审计用户的 Cookie 同意偏好、数据流向、合规 regime 配置,以及批量执行 Cookie 分类与数据流整理。Transcend 本身是企业级隐私合规平台(GDPR/CCPA 等),该 MCP 服务器将这一能力以工具形式直接注入 AI 开发工作流,使代码代理在生成或修改网站代码时能实时参照真实的同意状态与合规要求。
核心能力
- 用户同意偏好查询与修改:通过
consent_get_preferences获取单个用户的同意偏好,通过consent_update_cookies/consent_delete_cookies批量更新 Cookie 同意状态,无需进入管理后台。 - Cookie 与数据流清单管理:枚举网站所有 Cookie(
consent_list_cookies)、追踪数据流向(consent_list_data_flows)以及 Airgap Bundle 配置(consent_list_airgap_bundles),为代码代理提供完整的同意清单视图。 - 自动化 Cookie 分类审查:通过
consent_cookie_triage_review_app启动交互式审查 UI,AI 代理可按策略批准(Junk/Approved)或批量归类 Cookie 与数据流,加速隐私合规的人工审查环节。 - 同意分析数据拉取:
consent_get_aggregate_analytics、consent_get_timeseries_analytics和consent_get_analytics_data分别提供聚合统计、时序趋势和原始信号数据,用于生成合规报告或驱动 AI 决策。 - Bulk 批量操作:
consent_bulk_triage支持一次性对大量 Cookie 和数据流执行批量分类,适合新网站上线或大规模重构后的同意合规兜底。 - 同意记录查询:
consent_list_roc_records提供用户同意记录(Record of Consent)查询,满足 GDPR Article 7 的可举证性要求。 - Prompt 工作流模板:内置
consent-triage、consent-research-tracker、consent-inspect-site三个可被发现式 Prompt,AI 代理可通过 MCP prompts 接口直接调用完整的工作流。
安装与配置
前置要求
- Node.js ≥ 22.12
- Transcend 账户( org admin 权限),用于创建 OAuth 客户端
安装步骤
# 全局安装 CLI
npm install -g @transcend-io/mcp-server-consent
OAuth 客户端配置
- 登录 app.transcend.io/admin/oauth-clients,创建一个 OAuth 客户端。
- 复制 Client ID 和 Client Secret。
- 选择一个本地端口(如 8765),在 OAuth 客户端中注册回调地址为
http://127.0.0.1:8765/callback(注意必须是127.0.0.1而非localhost)。 - 设置环境变量:
export TRANSCEND_OAUTH_CLIENT_ID=your-client-id
export TRANSCEND_OAUTH_CLIENT_SECRET=your-client-secret
export TRANSCEND_OAUTH_REDIRECT_PORT=8765
MCP 客户端配置
{
"mcpServers": {
"transcend-consent": {
"command": "npx",
"args": ["-y", "@transcend-io/mcp-server-consent"],
"env": {
"TRANSCEND_OAUTH_CLIENT_ID": "your-client-id",
"TRANSCEND_OAUTH_CLIENT_SECRET": "your-client-secret",
"TRANSCEND_OAUTH_REDIRECT_PORT": "8765"
}
}
}
}
API Key 备选方案
如不使用 OAuth,可直接设置 TRANSCEND_API_KEY 环境变量(优先级高于 OAuth)。
使用步骤
第一步:启动 MCP 服务器
配置好环境变量后,在终端运行:
transcend-mcp-consent
服务通过 stdio 与 MCP 客户端通信(非交互式终端),Claude Code/Cursor 会自动启动进程。
第二步:查询现有 Cookie 清单
列出网站所有已知的 Cookie
→ consent_list_cookies
AI 代理可据此判断当前代码引入的第三方脚本是否在同意清单中。
第三步:查询用户同意偏好
查询 user_id=abc123 的同意偏好
→ consent_get_preferences(user_id="abc123")
第四步:批量分类与审查
对所有 pending 状态的 Cookie 执行 junk 分类
→ consent_bulk_triage(triageType="cookies", action="junk", filter="pending")
第五步:生成合规分析报告
获取最近 30 天同意趋势数据
→ consent_get_timeseries_analytics(range="30d")
适用场景
- 隐私合规网站开发:在开发涉及用户追踪、Cookie 或第三方脚本的功能时,AI 代理可实时查询 Transcend 同意状态,确保新功能不违反现有同意政策。
- GDPR/CCPA 合规审计:批量导出 Cookie 与数据流清单,结合同意记录用于内部合规报告。
- 第三方脚本引入评估:在 AI 代理决定引入新的分析或营销脚本前,先查询是否已有对应的同意配置,避免引入未授权追踪。
- 网站重构后的同意兜底:大规模前端重构后,快速执行 Bulk triage 将未知 Cookie 标记为 Junk,减少合规盲区。
- 同意管理自动化:将同意管理操作集成到 CI/CD 流程,AI 代理可在发布前检查同意合规性。
适用人群
- 全栈开发工程师:在处理网站追踪、Cookie 或第三方集成时,需要了解同意合规状态的开发者。
- 隐私合规团队:需要快速获取 Cookie 清单、数据流状态和同意报告的合规专员。
- AI 编程工具重度用户:使用 Claude Code/Cursor 等工具进行网页开发,希望 AI 能主动参照真实同意状态的工程师。
- DevSecOps 工程师:将同意合规检查集成到自动化流水线中,确保每次部署都附带合规验证。
工作原理
Transcend Consent MCP 基于标准 Model Context Protocol 实现,通过 stdio 传输协议与 AI 编程工具通信。服务端以 Transcend GraphQL API 为后端,将同意管理操作封装为 MCP 工具:
认证层:支持 OAuth 2.0(Browser-based 授权码流程,首次工具调用时自动打开浏览器完成登录)和 API Key 两种认证模式。OAuth 模式使用 session-only 内存 token,安全性更高。
工具调度层:每个 MCP 工具(如 consent_list_cookies)对应一个 Transcend GraphQL Query/Mutation,通过 MCP 协议暴露给 AI 代理。
Prompts 层:内置三个可被发现的工作流模板,通过 MCP prompts/list 接口注册,AI 代理可主动请求完整工作流指导。
官方链接
- npm 主页:https://www.npmjs.com/package/@transcend-io/mcp-server-consent
- GitHub 仓库:https://github.com/transcend-io/tools(位于
packages/mcp/mcp-server-consent) - Transcend 平台:https://transcend.io
- OAuth 客户端管理:https://app.transcend.io/admin/oauth-clients
评论与建议
登录 后参与评论或提建议