内容
# 颜色我商店 MCP 服务器
[日本語版 README はこちら / 日语 README](./README.ja.md)
[颜色我商店](https://shop-pro.jp/) 的官方远程 [模型上下文协议（MCP）](https://modelcontextprotocol.io/) 服务器 - 一个由 [GMO Pepabo, Inc.](https://pepabo.com/) 运营的日本电子商务平台。
通过与 AI 的自然对话来运行您的在线商店。“显示今天未处理的订单”或“列出库存为 5 个或更少的产品” - 将您的商店操作委托给克劳德和其他支持 MCP 的 AI 工具。
## 端点
```
https://agent.colorme.app/api/mcp
```
传输：可流式 HTTP。身份验证：带有动态客户端注册的 OAuth 2.1（由支持的客户端自动处理）。
## 功能
- 订单管理 - 列出和搜索订单（按日期、客户、付款状态）、更新、取消、查看销售统计、发送订单电子邮件和生成付款 URL
- 产品管理 - 列出和搜索产品、注册、更新、管理库存/类别/组、配置特色产品
- 客户管理 - 列出和搜索客户、注册、更新、奖励积分、管理会员等级
- 优惠券管理 - 创建、更新和删除优惠券
- 商店设置 - 检查配送方式、付款方式、礼品设置和产品评论
通过 颜色我商店 OAuth 以最小权限范围访问。
## 定价
所有 颜色我商店 计划均免费提供 MCP 服务器访问。标准 颜色我商店 订阅费按正常收取。
## 快速入门
连接前，请从 [颜色我商店 应用商店](https://app.shop-pro.jp/apps/956) 安装“颜色我商店 AI 连接器”应用。
### 克劳德 代码
```bash
claude mcp add --transport http colormeshop https://agent.colorme.app/api/mcp
```
然后在克劳德代码中运行 `/mcp` 并选择身份验证以完成 OAuth 流。
[克劳德代码 MCP 文档](https://docs.anthropic.com/en/docs/claude-code/mcp)
### 克劳德 桌面 / claude.ai
设置 → 连接器 → 添加自定义连接器 → 输入：
```
https://agent.colorme.app/api/mcp
```
OAuth 由克劳德自动处理。
### 游标
添加到 `.cursor/mcp.json`：
```json
{
"mcpServers": {
"colormeshop": {
"url": "https://agent.colorme.app/api/mcp"
}
}
}
```
### OpenAI 代码克斯 CLI
```bash
codex mcp add colormeshop --url https://agent.colorme.app/api/mcp
```
### Gemini CLI
参见 [Gemini CLI MCP 服务器文档](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md)，了解如何添加远程 MCP 服务器。
### 本地 stdio 桥（高级）
对于仅支持 stdio 传输的客户端，请使用 [`mcp-remote`](https://www.npmjs.com/package/mcp-remote)：
```json
{
"mcpServers": {
"colormeshop": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://agent.colorme.app/api/mcp"]
}
}
}
```
## 文档
- [颜色我商店 AI 连接器指南（日语）](https://help.shop-pro.jp/hc/ja/articles/49646901116819)
- [产品页面（日语）](https://shop-pro.jp/func/colorme-ai-connector/)
- [颜色我商店 应用商店列表](https://app.shop-pro.jp/apps/956)
## 要求
- 一个 [颜色我商店](https://shop-pro.jp/) 账户
- 从 [应用商店](https://app.shop-pro.jp/apps/956) 安装的“颜色我商店 AI 连接器”应用
- 一个支持 MCP 的客户端（克劳德桌面版、克劳德代码、游标、OpenAI 代码克斯 CLI、Gemini CLI 等）
## 支持
- 服务相关查询：[颜色我商店 联系](https://shop-pro.jp/contact/)
- 关于此仓库的问题：请在 [GitHub 问题](https://github.com/pepabo/colormeshop-mcp/issues) 上打开
