Koru VTEX MCP

Connect a verified VTEX store to ChatGPT or Claude and query it in read-only mode.

Koru VTEX MCP lets ChatGPT or Claude query a VTEX store in read-only mode. The license is free, no card is required, and each authorization is limited to the website you select.

What each part installs

Koru VTEX MCP is obtained in Koru and added to your assistant as a private server. The separate Koru VTEX Connector app establishes the VTEX connection from VTEX Admin. This guide links to the Connector step when needed.

Complete journey

Order	Where	Expected result
1	Koru Suite + email	Account verified and onboarding resumed automatically
2	Koru Suite	Organization, website, and free app created
3	VTEX Admin + Koru Suite	Connector linked and ownership verified
4	Koru Suite	Storefront authorized; channel selected only when needed
5	ChatGPT or Claude	MCP authorized and tools available
6	Chat	First useful read-only audit

Create the account and get the app

Open Koru Suite

Go to korusuite.com, scroll to the app catalog, and open Koru VTEX MCP. Choose Create free account.

You do not need to find an MCP in a directory or publish a plugin. This is a personal connection to your own store.

Create and verify your identity

Register on the secure sign-in screen. Open the verification email, confirm the address, and continue in the tab opened by the link. Koru refreshes the session and resumes the same onboarding flow without making you start again. The original tab enters a terminal state and can be closed.

Use the same identity for onboarding, VTEX linking, and ChatGPT or Claude authorization.

Create the organization and website

Enter:

Business name;
Country;
the public VTEX store address, including https:// and the customer-facing domain;
the required legal confirmations.

Choose Continue. Koru creates the organization, website, and free Koru VTEX MCP license. Do not enter an Admin URL, workspace URL, or VTEX credentials.

Connect VTEX

Open My apps → Koru VTEX MCP and the Connect your VTEX store step. Install Koru VTEX Connector and choose Connect with Koru once in VTEX Admin. Koru keeps the request if you need to sign in or create an account.

Signed Connector evidence verifies ownership automatically when the VTEX account and public address match. Only when that proof is insufficient does Koru offer a public HTTPS file or DNS TXT record as recovery.

Authorize the storefront

Koru shows the chosen public address once. If that domain has one sales channel, it is selected automatically. If it has several, select the correct channel and confirm authorization. Technical store data stays inside the expandable details.

The correct result is Your store is ready. Completed stages are compacted and Koru shows the details needed for ChatGPT or Claude. Use the detailed Connector guide if you need to install it or recover a link.

Get the private URL

After the store is connected, Koru shows Use it in ChatGPT or Claude. Copy the server URL. It has this form:

https://mcp.korusuite.com/vtex/PRIVATE_IDENTIFIER/mcp

The URL identifies your connection

Do not publish or share it, and do not use another store's URL. It contains no AppKey, AppToken, or VTEX credential.

Add it to ChatGPT or Claude

Enable developer mode

In ChatGPT open Settings → Security and login and enable Developer mode. Availability may depend on your account or workspace policy.

Create the personal plugin

Open Plugins, choose +, and enter:

Field	Value
Name	`Koru VTEX MCP`
Description	`Securely query catalog, pricing, inventory, orders, and logistics data from my VTEX store connected through Koru.`
Connection	Server URL
Server URL	The private URL copied from Koru, including the final `/mcp` path
Authentication	OAuth

Acknowledge the custom MCP server warning and choose Create. Do not publish it to a public directory.

Authorize the store

Choose Sign in with Koru VTEX MCP, sign in to Koru, and review Connect ChatGPT with Koru. Confirm the store and requested access.

Back in ChatGPT, confirm that the server tools are listed. Start a new chat and add Koru VTEX MCP from the tools menu.

This path follows the official OpenAI guide for connecting an MCP server.

First useful query

Paste this prompt into a new chat with Koru VTEX MCP enabled:

Use Koru VTEX MCP exclusively in read-only mode.
 
1. Identify the VTEX account, workspace, sales channel, country/locale, and currency.
2. Find up to 10 published products and select 3 representative SKUs.
3. For each SKU, check price, inventory, and sellability. You may simulate checkout
   only if it creates or changes no cart, order, price, or stock.
4. Return a table with: product, SKU, price, stock, sellable, detected issue, and evidence.
5. Finish with the 3 highest-impact actions, ordered by priority.
 
Do not expose personal data, make changes, or invent missing data. If a query is not
available, state exactly what was unavailable.

The expected result includes the correct store context, evidence per SKU, and concrete recommendations. It must not claim that VTEX was modified.

You can also start with smaller requests:

List the 10 published products with the lowest available stock. Include product, SKU,
stock, and evidence without making changes.

Review the latest available orders and summarize status, sales channel, and possible
delays without exposing buyers' personal data.

Compare price, inventory, and sellability for three representative SKUs in the
authorized sales channel. Flag inconsistencies and do not modify VTEX.