# Connecting CookieYes MCP to Claude — Testing Manual

> For the complete site index, see [llms.txt](/llms.txt). Every page is also available as Markdown: replace the trailing slash with `.md` (`/pricing/` becomes `/pricing.md`), or send `Accept: text/markdown` to the page URL itself.

Connect the CookieYes MCP integration to Claude, review the permissions it needs, and try six use cases for managing your cookie banner.

---

**Last updated:** June 8, 2026
**URL:** https://www.cookieyes.com/documentation/cookieyes-mcp-claude-testing-manual/

---

## Step 1: Start the connection from Claude

1. Open Claude and go to **Customize** → **Browse Connectors**
2. Locate **CookieYes** and click **Connect**
3. You'll be redirected to a CookieYes authentication page in your browser

## Step 2: Log in

On the login screen, select **Log in & connect to Claude**, then enter the following credentials:
- **Email:** cookieyesclaudemcp@gmail.com
- **Password:** 9D6TTFvJleaJa1$

> *These are shared test credentials provisioned for this review. Do not share externally.*
>

## Step 3: Review permissions and allow access

You'll be taken to a permissions screen outlining what Claude can and cannot access.

| Access | Details |
| --- | --- |
| ✓ Can access | Domain-level configuration (banner status, settings); banner configuration and compliance settings; cookie scan results (categories, counts, detected scripts) |
| ✕ Cannot access | Visitor data, consent logs, and personal information; cookie values, session data, and user identifiers; legal content (cookie policies, banner text); billing details, account credentials, and team data |
| Security & control | Secure OAuth 2.0 connection limited to your account; you can disconnect anytime |

## Final action

- Click **Allow** to complete the connection
- Click **Cancel** to stop the connection

## Step 4: Connection status

## If you clicked Allow

You will get a *Connection Successful* confirmation.
- You'll be automatically redirected back to Claude within 3 seconds
- If not, close the browser tab and return to Claude manually

## If you clicked Cancel

You will get a *Connection Cancelled* message.
- Claude has no access to the account
- No data was shared
**Options:**
- Close the window
- Click **Review permissions again** to restart

> **Need to try again?**
> To retry the connection anytime, go to **Claude → Connector Settings** and start from Step 1.
>

## Step 5: Using CookieYes with Claude

Once connected, you can manage your cookie consent setup directly in Claude.

## Use cases

The six use cases below cover the full functional scope (text prompts, expected output, and tools used) of the CookieYes MCP integration.

## Use case 1: Check banner status

**Prompt:** "Is my banner active?"
**Expected output:**
- If multiple domains exist, Claude prompts the user to select one
- Retrieves banner installation and display status for the selected domain
- Returns whether the banner is active or inactive
- If not installed, Claude suggests retrieving the embed code
**Tools used:**
`list_domains → get_banner_status → get_embed_code`

## Use case 2: Discover cookies on your site

**Prompt:** "Scan my site for cookies"
**Expected output:**
- If multiple domains exist, Claude prompts the user to select one
- Checks scan availability for the selected domain
- Initiates a cookie scan; requests confirmation if required
- Returns scan status (queued or in progress)
- Allows the user to retrieve results once the scan is complete
**Tools used:**
`list_domains → get_website_details → trigger_cookie_scan → get_scan_results`

## Use case 3: Update banner theme

**Prompt:** "Change my banner to dark theme"
**Expected output:**
- If multiple domains exist, Claude prompts the user to select a domain and banner type (GDPR/CCPA)
- Validates the requested change
- Requests confirmation before applying the update
- Updates the banner configuration for the selected domain
**Themes available:**
- Paid plans: Light, Dark, Auto-generated, Custom colours
- Free plans: Light, Dark
**Tools used:**
`list_domains → list_banners → update_banner_colours`

## Use case 4: Check compliance configuration

**Prompt:** "Check my GDPR configuration"
**Expected output:**
- If multiple domains exist, Claude prompts the user to select one
- Retrieves the consent template and geo-target settings for the user-selected domain
- Returns regulations covered (e.g., GDPR and CCPA)
- Includes a disclaimer that this is a configuration check, not legal advice
**Tools used:**
`list_domains → get_compliance_status`

## Use case 5: Monitor multiple domains

**Prompt:** "Which of my sites have inactive banners?"
**Expected output:**
- Retrieves all domains linked to the account
- Returns banner status for each domain
- Highlights domains with inactive banners or missing setup
- Allows the user to select a domain for further actions
**Tools used:**
`list_domains`

## Use case 6: Customise banner layout

**Prompt:** "Make my cookie banner less intrusive"
**Expected output:**
- If multiple domains exist, Claude prompts the user to select one
- Retrieves the current banner configuration
- Requests confirmation before applying any changes
- Updates banner layout type, position, and preference centre style
- Publishes changes to the live banner and returns confirmation of the updated settings
**Tools used:**
`list_domains → list_banners → update_banner_layout`


---

## Structured Data

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@type": "Article",
      "headline": "Connecting CookieYes MCP to Claude — Testing Manual",
      "mainEntityOfPage": {
        "@type": "WebPage",
        "@id": "https://www.cookieyes.com/documentation/cookieyes-mcp-claude-testing-manual/"
      },
      "url": "https://www.cookieyes.com/documentation/cookieyes-mcp-claude-testing-manual/",
      "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 the CookieYes MCP integration to Claude, review the permissions it needs, and try six use cases for managing your cookie banner.",
      "datePublished": "2026-06-08T00:00:00+00:00",
      "dateModified": "2026-06-08T00:00:00+00:00",
      "author": {
        "@type": "Person",
        "name": "CookieYes Doc Team"
      },
      "image": [
        "https://assets.cookieyes.com/cookieyes.png"
      ]
    },
    {
      "@type": "BreadcrumbList",
      "@id": "https://www.cookieyes.com/documentation/cookieyes-mcp-claude-testing-manual/#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": "Connecting CookieYes MCP to Claude — Testing Manual",
          "item": "https://www.cookieyes.com/documentation/cookieyes-mcp-claude-testing-manual/"
        }
      ]
    },
    {
      "@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/"
      }
    }
  ]
}
```