Connect Claude or ChatGPT
You can connect an assistant such as Claude, ChatGPT or Cursor to Kooga and work through it: ask what changed this week, which articles are losing traffic or how often AI answers name your brand, or have it write an article and publish it. It works as you, in the workspaces you choose. Every connection is listed at Settings → Connected apps.
Before you start
- You need to be an owner or an admin of the workspaces you connect.
- The address to give your assistant is
https://mcp.kooga.io/mcp.
How do I connect my assistant?
https://mcp.kooga.io/mcp as its address.What do I choose when I connect?
- Workspaces. The ones you own or administer, all ticked to start. The assistant works only in the ones you leave ticked. To add one later, open Settings → Connected apps in that workspace and pick the connection under Add one of your connections; to take one away, disconnect it there.
- Read only, or Read and change. Read only looks things up: your numbers, what your agents found and did, your documents, your AI visibility, rankings, email results, contacts and segments. Read and change can also do work.
Can I connect a tool that cannot sign in?
Yes, with an access token. Use one for n8n, Make, a script, a scheduled job, or any MCP client that cannot open Kooga's sign-in page.
kooga_pat_ and is shown once: Kooga keeps only a fingerprint of it.https://mcp.kooga.io/mcp and send the token as a bearer token, in the header Authorization: Bearer kooga_pat_....In Claude Code that is:
claude mcp add --transport http kooga https://mcp.kooga.io/mcp --header "Authorization: Bearer kooga_pat_..."A token works like a connected app: as you, in the workspaces you ticked, with the same confirmations and limits. It is listed among the connections at Settings → Connected apps, marked as an access token with its expiry. Treat it like a password. If it leaks or you no longer need it, disconnect it there; it stops working at once.
What can it change, and when does it ask me first?
With Read and change, work that stays inside Kooga runs at once, as if you did it in Kooga: writing or refreshing an article, briefing a topic, drafting a campaign or changing one that has not gone out, writing the emails of a flow that is switched off or changing one of them (it stays off), creating a segment, changing a contact's name or city, tracking a prompt, a keyword or a competitor, declining a task on Tasks.
Anything that leaves Kooga asks you first: publishing an article, sending or scheduling a campaign, resending a campaign to the subscribers who did not open it, sending a test email, turning on an email flow, changing a product listing on your store, running a visibility check, unsubscribing contacts, deleting a campaign that has not gone out, and approving a card that does one of those. Kooga writes the question itself, from what is about to happen, for example "Turn on the welcome flow, in My Store?", and says who and how many where it matters: the contacts an unsubscribe reaches, how many a campaign would go to now, which campaign a delete removes. Where your assistant can show a confirmation, it shows it to you; otherwise it asks you in the chat. Nothing happens until you say yes, and one yes does one thing.
It can also put back a change it made, such as a product listing, when nothing has changed it since.
It works under the same rules as your agents: the words you ruled out on the Rules page, and anything you switched off there, apply to it too.
What does each part need?
An assistant can only read what the workspace has. A tool that needs something the workspace lacks says so, and the assistant can tell you what to set up.
| To read or change | The workspace needs |
|---|---|
| Sales, orders, products, product listings, ChatGPT's product cards | A Shopify store, or a WordPress site with WooCommerce, at Settings → Integrations |
| Search opportunities, articles losing clicks | Google Search Console, at Settings → Integrations |
| Google positions | Keywords you track; each position arrives with the next weekly check |
| Backlinks, and whether page one is within reach | A backlink check, at SEO → Backlinks |
| Site health | A crawl of the site, at SEO → Search findings |
| AI visibility, competitors, sources, the engines' answers | AI visibility tracking with prompts, at GEO → AI Visibility |
| Contacts, segments, campaigns, flows | Email contacts; sending also needs a verified domain, at Email → Setup |
| Shopper messages | Turned on for the connection, at Settings → Connected apps |
How do the numbers relate?
Each comes from its own source, and Kooga does not add them into one figure.
- Sales are every order the store recorded, whatever brought it. In Kooga, Store → Revenue splits them by where they came from, AI assistants included.
- Email results are Kooga's own sends: who received, opened and clicked.
- Google numbers come from Search Console and Kooga's weekly position checks.
- AI visibility comes from Kooga's checks of the AI engines.
An assistant connects them by reading them over the same period: the last 7, 30, 90 or 365 days, or any range of days you name, such as March against February, or the month before and after an article went live.
Are there limits?
- Changes that use your plan (an article, a visibility check) count against your plan as usual, and an assistant can make only a limited number of them a day in each workspace. You can lower or raise that limit for each connection at Settings → Connected apps.
- Test emails are limited per hour, so a test can be sent again after each edit.
- An image in an email has to be a PNG, JPG or GIF: Gmail and Outlook show no SVG or WebP, so an assistant that links one is told to link another. It can keep a picture from a link in Kooga first, and set the logo and the footer.
- A campaign can greet each reader by name (
{{first_name|there}}) and show a block only to one segment, or to everyone but it. - Tracked prompts and keywords count against the number your plan holds, as when you add them in Kooga. One already tracked is not added twice.
- It never subscribes anyone: a person is subscribed only when they agreed to it themselves.
- Shopper messages (your inbox, and what shoppers said about the store chat) are off for every connection until you turn them on under Shopper messages at Settings → Connected apps: they are written by shoppers, and an assistant reads them as information, never as instructions.
What can I ask?
- "What changed in my store this week?"
- "Which articles are losing traffic, and which should I refresh first?"
- "How often do AI answers mention us next to our competitors?"
- "What is waiting for me in Kooga? Approve the article ideas, skip the rest."
- "Write an article about caring for stoneware mugs, then publish it."
- "Draft a campaign for the autumn edit to my VIP segment and send me a test."
- "Who is ion@example.com, and did they open our last emails?"
- "Track 'stoneware mugs' on Google and add Clay Co as a competitor."
- "Research keywords about mug care. Which could we rank for?"
- "How healthy is our site? What should we fix first?"
- "Draft an abandoned-cart flow: a reminder after an hour, then one more the next day."
- "Show me our most discounted boots, and draft a campaign featuring them."
- "Resend last week's newsletter to the people who did not open it, with a new subject."
- "What exactly does ChatGPT say when people ask for handmade mugs, and why isn't it us?"
- "How visible are we in Hungary compared with Romania, month by month?"
- "Compare March with February: orders, email results and AI visibility."
- "Change the subject of the campaign draft, then send me a test."
- "Draft a campaign laid out like this: our logo, the Access+ offer with a button, these six products at member prices in two columns, then our categories with a photo each." Your assistant lays it out block by block and reads it back, so it can check it is what you asked.
Does Kooga come with ready-made prompts?
Yes. Your assistant lists them with Kooga's tools (in Claude, under the +
menu; in Claude Code, as /mcp__kooga__mondayReview and so on):
| Prompt | What it does |
|---|---|
| Account audit | Sales, the email list and every flow, Google rankings and site health, and AI visibility over the last 90 days, with what is set up but unused, ending in the five fixes worth most. |
| Monday review | What is waiting for you, what your agents did, how sales, Google rankings, AI visibility and email moved this week, and three things to do. |
| Fix my weakest topic | Finds the buyer topic where AI answers name you least, shows who they name and cite instead, and plans what would change it. |
| Competitor radar | Where your tracked competitors lead you: in AI answers, in the sources AI cites, on Google, on ChatGPT's product cards and in backlinks. |
Each one asks before it changes anything. Kooga also gives your assistant a glossary of its terms (visibility rate, share of voice, keyword difficulty and the rest), so it reads your numbers the way Kooga means them.
Every tool your assistant can use, with what it takes and what it returns, is listed on MCP tools.
Where do I see what it did?
Settings → Connected apps lists every assistant connected to the workspace, who connected it, and what it did there. From there you can turn customer messages on or off, change the daily limit, or disconnect it. Its changes also appear in your activity like any other.
Troubleshooting
How do I disconnect it?
Remove the connector in your assistant's settings, or disconnect it from the workspace at Settings → Connected apps. Disconnecting there takes effect at once for that workspace; any other workspaces the person connected keep it.
Removing the connector in your assistant does not tell Kooga, so the connection stays listed until it is replaced: adding the same app again replaces its old connection, and keeps what each workspace allowed it.