Tolstoy Studio

Tolstoy MCP

将任意 MCP 客户端（Claude、ChatGPT、Cursor、Gemini 等）连接到 Tolstoy：面向 AI 原生电商品牌的 Agent 平台。直接在聊天中管理你的 Tolstoy 工作区：商店商品、媒体库、上传内容、已保存的模型、模板、项目和额度用量。

Tolstoy 通过 Streamable HTTP 提供远程 MCP 服务，并使用 OAuth 2.1 + PKCE 保护，无需粘贴 API 密钥；客户端会在首次连接时运行 OAuth 登录流程。

服务	端点	功能
Tolstoy	https://apilb.gotolstoy.com/mcp/v1/mcp	你的 Tolstoy 工作区 — 搜索商品和媒体库、上传媒体，并查看已保存的模型、模板、项目和用量。
Tolstoy Closet	https://apilb.gotolstoy.com/mcp/v1/closet/mcp	购物者的私人衣橱 — 保存、查找和移除他们拥有的衣物，并在 Shopbots 应用中继续操作。

从一个商品开始

Claude 和 Cursor 插件包含 tolstoy-product-media 技能：确认商店中的商品，筛选出适合该商品的媒体库内容，并上传缺少的内容。

工具

Tolstoy

• search_products — 在商店目录中查找商品及其变体和 ID。
• get_brand_context — 查看商店的品牌资料：标志、颜色、字体、受众和尺码指南。
• connect_products — 打开 Tolstoy 面板以连接商品目录：Shopify 商店、商品文件或数据源。
• search_media — 搜索媒体库中的视频和图片。
• get_media — 查看媒体项目的详情：已标记的商品、创作者、到期时间和源文件。
• analyze_media — 针对视频或音频文件提问一个问题。会消耗额度，但不会更改媒体库内容。
• start_media_upload / finish_media_upload — 通过可运行 shell 命令的客户端，将本地文件上传到媒体库。
• upload_media_from_panel — 打开 Tolstoy 面板并选择文件，上传到媒体库。
• search_fashion_models — 查找已保存的 Tolstoy 模型：带有参考图片的人物。
• save_fashion_model — 将某人的现有图片保存为新的已保存模型。
• search_templates / get_template — 查找并查看内容模板。
• search_projects — 列出项目及其文件夹。
• list_skills / get_skill — 查看 Tolstoy 的创作技能，即 Tolstoy Agent 遵循的指导内容。
• get_agent_chat / stop_agent — 查看或停止 Tolstoy Agent 聊天，包括你在 Tolstoy 平台中发起的聊天。
• get_generation — 查看生成任务的状态及其保存到媒体库的项目。
• list_voices — 搜索语音库及其中的语音试听内容。
• get_usage — 查看工作区在当前计费周期内的额度余额和用量。
• open_tolstoy — 在客户端中打开 Tolstoy，手动浏览媒体库、模型、模板和对话。

Tolstoy Closet

• search_closet — 列出或搜索购物者已保存的衣物。
• add_closet_items — 将衣物保存到衣橱。
• remove_closet_items — 移除已保存的项目。
• get_shopbots_link — 创建私人链接，以便在 Shopbots 应用中继续操作。

支持应用感知的客户端（ChatGPT、Claude）还可在聊天中内嵌交互式 Tolstoy 视图。该视图会调用模型不可见的其他几个工具。

连接

1. 在 MCP 客户端中添加自定义连接器 / 远程 MCP 服务。
2. 粘贴上表中的端点。
3. 完成 OAuth 提示：登录 Tolstoy；如果连接 Tolstoy Closet，则批准私人衣橱连接。

各客户端（Claude、ChatGPT、Cursor、Gemini CLI、Codex、Perplexity、Goose、Cherry Studio 等）的设置指南可在 Tolstoy 平台的 Settings → MCP 中查看。

Claude 插件

此仓库也是一个 Claude 插件：.claude-plugin/plugin.json 和 .mcp.json。该插件添加 Tolstoy 工作区服务和 tolstoy-product-media 技能。克隆此仓库后，可在本地运行 claude --plugin-dir . 加载插件。

Cursor Marketplace 插件

此仓库包含 Cursor 插件清单 .cursor-plugin/plugin.json。开发时，可将此仓库作为本地插件安装；也可以从 Cursor Marketplace 安装 Tolstoy。该插件添加 Tolstoy 工作区服务。

示例客户端配置

{
  "mcpServers": {
    "tolstoy": { "url": "https://apilb.gotolstoy.com/mcp/v1/mcp" }
  }
}

Codex CLI

codex mcp add 面向 STDIO 服务，因此请将远程服务添加到 ~/.codex/config.toml，然后运行 OAuth 登录：

[mcp_servers.tolstoy]
url = "https://apilb.gotolstoy.com/mcp/v1/mcp"

codex mcp login tolstoy

身份验证

使用 OAuth 2.1 和 PKCE。通过 RFC 9728，在各服务的 /.well-known 端点发现受保护资源元数据。Tolstoy 连接绑定到你授权使用的 Tolstoy 工作区。购物者批准 Tolstoy Closet 连接后，该连接会获得专属的私人访客衣橱。它无需 Tolstoy 账户；get_shopbots_link 可将其关联到 Shopbots 账户。

隐私、条款和支持

• 隐私政策
• 使用条款
• 支持：[email protected]
• 安全概览：gotolstoy.com/security

Registry

已发布到官方 MCP Registry：

• io.github.GoTolstoy/studio — Tolstoy 主服务
• io.github.GoTolstoy/closet — Tolstoy Closet

每个服务的 server.json 均位于 registry/。

关于

Tolstoy 是面向 AI 原生电商品牌的 Agentic 平台，为数千家商店提供可购物视频 — https://www.gotolstoy.com