Prerequisites
- A Katla account at katla.app with at least one site
- An AI assistant that supports remote MCP servers - Claude, ChatGPT, Claude Code, Cursor, or VS Code
Step 1: Copy the server URL
Step 2: Add it to your assistant
- Claude
- ChatGPT
- Claude Code
- Cursor / VS Code
- Open Settings → Connectors in Claude (web, desktop, or mobile).
- Click Add custom connector.
- Name it
Katlaand pastehttps://api.katla.app/mcpas the URL. - Click Add.
Step 3: Sign in
Click Connect (in Claude Code, run/mcp and choose Authenticate). A browser window
opens where you sign in with your normal Katla account, exactly as you would on the
dashboard.
That’s it - the Katla tools are now available in any new chat.
Everything the MCP server does runs as you. It can only reach the teams and sites you
already have access to, and team roles, site permissions, and plan limits are enforced
exactly as they are in the dashboard and CLI.
Step 4: Try it
Ask your assistant something it needs your Katla data to answer:What you can ask
Audit cookies
“What cookies does example.com set, and which are marketing?”
Check consent
“What’s the consent acceptance rate for example.com?”
Onboard a domain
“Add shop.example.com to Katla and scan it.”
Fix a classification
“Reclassify the
_hjSession cookie on example.com as analytics.”Write your own wording
“Describe
_ga on example.com in German as ‘Unterscheidet Besucher’.”Install the banner
“How do I install the Katla widget on example.com?”
Setting up a new domain, end to end
The steps below normally mean several separate visits to the dashboard. Ask for them together and the assistant walks the sequence itself:- “Add
shop.example.comto Katla.” The domain is usable immediately - there is no DNS record or meta tag to publish first. - “Scan it.” Starts a cookie crawl. Scans count against your plan quota.
- “What did it find?” Lists the cookies and their categories.
- “How do I install the banner?” Returns your script tag.
Troubleshooting
The client says it cannot discover the server
The client says it cannot discover the server
Check that the URL is exactly
https://api.katla.app/mcp, with no trailing slash. If you
run your own Katla API, see self-hosting.Sign-in succeeds but tools fail with an authentication error
Sign-in succeeds but tools fail with an authentication error
Your Katla session expired. Disconnect and reconnect the connector to sign in again.
A tool says the connection is read-only
A tool says the connection is read-only
The client requested only the
katla:read scope. Reconnect and grant katla:write too.Scanning is refused with a quota error
Scanning is refused with a quota error
You have used your plan’s monthly scan allowance. Ask the assistant to check your plan,
or review it in the dashboard.
The assistant asks which team to use
The assistant asks which team to use
You belong to more than one team. Name the team in your request, or ask it to list your
teams first.
Next steps
MCP reference
Every tool, the permission model, and self-hosting.
CLI
The same capabilities from your terminal.