Content
# Color Me Shop MCP Server
[日本語版 README はこちら / Japanese README](./README.ja.md)
The official remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Color Me Shop](https://shop-pro.jp/) — a Japanese e-commerce platform operated by [GMO Pepabo, Inc.](https://pepabo.com/)
Run your online store through natural conversation with AI. "Show me today's unprocessed orders" or "List products with 5 or fewer in stock" — delegate your shop operations to Claude and other MCP-capable AI tools.
## Endpoint
```
https://agent.colorme.app/api/mcp
```
Transport: Streamable HTTP. Authentication: OAuth 2.1 with Dynamic Client Registration (handled automatically by supported clients).
## Features
- Order management — list and search orders (by date, customer, payment status), update, cancel, view sales statistics, send order emails, and generate payment URLs
- Product management — list and search products, register, update, manage inventory/categories/groups, configure featured products
- Customer management — list and search customers, register, update, award points, manage membership ranks
- Coupon management — create, update, and delete coupons
- Shop settings — inspect delivery methods, payment methods, gift settings, and product reviews
Access is scoped via Color Me Shop OAuth with least-privilege permissions.
## Pricing
MCP server access is free on all Color Me Shop plans. Standard Color Me Shop subscription fees apply as usual.
## Quick Start
Before connecting, install the "Color Me Shop AI Connector" app from the [Color Me Shop App Store](https://app.shop-pro.jp/apps/956).
### Claude Code
```bash
claude mcp add --transport http colormeshop https://agent.colorme.app/api/mcp
```
Then run `/mcp` inside Claude Code and select Authenticate to complete the OAuth flow.
[Claude Code MCP docs](https://docs.anthropic.com/en/docs/claude-code/mcp)
### Claude Desktop / claude.ai
Settings → Connectors → Add custom connector → enter:
```
https://agent.colorme.app/api/mcp
```
OAuth is handled automatically by Claude.
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"colormeshop": {
"url": "https://agent.colorme.app/api/mcp"
}
}
}
```
### OpenAI Codex CLI
```bash
codex mcp add colormeshop --url https://agent.colorme.app/api/mcp
```
### Gemini CLI
See the [Gemini CLI MCP server documentation](https://github.com/google-gemini/gemini-cli/blob/main/docs/tools/mcp-server.md) for adding remote MCP servers.
### Local stdio bridge (advanced)
For clients that only support stdio transport, use [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):
```json
{
"mcpServers": {
"colormeshop": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://agent.colorme.app/api/mcp"]
}
}
}
```
## Documentation
- [Color Me Shop AI Connector guide (Japanese)](https://help.shop-pro.jp/hc/ja/articles/49646901116819)
- [Product page (Japanese)](https://shop-pro.jp/func/colorme-ai-connector/)
- [Color Me Shop App Store listing](https://app.shop-pro.jp/apps/956)
## Requirements
- A [Color Me Shop](https://shop-pro.jp/) account
- The "Color Me Shop AI Connector" app installed from the [App Store](https://app.shop-pro.jp/apps/956)
- An MCP-compatible client (Claude Desktop, Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, etc.)
## Support
- For service-related inquiries: [Color Me Shop contact](https://shop-pro.jp/contact/)
- For issues with this repository: please open a [GitHub Issue](https://github.com/pepabo/colormeshop-mcp/issues)
