Connect your AI tool to your store

Niblr speaks MCP (Model Context Protocol), the open standard AI tools use to connect to outside systems. Point an MCP-compatible client — Claude Desktop, Cursor, and others — at your store and you can manage it in plain language: "add these three products", "what sold this week?", "draft an About page with a hero and an FAQ."

Your AI tool connects to your own store, sees only your store's data, and — as a safety measure — never publishes pages or deletes anything. Page changes are saved as drafts for you to review and publish.

1. Create an API key

An API key is how your AI tool proves it's you. Each key acts as the team member who created it, so it can only do what that person can do in the admin.

1. In your store admin, open API Keys (under the MCP group in the sidebar).
2. Click Create New, give it a Label (e.g. "My laptop – Claude"), and confirm Enable API Key.
3. Use the capability checkboxes to choose what this key may do — for example leave products and pages on but turn a capability off if you don't need it.
4. Save, then copy the generated key. Treat it like a password — anyone with it can act on your store. You can revoke it any time by disabling or deleting the key.

2. Connect your AI tool

Your connection URL is your store address followed by /api/mcp:

https://your-store.niblr.store/api/mcp

(If you use a custom domain, use that instead — e.g. https://shop.example.com/api/mcp.)

Authenticate with an Authorization: Bearer header carrying your key. For Claude Desktop, add this to your MCP config (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "my-store": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-store.niblr.store/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Clients with built-in support for remote MCP servers can skip mcp-remote and enter the URL and header directly. Restart the client after saving, and your store's tools will appear.

3. What you can do

Ask your AI to…	What happens	Plan
"List my out-of-stock products" / "What did I sell this week?"	Reads your catalog and orders (orders are always read-only).	Any plan
"Show me the blocks I can use on a page"	Runs list_blocks — every page block with its fields, and whether your plan can use it.	Any plan
"Add a product called Linen Tote, ₹1,200, 20 in stock"	Creates or updates products in your store.	Premium
"Draft an About page with a hero, our story, and an FAQ"	Composes a page from your blocks and saves it as a draft.	Premium

Reading your store works on every plan. Creating and editing — products, categories, and pages — is a Premium feature. On the Starter plan your AI can browse and answer questions about your store; upgrade to Premium to let it make changes.

When your AI drafts or edits a page, open Pages in the admin, preview it, and hit Publish when you're happy. Nothing your AI tool does goes live on its own.

Good to know

• It's scoped to your store. A key only ever sees the store it belongs to — never another store's data.
• Safe by design. No deletes, no order changes, and no publishing pages — those stay in your hands in the admin.
• Revoke instantly. Disable or delete the key in API Keys and the connection stops working immediately.