Skip to main content

How to Connect Tolstoy MCP (Claude / Grok / Gemini)

Connect Tolstoy MCP from Plugins to Claude, Grok, or Gemini CLI so your brand team can create media, manage shopping experiences, and review campaigns from those AI clients.

Written by David T

Tolstoy MCP connects Claude, Grok, and Gemini CLI to your Tolstoy workspace. After you connect and sign in, you can create Studio media, manage shopping experiences, review campaigns, and ask workspace questions from that AI client.

For ChatGPT, see How to Connect Tolstoy MCP in ChatGPT.

Find MCP connectors in Tolstoy

  1. In Tolstoy, open Plugins.

    Plugins landing page

  2. Under AI workspaces, open Claude, Grok, or Gemini CLI.

    AI workspaces connectors

  3. Click Open setup. This opens Settings → API, MCP & CLI → MCP with that client selected.

    Claude connector detail Open setup

Server URL used by every client:

https://apilb.gotolstoy.com/mcp/v1/mcp

Claude

  1. Click Connect in Claude, or paste the server URL under Claude Settings → Connectors.

    Claude MCP setup steps

  2. Click Add → Connect, then sign in with your Tolstoy account.

  3. Ask Claude to use the Tolstoy tools.

Grok

  1. From Plugins, open the Grok connector, then click Open setup.

    Grok connector detail Open setup

  2. Open grok.com and go to Connectors.

  3. Click New Connector → Custom, name it Tolstoy, and paste https://apilb.gotolstoy.com/mcp/v1/mcp.

    Grok MCP setup steps

  4. Complete the sign-in prompt with your Tolstoy account.

Gemini CLI

  1. Run this in your terminal:

    gemini mcp add --transport http tolstoy https://apilb.gotolstoy.com/mcp/v1/mcp

    Gemini CLI MCP setup steps

  2. Run gemini. The first tool call opens a browser tab — sign in with your Tolstoy account.

  3. Ask Gemini to use the Tolstoy tools.

If the Gemini CLI card under Plugins does not load, use Open setup or go to Settings → API, MCP & CLI → MCP → Gemini CLI for the install command.

What you can do after connecting

  • Generate and iterate on Studio content in the same chat.

  • Find media, tag products, and publish onsite widgets such as Stories, Carousel, or Spotlight.

  • Check Meta ads performance (reads and creative uploads only — never spend).

Best Practices

  • Sign in to the Tolstoy workspace you want the client to use.

  • Start with one real merchant task, not a test prompt.

  • Publishing and other consequential actions stay approval-gated in Tolstoy.

  • This is Tolstoy MCP for your brand team — separate from Brand MCP for shoppers.

Troubleshooting and FAQs

Where do I start in Tolstoy?
Open Plugins → AI workspaces, pick a connector, then Open setup.

Do I need an API key?
No. Tolstoy MCP uses sign-in with your Tolstoy account.

Why did the client connect to the wrong workspace?
The connection stays tied to the workspace you approved. Disconnect and reconnect to switch.

Did this answer your question?