Skip to content

MCP connector

Vivlab exposes an MCP (Model Context Protocol) connector that lets a compatible AI assistant, such as Claude, act directly on your store: find a product, write a product description, create a discount coupon, adjust a shipping rate or review your orders, all from a simple conversation. The assistant never receives your password: it goes through an authorization that you grant yourself and can revoke whenever you want.

Come here when you want to hand repetitive tasks to an AI (updating a batch of prices, translating descriptions, preparing a set of blog articles), query your catalog in plain language, or plug your own tool into your store's data. Everything the assistant does stays limited to your account and mirrors what you could do yourself in the dashboard.

What you need

Just one thing: an assistant or tool that knows how to connect to a remote MCP server. That includes the Claude app (desktop and web), Claude Code, Cursor and most recent MCP clients. You will also need your usual Vivlab credentials to confirm the authorization.

There is no key or token to copy: the connection sets itself up from a single address.

The connection address

The only thing to give your assistant is the connector address:

https://dashboard.vivlab.com/mcp

From this address, your assistant automatically discovers how to authenticate and opens the Vivlab authorization page in your browser. There is nothing else to enter.

Authorize access

The first time your assistant connects, Vivlab asks for your approval:

  1. Enter https://dashboard.vivlab.com/mcp in your assistant and start the connection.
  2. Your browser opens on Vivlab. Sign in to your dashboard if you aren't already.
  3. An authorization page shows the connector's name and the access it requests. Review them, then click Authorize to confirm or Cancel to refuse.
  4. You return to your assistant: it is now linked to your store.

The authorization stays valid until you revoke it. Your assistant renews it on its own, so you don't have to go through this step again for every conversation.

WARNING

Once connected, the assistant acts on your behalf and can edit your store according to the access you granted. Only authorize tools you trust, and carefully review the actions it suggests before confirming them.

Read-only or editing

The authorization covers two distinct access levels:

  • Viewing: the assistant can search and read your catalog (products, pages, blog articles, collections, coupons, orders) but changes nothing.
  • Editing: the assistant can additionally create, update and delete items, and upload images or files.

The authorization page shows exactly which access is requested before you confirm. If you want a risk-free connection to review or analyze your data, use an assistant set to view-only; to let it carry out changes, grant editing.

Set up your assistant

The steps depend on the tool you use, but the address to provide is always the same.

Claude (app and web)

Open Claude's settings, the connectors section, then add a custom connector by pasting the address https://dashboard.vivlab.com/mcp. Claude then opens the Vivlab authorization page described above. Once access is granted, the Vivlab actions become available in your conversations. Adding custom connectors may require a paid plan.

ChatGPT

You can enable MCP servers in ChatGPT if you have a Pro, Plus, Business, Enterprise or Education account. Follow the instructions in OpenAI's documentation. Use the following settings when configuring your custom connector:

  • The server address is https://dashboard.vivlab.com/mcp.
  • Use "OAuth" as the connection method.

ChatGPT then opens the Vivlab authorization page described above.

Mistral (Vibe / Le Chat)

In Mistral Vibe (formerly Le Chat), open the settings, the connectors section, then add a custom connector by entering a name and the address https://dashboard.vivlab.com/mcp. Le Chat then opens the Vivlab authorization page described above. Once access is granted, enable the Vivlab connector in a conversation so it can act on your store. Adding custom connectors may require a paid plan.

Claude Code

In a terminal, add the connector with a single command:

bash
claude mcp add --transport http vivlab https://dashboard.vivlab.com/mcp

Then launch Claude Code and type /mcp to start the authorization: your browser opens on Vivlab to confirm access.

Cursor and other clients

Most MCP clients expect a small configuration file. Declare the Vivlab server as a remote connector:

json
{
  "mcpServers": {
    "vivlab": {
      "url": "https://dashboard.vivlab.com/mcp"
    }
  }
}

On the first call, the client opens the Vivlab authorization page in your browser. Check your tool's documentation for the exact location of this file.

What the assistant can manage

Once connected, the assistant handles the same data you do from the dashboard. Here is what it can do, area by area.

AreaAvailable actions
ProductsSearch, view, create, update and delete a product with its prices
CategoriesList, view, create, update and delete a category
Facet filtersList, view, create, update and delete a filter
Discount couponsSearch, view, create, update and delete a coupon
Shipping ratesSearch, view, create, update and delete a rate
PagesSearch, view and update a page
BlogArticles, authors, sections and tags: list, view, create, update and delete
OrdersSearch, view and update an order
SubscriptionsSearch and view (read-only)
Images and filesUpload an image or file and get its address to use on a listing

Subscriptions always stay view-only. Every create, update and delete action is available only if you granted editing access; otherwise the assistant is limited to viewing.

Full list of tools

Every action the assistant can trigger maps to a "tool" it picks based on your request. The table below lists them all. The Access column shows whether the tool is Viewing (available as soon as you connect) or Editing (available only if you granted that access).

ToolDescriptionAccess
products_searchSearch productsViewing
products_getView a product and its pricesViewing
products_createCreate a product and its pricesEditing
products_updateUpdate a product and its pricesEditing
products_deleteDelete a product and its pricesEditing
collections_listList categoriesViewing
collections_getView a categoryViewing
collections_createCreate a categoryEditing
collections_updateUpdate a categoryEditing
collections_deleteDelete a categoryEditing
facets_listList facet filtersViewing
facets_getView a facet filterViewing
facets_createCreate a facet filterEditing
facets_updateUpdate a facet filterEditing
facets_deleteDelete a facet filterEditing
coupons_searchSearch discount couponsViewing
coupons_getView a discount couponViewing
coupons_createCreate a discount couponEditing
coupons_updateUpdate a discount couponEditing
coupons_deleteDelete a discount couponEditing
shippings_searchSearch shipping ratesViewing
shippings_getView a shipping rateViewing
shippings_createCreate a shipping rateEditing
shippings_updateUpdate a shipping rateEditing
shippings_deleteDelete a shipping rateEditing
pages_searchSearch pagesViewing
pages_getView a pageViewing
pages_updateUpdate a pageEditing
blog_articles_searchSearch blog articlesViewing
blog_articles_getView a blog articleViewing
blog_articles_createCreate a blog articleEditing
blog_articles_updateUpdate a blog articleEditing
blog_articles_deleteDelete a blog articleEditing
blog_authors_listList blog authorsViewing
blog_authors_getView a blog authorViewing
blog_authors_createCreate a blog authorEditing
blog_authors_updateUpdate a blog authorEditing
blog_authors_deleteDelete a blog authorEditing
blog_categories_listList blog sectionsViewing
blog_categories_getView a blog sectionViewing
blog_categories_createCreate a blog sectionEditing
blog_categories_updateUpdate a blog sectionEditing
blog_categories_deleteDelete a blog sectionEditing
blog_tags_listList blog tagsViewing
blog_tags_getView a blog tagViewing
blog_tags_createCreate a blog tagEditing
blog_tags_updateUpdate a blog tagEditing
blog_tags_deleteDelete a blog tagEditing
invoices_orders_searchSearch ordersViewing
invoices_orders_getView an orderViewing
invoices_orders_updateUpdate an orderEditing
invoices_subscriptions_searchSearch subscriptionsViewing
invoices_subscriptions_getView a subscriptionViewing
images_uploadUpload an image and get its addressEditing
files_uploadUpload a file and get its addressEditing

Disconnect

To remove access, delete the Vivlab connector from your assistant's settings: it will no longer be able to reach your store. The authorization also expires on its own if it stops being used. As long as the connection exists, it only gives access to your account and nothing else.

Documentation crafted with ❤️ by our in-house team.