pepabo/colormeshop-mcp

日本語版 README はこちら / Japanese README

The official remote Model Context Protocol (MCP) server for Color Me Shop — a Japanese e-commerce platform operated by GMO Pepabo, Inc.

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.

Claude Code

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

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:

{
  "mcpServers": {
    "colormeshop": {
      "url": "https://agent.colorme.app/api/mcp"
    }
  }
}

OpenAI Codex CLI

codex mcp add colormeshop --url https://agent.colorme.app/api/mcp

Gemini CLI

See the Gemini CLI MCP server documentation for adding remote MCP servers.

Local stdio bridge (advanced)

For clients that only support stdio transport, use mcp-remote:

{
  "mcpServers": {
    "colormeshop": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://agent.colorme.app/api/mcp"]
    }
  }
}

Documentation

• Color Me Shop AI Connector guide (Japanese)
• Product page (Japanese)
• Color Me Shop App Store listing

Requirements

• A Color Me Shop account
• The "Color Me Shop AI Connector" app installed from the App Store
• An MCP-compatible client (Claude Desktop, Claude Code, Cursor, OpenAI Codex CLI, Gemini CLI, etc.)

Support

• For service-related inquiries: Color Me Shop contact
• For issues with this repository: please open a GitHub Issue