Skip to main content

Quick start

This guide walks you through connecting your first AI client to the store.

1. Verify the extension is enabled

Navigate to Stores -> Configuration -> Mirasvit Extensions -> MCP Server -> General Settings and ensure Enable MCP Server is set to Yes (enabled by default after installation).


2. Log in to the admin panel

Important

You must be logged in to the Magento admin panel in your browser for authorization to succeed. The OAuth flow redirects to the admin area for consent — if you are not logged in, you will be prompted to log in first.


3. Find your MCP Server URL and setup instructions

Click your username in the top-right corner of the admin panel and select Account Setting. The AI Client Configuration section displays the MCP Server URL and setup instructions for each supported AI client.


4. Connect an AI client

The fastest way to connect is using Claude Code (Anthropic's CLI tool). Run the following command in your terminal:

claude mcp add --transport http my-store https://your-store.com/mcp/server/handle

Replace my-store with any name you prefer and https://your-store.com/mcp/server/handle with the MCP Server URL shown on the MCP Info tab.

For other AI clients, see the Connect AI clients section.


5. Authorize the connection

After running the setup command, a browser window will open with the OAuth consent screen. This screen shows:

  • The AI client requesting access
  • The tools and permissions it will have
  • Authorize and Deny buttons

Click Authorize to grant access.


6. Start using the AI assistant

Once authorized, the AI client can use the store's tools. Try asking it something like:

  • "How many products are in the store?"
  • "Show me the last 5 orders"
  • "What store views are configured?"

The AI client will use the appropriate MCP tool to answer your question.