AI / MCP
integrations/mcp-server.md

AI / MCP

What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude and ChatGPT connect to external tools. By connecting your AI to Kleio via MCP, you can ask it questions about your data and, even better, make it do tedious work for you like updating prices, setting tags and rewriting product copy.

Connecting

Claude Desktop

  1. Log in to the Kleio account you want to connect to.
  2. Open Claude Desktop → Settings → Connector → Add custom connector.
  3. Name the connector “Kleio”, or whatever you want, and input the URL https://app.getkleio.com/api/mcp.
  4. Authorize and get redirected to Claude.
  5. Some users may need to restart Claude Desktop after connecting for the connection to take effect.

Claude Code

  1. Run the following command:
claude mcp add kleio --transport http https://app.getkleio.com/api/mcp
  1. You’ll be prompted to authorize Kleio on first use.

ChatGPT

  1. Log in to the Kleio account you want to connect to.

  2. In the ChatGPT sidebar, click Plugins.

  3. Click the settings wheel in the top-right corner, then MCPs.

    Note: You don’t need Developer Mode, even though ChatGPT’s own documentation says custom connectors require it. If you can’t see the settings wheel at all, you’re most likely on a business or workspace account where an admin hasn’t given your role permission to add connectors. Ask them to enable it.

  4. Click Add server.

  5. Name it “Kleio”, set URL Type to Streamable HTTP, and paste the URL https://app.getkleio.com/api/mcp.

  6. Click Save, then Authenticate and approve access to your Kleio account.

Other MCP Clients

Any MCP-compatible client can connect to Kleio. Point it to the server URL (https://app.getkleio.com/api/mcp) using the HTTP transport. The OAuth consent flow will handle authentication automatically.

What Your AI Can Do

Read your Kleio data

Your AI gets access to all the same data you see in the web app: P&L, products, lifetime value, cohorts and more, narrowed by the same filters you use in the dashboard.

So you can ask it things like:

  • “What are our best products for acquiring new customers?”
  • “Do we have any dead stock I need to liquidate?”
  • “What products should we push in the near future?”

Manage products

The more interesting use is freeing up your time by handing it all the tedious, manual work that’s part of running an online store. The MCP server lets your AI manage everything about your products:

  • Prices
  • Content (title, description, URL handle and SEO)
  • Status
  • Tags
  • Sales channels
  • Options
  • Create products (as drafts)
  • Add or remove variants and colours/sizes
  • Remove empty options
  • Metafields
  • Cost
  • Weight

If you need it to do anything else, like anything order-related, email us and we’ll get it implemented ASAP.

Help you set up Kleio

Ask it to help you set up Kleio and it’ll walk you through everything you need to get the most out of it: connect ad and shipping integrations, set up variable costs and fixed costs, and find any gaps in product data.

  • Variable costs — Anything that scales with orders: shipping, payment fees, fulfillment, returns, customs and agency fees. Charge them flat per order or per item, or as a percentage of sales, COGS, shipping or ad spend.
  • Fixed costs — Rent, salaries, software. Daily through yearly, spread evenly across the period.
  • Custom COGS — Product costs held only in Kleio, for when margins stay out of the Shopify admin or cost varies by country, quantity or date.
  • Missing numbers — Every variant with no cost or weight, including products you have since deleted from Shopify.
  • 3PL invoices — Import what your carrier actually charged per order, then check which orders use those real costs instead of your estimates.

Ad platform and 3PL connections need you to log in through the browser, so it hands you the link for those.

Access tokens

List and switch off the long-lived tokens your AI clients hold, for when one leaks or a former employee’s client is still connected.

Analytics Playbook

The MCP server ships with our analytics playbook, a structured guide that teaches your assistant to think about your store the way an experienced operator would. You do not have to install or paste anything: the server tells your assistant the guide is there, and it reads it when it needs it.

High-Value Prompts to Ask Right Away

These prompts show the kind of deep analysis you get immediately after connecting:

  • “Find every product losing money after ad spend and set them to draft.”
  • “Rewrite the SEO titles on our 20 worst-converting products.”
  • “When is the optimal time for us to re-engage customers?”
  • “Analyze our P&L and recommend how we can make more money.”
  • “Here’s my shipping rate card [paste]. Create the shipping costs for 2026.”
  • “Analyze this bank statement and create the fixed costs.”