Colormeshop MCP

What pepabo/colormeshop-mcp MCP server does

pepabo/colormeshop-mcp MCP server provides an MCP interface for Color Me Shop, a Japanese e-commerce platform operated by GMO Pepabo. It connects AI clients to store-management functions through a hosted service rather than requiring the repository to run locally.

The supported areas include:

• Orders: list and search orders using conditions such as date, customer, or payment status; update or cancel orders; view sales statistics; send order emails; and create payment URLs.
• Products: list and search products, register or update them, manage inventory, and organize categories and groups. Featured-product configuration is also supported.
• Customers: list and search customer records, register and update customers, award points, and manage membership ranks.
• Coupons: create, update, and delete coupons.
• Shop settings: inspect delivery methods, payment methods, gift settings, and product reviews.

How it works

The service is available at https://agent.colorme.app/api/mcp over Streamable HTTP. An MCP-compatible client connects to that endpoint and exposes the available Color Me Shop operations to an AI assistant. Requests can be expressed as natural-language tasks, such as finding unprocessed orders or identifying products below a stock threshold, subject to the permissions granted to the connection.

Authentication uses OAuth 2.1 and Dynamic Client Registration. Supported clients handle registration and the authorization flow during setup. Access is scoped through Color Me Shop OAuth permissions, which follows a least-privilege model rather than granting unrestricted store access.

Setup and configuration

A Color Me Shop account is required, along with the “Color Me Shop AI Connector” app installed from the Color Me Shop App Store. After installation, add the remote endpoint to an MCP client and complete the OAuth authorization process.

Claude Code can register the endpoint with its HTTP transport. Claude Desktop and claude.ai accept the same URL as a custom connector. Cursor can use a remote server entry in .cursor/mcp.json. OpenAI Codex CLI and Gemini CLI also support remote MCP server configuration according to their respective client instructions.

Clients that only support stdio can use an external mcp-remote bridge, but that bridge is not the Color Me Shop service itself. The hosted endpoint remains the target MCP server.

Tools and capabilities

pepabo/colormeshop-mcp MCP server is intended for operational work in an existing Color Me Shop shop. Typical tasks include reviewing current orders, changing order state, checking stock, editing product information, maintaining customer data, administering coupons, and inspecting store configuration.

The connector is useful when the desired workflow combines search and mutation. For example, an agent can locate records using supported filters and then perform an update or cancellation when the authorized account permits that action. Exact available actions depend on the Color Me Shop OAuth scope assigned during authentication.

Limitations and notes

The service requires a Color Me Shop account and the AI Connector app; connecting an MCP client alone is not sufficient. Standard Color Me Shop subscription charges continue to apply, although access to the MCP server is free across Color Me Shop plans.

This listing documents a remote service, not a local standalone implementation. The repository’s setup instructions identify the hosted endpoint and client configuration methods rather than a package that must be installed and executed locally. Service-related questions should go to Color Me Shop support, while repository-specific problems can be reported through GitHub Issues.