CookieYes

官方

无需离开你的 AI 助手即可管理 Cookie 同意与合规。GDPR 和 CCPA 等隐私法要求网站在使用 Cookie 前获得访客同意。CookieYes 是为 150 万+ 网站处理此事的同意管理平台（CMP）。此 MCP 服务器将其置于你的聊天之中。检查你的 Cookie 横幅是否已上线。运行 Cookie 扫描以发现你网站上的每个 Cookie 和跟踪器。查看你的 GDPR 和 CCPA 合规设置。数秒内更新你的 Cookie 横幅。CookieYes 支持 GDPR、CCPA/CPRA、美国各州隐私法和 Google Consent Mode v2，对欧洲法律采用选择加入同意，对美国法律采用选择退出并附带“Do Not Sell or Share”。专为确认合规的隐私和法律团队、检查客户网站的营销人员以及管理 Cookie 横幅的开发者而构建。该 MCP 服务器以纯对话方式涵盖同意管理、Cookie 扫描和合规检查。

访问 cookieyes.com

你可以用 CookieYes MCP 做什么？

检查横幅状态 — 询问你的 Cookie 横幅是否在某个域名上已上线并处于活动状态，并列出你各站点上的横幅。
获取安装代码 — 获取某个域名的 JavaScript 嵌入代码，以便安装或验证横幅。
更新横幅外观 — 更改横幅的颜色、主题、布局和位置，以匹配你网站的设计。
运行 Cookie 扫描 — 触发一次新的 Cookie 扫描，并按类别查看检测到的 Cookie 和第三方跟踪器。
审查合规设置 — 检查某个域名启用了哪些隐私法规和地理定位设置。
列出域名 — 查看你账户中的所有网站，并找出哪些网站的横幅处于非活动状态。

托管 MCP 服务器

npx add-mcp 'https://app.cookieyes.com/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

CookieYes MCP 服务器

如需查看完整站点索引，请参阅 llms.txt。每个页面也提供 Markdown 版本：将末尾斜杠替换为 .md（/pricing/ 变为 /pricing.md），或向页面 URL 本身发送 Accept: text/markdown。

将你的 AI 助手或 IDE（Claude、ChatGPT、Cursor、VS Code 等）连接到 CookieYes，用自然语言管理 Cookie 同意与合规。

分类： 功能文档、集成文档 最后更新： 2026 年 9 月 9 日 URL： https://www.cookieyes.com/documentation/mcp-server/

概述

模型上下文协议（MCP）是一项开放标准，允许任何 AI 助手通过一组共享工具与外部服务通信。CookieYes MCP 服务器是我们的托管服务器：你的 AI 客户端（Claude、ChatGPT、Cursor、VS Code 等）通过 HTTP 连接，服务器会将你的请求转发到你的 CookieYes 账户。

cookieyes mcp request flow

使用 CookieYes MCP 可以做什么？

监控：检查横幅状态、验证配置，并获取你各域名下的横幅列表。
实施：获取并验证任意域名的横幅嵌入代码。
自定义：更新横幅颜色、位置和布局，以匹配你网站的设计。
扫描：触发 Cookie 扫描、检测正在使用的 Cookie，并查看扫描结果。
管理：列出你账户中的所有域名，并执行针对特定域名的操作。有关这些操作背后的完整工具集，请参阅下方的工具部分。

开始之前

开始前请确保你已具备以下条件：

MCP 端点： https://app.cookieyes.com/mcp
CookieYes 账户：如果没有，请注册。
已启用 MCP 访问： 账户所有者必须开启 Enable OAuth-based access 开关，才能将账户连接到 AI 客户端。
受支持的客户端： 任意 AI 助手或 IDE。

连接到 CookieYes MCP 服务器

按照以下步骤将你的 AI 工具连接到 CookieYes 账户。这包括身份验证、权限授权和连接确认。在下方选择你的客户端，并按照该客户端的特定步骤添加 CookieYes MCP 服务器。

Claude Code

打开你的 Claude Code 终端界面。
使用 HTTP 传输添加服务器：

claude mcp add --transport http cookieyes https://app.cookieyes.com/mcp

如果出现 This command requires approval. Do you want to proceed? 提示，请输入 y 并按 Enter。
在新终端中运行以下命令以启动登录流程：

! claude mcp login cookieyes

Codex

打开 MCP 服务器设置面板，在 Servers 部分点击 + Add server。
在 Connect to a custom MCP 窗口中，将协议从 STDIO 切换为 Streamable HTTP。
在 URL 字段中输入

https://app.cookieyes.com/mcp

在 Name 字段中指定一个名称（例如 cookieyes-mcp），然后点击 Save。
点击 Authenticate。

Cursor

打开 Settings（Ctrl+、/ Cmd+、）。
转到 Tools & Integrations > MCP Tools。
点击 Add Custom MCP（或 New MCP Server）。
将以下内容添加到 mcp.json：

{
  "mcpServers": {
    "cookieyes-mcp": {
      "url": "https://app.cookieyes.com/mcp"
    }
  }
}

注意： Cursor 在 Agent 模式 下调用 MCP 工具。使用模型选择器旁的下拉菜单切换到 Agent 模式

Claude / Claude Desktop

从个人资料菜单中，选择 Settings。
在 Customize 下，选择 Connectors。
点击 Browse，然后搜索 CookieYes。
从结果中选择 CookieYes，然后点击 Connect to Claude。

注意：如果 Connectors 页面上未显示 Browse，请点击 Add 并从下拉菜单中选择 **Browse connectors **

ChatGPT

你可以从 Settings 或侧边栏安装 CookieYes。 从 Settings 安装

从个人资料菜单中，选择 Settings。
选择 Plugins。
点击 Browse plugins。
搜索 CookieYes 并从结果中选择它。
点击 Install plugin。 从侧边栏安装
在侧边栏中选择 Plugins。
在搜索栏中搜索 CookieYes 并从结果中选择它。
点击 Install plugin。

注意：你也可以从任意聊天中安装 CookieYes。点击 + （Add）图标，搜索 CookieYes ，从结果中选择 CookieYes，然后点击 Install plugin 。

Cloudflare AI Playground

打开 Cloudflare AI Playground 仪表板右侧的 Run settings 面板。
在 MCP Servers 部分，点击 + Add。
在输入框中，输入服务器 URL：https://app.cookieyes.com/mcp
点击服务器 URL 字段旁的保存图标。
点击 Authenticating… 按钮。

GitHub Copilot CLI

在终端中输入 /mcp add 并按 Enter 打开配置向导。
在配置向导中：
Name：提供一个唯一标识符作为服务器名称。
Server Type：使用方向键选择 3. SSE（Server-Sent Events）。
URL：粘贴 https://app.cookieyes.com/mcp
其余可选字段保留默认值，然后按 Enter 提交。
按 Enter 开始身份验证。

opencode

在项目根目录创建 opencode.json，并写入 MCP 服务器配置：

{
  "mcp": {
    "cookieyes": {
      "type": "remote",
      "url": "https://app.cookieyes.com/mcp"
    }
  }
}

运行 OAuth 身份验证以连接服务器：opencode mcp auth cookieyes

Visual Studio Code (VS Code)

打开命令面板（Ctrl+Shift+P / Cmd+Shift+P）。
运行 MCP: Add Server。
选择 HTTP/Remote Server。
粘贴你的 MCP URL：https://app.cookieyes.com/mcp 如果你通过直接编辑 mcp.json 来配置 VS Code，请使用以下格式：

{
  "servers": {
    "cookieyes": {
      "type": "http",
      "url": "https://app.cookieyes.com/mcp"
    }
  }
}

Windsurf

打开命令面板，搜索 Cascade MCP Registry，然后选择 Devin: Cascade MCP Registry。
点击 Edit 配置以打开 mcp_config.json。
在你的 mcp_config.json 中，粘贴你的服务器配置：

{
  "mcpServers": {
    "cookieyes-mcp": {
      "url": "https://app.cookieyes.com/mcp"
    }
  }
}

保存文件。市场会刷新，并在 Installed 下列出你的服务器，状态为 Connect（或 Error）。
点击 cookieyes-mcp 旁的 Connect，然后在弹出的模态窗口中点击 Open。

Zed Editor

在 Zed 中打开你的项目。
在 agent 聊天侧边栏中，点击顶部标题栏中的齿轮或插头图标，打开 MCP 配置下拉菜单。
选择 Add Custom Server。
将配置选项卡从 Local 切换为 Remote。
在配置编辑器中，将 some-remote-server 键改为 cookieyes，并将 url 的值设为 https://app.cookieyes.com/mcp。
从定义中移除可选的 auth 和 headers 对象。
点击右下角的 Add Server。
点击 Authenticate。

启动连接后，你将被重定向到 CookieYes 身份验证流程（所有客户端均相同）。登录或注册，查看权限，然后点击 Allow。当你看到 Your CookieYes account is now connected 后，返回你的客户端。

权限与访问

CookieYes MCP 服务器使用 OAuth 2.1 with PKCE 将你的客户端连接到 CookieYes 账户。连接时，CookieYes 会向你的客户端签发一个安全的、限定范围的访问令牌，用于所有工具调用。你的 CookieYes 密码以及个人信息（PII）、同意日志和 Cookie 值等敏感数据绝不会被共享。

管理 MCP 客户端会话

要检查你的账户是否已启用 MCP 访问，请点击个人资料菜单并转到Organisations & Sites。如果已启用 MCP，页面上会显示 MCP enabled 徽章。任何用户都可以查看此状态，但只有账户所有者可以更改它（请参阅下方的管理 MCP 访问）。

管理 MCP 访问

账户所有者通过个人资料菜单 > MCP access 下的 Enable OAuth-based access 开关控制整个账户的 MCP 访问。开启后允许 AI 客户端连接；关闭后则限制访问。你也可以随时从任一侧撤销 AI 客户端的访问权限： 从 CookieYes： 打开个人资料菜单 > MCP access，在 Connectors 列表中找到该客户端，点击 Disconnect 并确认。 从客户端： 在客户端自己的设置中移除连接。

工具

CookieYes MCP 服务器为你的 AI 助手提供了一组与账户交互的工具。工具分为只读（检索数据，不做更改）或写入（创建、更新或触发操作）。在客户端支持的情况下，你的 AI 助手会在运行任何写入工具前请求确认。

类别	工具	类型	描述	示例提示词
域名与设置	list_domains	只读	列出你 CookieYes 账户中的所有网站	– 显示我的所有站点。– 我的哪些站点横幅处于非活动状态？
get_website_details	只读	获取特定域名的详细配置。	– 列出我的网站详情。– 显示 example.com 的详情。
get_embed_code	只读	获取你网站的 JavaScript 安装代码	– 给我网站的安装代码。– 如何安装 CookieYes？
横幅管理	list_banners	只读	列出某个域名上配置的所有同意横幅	– 显示我的所有横幅。– 我的站点上哪些横幅处于活动状态？
get_banner_status	只读	检查你的 Cookie 横幅是否已上线并处于活动状态	– 我的横幅是否已上线？– 安装代码是否已添加到我的站点？
update_banner_colours	写入/删除	更新横幅主题和颜色	– 将我在 example.com 上的横幅改为深色主题。– 将接受按钮设为海军蓝。
update_banner_layout	写入/删除	更改横幅布局、位置和偏好中心样式	– 将我的横幅移到右下角 – 将我的横幅位置改为左上角。
合规与扫描	get_scan_results	只读	按类别查看最新的 Cookie 扫描结果	– 我的站点上有哪些 Cookie？– 显示 example.com 上的所有第三方跟踪器。
get_compliance_status	只读	检查已启用哪些隐私法律和地理定位	– 我的站点是否符合 GDPR？– 我覆盖了哪些法规？
trigger_cookie_scan	写入/删除	在你的域名上启动新的 Cookie 扫描	– 在我的站点上运行新扫描 – 扫描我的网站以查找 Cookie。

安全与隐私注意事项

CookieYes MCP 服务器同时提供只读工具（检索数据）和写入工具（更改横幅配置或触发扫描）。访问通过 OAuth 2.1 with PKCE 管理，服务器只能访问有限的配置数据。个人信息、同意日志和 Cookie 值等敏感数据绝不会被暴露。

注意大多数 MCP 客户端（例如 Claude）会要求你在每次工具调用运行前批准。请保持此设置启用，并审查每次调用，尤其是可能修改你账户的写入工具。我们还建议只连接已验证的客户端或你信任的自定义客户端。请记住，账户所有者必须先启用 MCP 访问，任何客户端才能连接。

如需了解更多详情，请参阅隐私政策：👉 Privacy Policy - CookieYes 如果你在设置或故障排除方面需要帮助，请联系 CookieYes 支持：👉 Contact - CookieYes

使用场景

1. 检查横幅状态

用户提示词：“我的横幅是否处于活动状态？” 会发生什么：

服务器检索横幅安装和显示状态。
返回横幅处于活动还是非活动状态。
如果未检测到横幅，建议获取安装代码。

2. 发现你站点上的 Cookie

用户提示词：“扫描我的站点以查找 Cookie” 会发生什么：

服务器检查所选域名的扫描可用性。
在开始扫描前请求确认（如需要）。
启动 Cookie 扫描。
返回扫描状态（例如已排队或进行中）。
允许你在扫描完成后检索结果。

3. 更新横幅外观

用户提示：“将我的横幅更改为深色主题” 执行流程：

如果存在多个域名，系统会提示您选择一个域名。
服务器会验证所请求的更改。
在应用更新前请求确认。
更新横幅配置。
立即应用更改，并使其在您的网站上可见。

4. 检查合规配置

用户提示：“检查我的 GDPR 配置” 执行流程：

服务器会检索同意模板和地理定位设置。
返回适用的法规（例如 GDPR、CCPA）。
确认横幅安装状态。
附注说明这是配置检查，而非法律建议。

5. 监控多个域名

用户提示：“我的哪些网站横幅处于未激活状态？” 执行流程：

服务器会检索您账户中的所有域名。
返回每个域名的横幅状态。
突出显示横幅未激活或缺失的域名。
允许您选择一个域名以执行后续操作。

常见问题

1. 什么是 CookieYes MCP Server？

CookieYes MCP Server 是一个托管服务器，允许 AI 助手和 IDE（Claude、ChatGPT、Cursor、VS Code 等）通过模型上下文协议（MCP）安全地访问您的 CookieYes 账户。它会将您的自然语言请求转发给一组已定义的工具，因此您无需打开仪表板即可管理 Cookie 同意和合规事务。

2. CookieYes MCP Server 与 Claude 连接器是同一个东西吗？

不完全是。MCP 服务器是任何兼容 MCP 的客户端所连接的单一托管服务。“连接器”是 Claude 自己对添加 MCP 服务器方式的称呼，因此在 Claude 中，您是通过连接器连接到 CookieYes MCP Server。其他客户端（Cursor、VS Code 等）则通过各自的 MCP 设置连接到同一服务器。

3. CookieYes MCP Server 使用安全吗？

是的。访问采用带 PKCE 的 OAuth 2.1，因此您的 CookieYes 密码绝不会被共享，服务器只能访问有限的配置数据，敏感数据（如个人信息、同意日志和 Cookie 值）绝不会被暴露。大多数客户端还会要求您在每次工具调用运行前进行批准，并且账户所有者必须明确启用 MCP 访问权限后，任何客户端才能连接。

4. CookieYes MCP Server 支持免费套餐吗？

是的。它适用于所有 CookieYes 账户类型，包括免费套餐，连接无需付费订阅。不过，部分工具有基于套餐的使用限制，例如，每个域名每月可触发的 Cookie 扫描次数在付费套餐中会有所增加。

5. MCP 服务器可以访问哪些 CookieYes 数据？

CookieYes MCP 服务器被授予对您账户中特定配置数据的安全、有限访问权限，仅限于支持集成所需的数据。 MCP 服务器可以访问的内容：

域名级配置：已连接域名的横幅状态和设置。
您的域名和横幅配置：布局、位置、颜色设置和合规模板。
Cookie 扫描元数据和结果：上次扫描中扫描的页面、Cookie 总数和识别出的脚本总数。 MCP 服务器无法访问或处理的内容：
个人数据（PII）、同意日志或访客数据：个人同意记录绝不会被暴露。
Cookie 值、会话数据或用户标识符：仅返回元数据，绝不返回实际的 Cookie 值。
法律内容：您的 Cookie 政策文本、横幅标题或任何法律文案均被阻止。
账单信息、账户凭据或团队数据：支付详情、密码和团队成员信息绝不可访问。

6. MCP 服务器支持多种语言吗？

不支持。CookieYes MCP 服务器目前仅支持英语。

结构化数据

{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "headline": "CookieYes MCP Server",
      "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://www.cookieyes.com/documentation/mcp-server/"
      },
      "url": "https://www.cookieyes.com/documentation/mcp-server/",
      "publisher": {
        "@type": "Organization",
        "name": "CookieYes",
        "url": "https://www.cookieyes.com",
        "logo": {
          "@type": "ImageObject",
          "url": "https://www.cookieyes.com/cookieyes-logo.png",
          "width": 2048,
          "height": 2048
        }
      },
      "description": "Connect your AI assistant or IDE (Claude, ChatGPT, Cursor, VS Code, and more) to CookieYes and manage cookie consent and compliance in natural language.",
      "datePublished": "2026-04-16T17:42:25+00:00",
      "dateModified": "2026-09-09T07:00:34+00:00",
      "author": {
        "@type": "Person",
        "name": "CookieYes Doc Team"
      },
      "image": [
        "https://assets.cookieyes.com/claude_cookieyes_8770ff8228.png"
      ]
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://www.cookieyes.com/documentation/mcp-server/#breadcrumb",
      "itemListElement": [
        {
          "@type": "ListItem",
          "position": 1,
          "name": "Home",
          "item": "https://www.cookieyes.com/"
        },
        {
          "@type": "ListItem",
          "position": 2,
          "name": "Documentation",
          "item": "https://www.cookieyes.com/documentation/"
        },
        {
          "@type": "ListItem",
          "position": 3,
          "name": "Features Documentation",
          "item": "https://www.cookieyes.com/category/documentation/features/"
        },
        {
          "@type": "ListItem",
          "position": 4,
          "name": "CookieYes MCP Server",
          "item": "https://www.cookieyes.com/documentation/mcp-server/"
        }
      ]
    },
    {
      "@type": "WebSite",
      "@id": "https://www.cookieyes.com/#website",
      "url": "https://www.cookieyes.com/",
      "name": "CookieYes",
      "description": "CookieYes is a Google-certified consent management platform that helps businesses comply with GDPR, CCPA, and other global privacy laws.",
      "inLanguage": "en-US",
      "publisher": {
        "@id": "https://www.cookieyes.com/#organization"
      },
      "potentialAction": {
        "@type": "SearchAction",
        "target": {
          "@type": "EntryPoint",
          "urlTemplate": "https://www.cookieyes.com/?s={search_term_string}"
        },
        "query-input": {
          "@type": "PropertyValueSpecification",
          "valueRequired": true,
          "valueName": "search_term_string"
        }
      }
    },
    {
      "@type": "Organization",
      "@id": "https://www.cookieyes.com/#organization",
      "name": "CookieYes",
      "url": "https://www.cookieyes.com/",
      "logo": {
        "@type": "ImageObject",
        "@id": "https://www.cookieyes.com/#/schema/logo/image/",
        "inLanguage": "en-US",
        "url": "https://www.cookieyes.com/cookieyes-logo.png",
        "contentUrl": "https://www.cookieyes.com/cookieyes-logo.png",
        "width": 2048,
        "height": 2048,
        "caption": "CookieYes"
      },
      "image": {
        "@id": "https://www.cookieyes.com/#/schema/logo/image/"
      }
    }
  ]
}