Connect your AI assistant to Cookie Compliance
Connect your AI app to your Cookie Compliance account, and it can read your cookie banner and, when you ask, change it. This page has the steps for each app.
Fastest way: paste this into your AI chat #
Paste the prompt below into a chat with your AI app. It asks you a few questions, then does what it can and tells you exactly what to click for the rest. You approve the sign-in yourself, in your browser, and it asks before it creates anything in your account.
Connect yourself to my Cookie Compliance account so you can manage my consent banner. Guide: https://manual.hu-manity.co/connect.md (if you can't open it, tell me and I'll paste it).
First show me a short plan. Then do it one step at a time, asking one question at a time. Never guess my answers.
0. If you can already see Cookie Compliance tools, run help.authStatus. If I'm connected, skip to step 5.
1. Ask which AI app I'm using. Don't assume. Use that app's exact steps from the guide.
2. Ask whether I already have a Cookie Compliance account.
- No: give me two options.
(a) Preview only, using https://mcp.cookie-compliance.co/mcp. It shows a look-only banner, and nothing goes live.
(b) Create a free account (no card). Tell me every step. The terms, password, email check and captcha are mine to do. Then continue as "Yes".
- Yes: go to step 3.
3. Ask whether I want to add it myself or have you do it.
- Myself: give me the steps one at a time.
- You: add https://mcp.cookie-compliance.co/mcp/account at user level, so the folder doesn't matter. If the command isn't found, look for my app's bundled program or ask me. If a Cookie Compliance entry already exists, remove it first. If you can't run commands in this app, say so and give me the steps instead.
4. Tell me the sign-in steps for my app, including whether I need a new session and the exact sentence to say in it. I sign in in my browser. Never ask for my password or an API token in this chat.
5. Prove it by listing my sites. If a site for my domain is already there, tell me and skip to step 7.
6. If my domain isn't there, ask me which domain I want to set up. Then tell me exactly what you're about to do ("Register <domain> as a new app in my account and publish a starter banner") and wait for my yes. Don't create anything without it. If I already have a similar domain, ask me whether this is a separate site or the same one before going on. Never subscribe or upgrade me.
7. Then stop and ask what I want next. Don't change my banner or settings unless I ask.
Prefer to do it yourself? The steps for each app are below.
Which address do I use? #
| You | Address to add |
|---|---|
| Have a Cookie Compliance account and want the AI to read or change your banner | https://mcp.cookie-compliance.co/mcp/account |
| Just trying it out, no account | https://mcp.cookie-compliance.co/mcp |
Account address. When you add it, your AI app asks you to sign in. A Cookie Compliance page opens in your browser and you approve it there. There is nothing to copy, and you never give your password to the AI.
Try-it-out address. No sign-in. The AI can show a preview of a banner and help install one. It cannot change a real banner.
Then follow the steps for your app:
- Claude (claude.ai and Claude Desktop)
- ChatGPT
- Claude Code
- Cursor and other coding tools
- My app has no sign-in
Claude (claude.ai and Claude Desktop) #
Claude in a web browser and the Claude Desktop app share the same connectors, so set it up once. Custom connectors work on the Free, Pro, Max, Team and Enterprise plans. On Free you can add one custom connector.
Free, Pro and Max:
- Open Customize, then Connectors.
- Click + Add, then Add custom connector.
- Name:
Cookie Compliance. URL: paste the address from the table above. - Click Continue. Claude checks the address and shows the sign-in it found. Click Continue again.
- Authentication: choose Sign in now.
- OAuth client: choose Register automatically.
- Click Add. Sign in to Cookie Compliance in the page that opens, and approve.
Team and Enterprise:
- An Owner or Primary Owner adds it once for everyone: Organization settings, then Connectors, then Add, Custom, Web. Use the name and address above. (On Enterprise, a custom role with Manage access to Libraries can do this too.)
- Then each member opens Customize, then Connectors, finds Cookie Compliance, clicks Connect, and signs in.
Use it in a chat: click + at the lower left of the message box, open Connectors, and switch Cookie Compliance on.
Anthropic updates these screens from time to time, so a button label may differ slightly. Their own guide: Get started with custom connectors using remote MCP.
ChatGPT #
ChatGPT connects in the web version only. What you can do depends on your plan:
| Plan | What works |
|---|---|
| Business, Enterprise, Edu | Everything: the AI can read and change your banner. On Business, only an admin or owner can add it for the workspace. |
| Pro | The AI can look at your banner but cannot change it. |
| Other plans, such as Plus | OpenAI's guide does not say these plans can add a custom server. Use the Claude app instead. |
Steps:
- Open Plugins and click +.
- Choose Add custom MCP server.
- Name:
Cookie Compliance. Paste the address from the table above. - Set up authentication: choose OAuth. Sign in to Cookie Compliance in the page that opens, and approve.
- ChatGPT shows a risk warning about custom servers. Accept it to finish.
On an older version of ChatGPT you may first need to turn on Developer mode: go to Settings (on Business: Workspace Settings), then Permissions & Roles, switch on Developer mode, and then create the connector.
If you don't see "Add custom MCP server", your plan or workspace does not allow it. Use the Claude app instead.
OpenAI's own guide: Developer mode and MCP apps in ChatGPT.
Claude Code #
In a terminal, run:
claude mcp add --transport http --scope user cookie-compliance https://mcp.cookie-compliance.co/mcp/accountStart a new Claude Code session.
Type
/mcp, choose cookie-compliance, then choose Authenticate. Sign in to Cookie Compliance in the browser page that opens, and approve.
Just trying it out? Use https://mcp.cookie-compliance.co/mcp in step 1 and skip step 3.
Cursor and other coding tools #
Add the account address. Most tools then ask you to sign in through your browser. To try it out with no account, use https://mcp.cookie-compliance.co/mcp instead.
| Tool | Add the server |
|---|---|
| Cursor | Add to .cursor/mcp.json (this project) or ~/.cursor/mcp.json (all projects): {"mcpServers": {"cookie-compliance": {"url": "https://mcp.cookie-compliance.co/mcp/account"}}}. |
| Windsurf | In Cascade open the MCP settings and edit mcp_config.json: {"mcpServers": {"cookie-compliance": {"serverUrl": "https://mcp.cookie-compliance.co/mcp/account"}}}. Windsurf has no one-click install for this. |
| GitHub Copilot (VS Code) | Add to .vscode/mcp.json: {"servers": {"cookie-compliance": {"type": "http", "url": "https://mcp.cookie-compliance.co/mcp/account"}}}, or run code --add-mcp "{\"name\":\"cookie-compliance\",\"type\":\"http\",\"url\":\"https://mcp.cookie-compliance.co/mcp/account\"}". |
| Codex | Run codex mcp add cookie-compliance --url https://mcp.cookie-compliance.co/mcp/account. If Codex shows the server as needing sign-in, run codex mcp login cookie-compliance. |
| Any other MCP client | Add a Streamable HTTP server with the address. If it cannot sign in through a browser, use an API token (next section). |
If the new tools do not show up after you add the server, start a new session in your tool.
If your app cannot sign in: use an API token #
Use this only when your app has no sign-in button for the server. A token is a long code that starts with hu_.
Sign in to your Cookie Compliance dashboard.
Open https://app.hu-manity.co/#/api-tokens/new. (The dashboard calls this Temporary Login. It is also on the Preferences page.)
Login Name: something you will recognise, such as
My AI assistant.Expires At: pick the latest date the date picker allows (up to 30 days ahead).
Click Submit.
The Login Created box shows a URL ending in
token=hu_…. It is shown only once. Copy just the part aftertoken=: that is your token, and it starts withhu_. (The Copy Link button copies the whole link. If you use it, delete everything up to and includingtoken=.) Keep the link private: it opens your account without a password.In your AI app's connection settings for the server, use the account address and add this header:
Authorization: Bearer hu_…In Claude Code, for example:
claude mcp add --transport http --scope user cookie-compliance https://mcp.cookie-compliance.co/mcp/account --header "Authorization: Bearer hu_…"
Never paste the token into a chat message. It goes in the connection settings only.
Only an Admin or Super Admin on the account can create a token. A Master Admin sign-in cannot.
Tokens expire. When yours does, the AI can no longer reach your account: create a new token the same way and replace the old one. You can revoke a token at any time from the same list (Revoke Token).
Check it worked #
Ask your AI:
Which Cookie Compliance sites can you see?
It should list your sites.
- It says it is connected but cannot see your sites: there are two causes.
- You added the try-it-out address. Remove the server and add
https://mcp.cookie-compliance.co/mcp/accountinstead. - You use an API token and it has expired or was revoked. Create a new token and replace the old one.
- You added the try-it-out address. Remove the server and add
- It asks you to sign in again: this can happen from time to time. It is one click in the browser page that opens.
What to ask next #
Try:
Make my cookie banner match my website. My brand colour is #…, my page background is #…. Show me the change before you publish it.
Give the AI your colours, or a screenshot of your site. It cannot reliably read colours from a web address.
Through this connection the AI can change the banner's colours, position, size, wording, button corners and animation. Button corners change on paid plans only: on the Free plan they stay at the default. It can also choose the banner font from four options: your website's own font, a plain sans-serif (Arial), a serif (Georgia) or the device's own font. It cannot change the logo or add custom code through the connection; for another font or custom CSS, see Customise beyond design settings.
After you publish a change, visitors whose browser saved the old banner may see it for up to an hour.
For AI agents #
- If the person pasted the prompt at the top of this page, follow its numbered steps, using the per-app steps below.
- Ask which app the person uses, then give them that app's steps from this page, one step at a time.
- Existing customer: the account address. No account: the try-it-out address. Never ask for a password, and never accept a token in a chat message.
- Then follow
skills/match-site-design/SKILL.mdto restyle a banner, orskills/install-banner/SKILL.mdto install one.