SUZURI MCP Server

SUZURI MCP 服务

日文版 README 请见此处 / Japanese README

面向 SUZURI 的官方远程 Model Context Protocol (MCP) 服务。SUZURI 是由 GMO Pepabo, Inc. 运营的按需印制商品平台。

上传图片或生成文字设计，将其印制到 450 多种商品上，打造原创商品，还可以搜索和探索商品——所有操作都可通过与 AI 助手进行自然语言对话完成。

端点

https://mcp.suzuri.jp/mcp

传输方式：Streamable HTTP。身份验证：OAuth 2.1（由支持的客户端自动处理）。

功能

• 素材管理 — 上传图片素材、生成文字素材、分析参考图片，并管理已有素材
• 商品创建 — 将素材放置到商品上以创建商品、预览和比较放置效果，并使用放置预设
• 商品发现 — 搜索和浏览商品、查看推荐商品、相似商品和精选商品
• 收藏与合集 — 管理收藏，并将商品整理到“Choice”合集中
• 账户与动态 — 查看个人资料、关注的用户和动态消息

定价：MCP 服务访问免费。 制作或购买商品时需支付 SUZURI 标准费用。

快速开始

请从下方选择客户端。

Claude Code

claude mcp add --transport http suzuri https://mcp.suzuri.jp/mcp

然后在 Claude Code 中运行 /mcp，并选择 Authenticate 以完成 OAuth 流程。

Claude Code MCP 文档

Claude Desktop / claude.ai

设置 → 连接器 → 添加自定义连接器 → 输入：

https://mcp.suzuri.jp/mcp

OAuth 由 Claude 自动处理。

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "suzuri": {
      "url": "https://mcp.suzuri.jp/mcp"
    }
  }
}

OpenAI Codex CLI

codex mcp add suzuri --url https://mcp.suzuri.jp/mcp

Gemini CLI

请参阅 Gemini CLI MCP 服务文档，了解如何添加远程 MCP 服务。

本地 stdio 桥接（高级）

对于仅支持 stdio 传输方式的客户端，请使用 mcp-remote：

{
  "mcpServers": {
    "suzuri": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.suzuri.jp/mcp"]
    }
  }
}

要求

• 一个 SUZURI 账户
• 一个兼容 MCP 的客户端（Claude Desktop、Claude Code、Cursor、OpenAI Codex CLI、Gemini CLI 等）

隐私政策

• 隐私政策：GMO Pepabo, Inc. 隐私政策
• 服务条款：SUZURI 服务条款
• 联系：SUZURI 联系表单

此服务访问的内容

此服务使用你连接时授予的 OAuth 2.1 访问令牌，代表你调用 SUZURI API。每个工具都会调用一个固定的 SUZURI 端点。

• 读取 — 你的 SUZURI 个人资料、素材、商品、销售记录、收藏、合集和动态消息，以及公开目录（商品、用户、商品款式）。
• 写入 — 仅通过你批准的写入工具进行：创建和编辑素材与商品，以及管理收藏和合集。此服务不处理购买或付款；结账在 suzuri.jp 上完成。
• 你提供的图片 URL — 当你根据图片创建素材，或要求分析参考图片时，此服务会获取该 URL，以便将图片转交给 SUZURI 或进行检查。

存储与保留

• 此服务不会缓存或存储你的 SUZURI 内容（商品、素材、销售数据）。每次工具调用都会直接发送到 SUZURI API。
• OAuth 令牌采用静态加密（AES-256-GCM），并会自动过期：授权会话和授权码在 10 分钟后过期，访问令牌则在其有效期结束时过期。
• 完成授权时会记录一条审计日志，其中包含 MCP 客户端 ID、你的 SUZURI 用户 ID 和用户名，以及授予的权限范围。访问令牌绝不会被记录。
• 工具参数和对话内容不会被记录或存储。

第三方

出站请求仅发送到 suzuri.jp 和你明确提供的图片 URL。本服务不会与任何其他第三方共享数据。

你的控制权

• 你可以随时在 MCP 客户端中断开此连接器，以停止所有访问。
• 你可以通过 SUZURI 的 OAuth 撤销端点撤销访问令牌；令牌也会自动过期。
• 如需披露、更正或删除你的个人数据，请参阅隐私政策第 13 节。

支持

• 服务相关咨询：SUZURI 联系表单
• 关于此代码库的问题：请提交 GitHub Issue

许可证

MIT