Next TokenParallel World

← ラボ / Claude Code ガイド / 連携台帳

GMOペパボ株式会社・ネットショップ・国内　公式サイト
公式トップに「ECサイト・ネットショップの構築・開設なら、カラーミーショップ byGMOペパボ」とある、ECカートサービス。開発者向けにAPI・アプリストアと、公式の遠隔MCPサーバー（カラーミーショップAIコネクター）を用意している。

Claude Codeに、どこまで権限を渡せるか

読み取り専用で渡せるか 未確認
READMEに読み取り専用モードの記載は見つからなかった（「Read-only mode: not mentioned」）。APIの読み取り専用トークンの有無も未確認。
権限（スコープ）を選べるか 未確認
READMEは「最小権限のOAuthでアクセスが絞られる」と記載しているが、具体的なスコープ名・利用者が選べる範囲は書かれていない。
危険な操作の既定
制御の記載なし（READMEにキャンセル・削除・メール送信・決済URL生成の確認や承認の手順の記載は見つからなかった）。
削除ができるか できる
READMEにクーポンの削除が明記。受注のキャンセルも機能一覧にある。商品・顧客の削除は機能一覧に記載なし（READMEにツール名の一覧はない）。
取り消し方（キー・接続）
公式ドキュメントによると、ショップオーナーはアプリストアの「利用中のアプリ一覧」からアプリを削除（アンインストール）でき、その際カラーミーショップAPIのアクセストークンが無効化される。CLI側は colorme logout で手元の認証情報を全削除（サーバー側失効の記載はCLIページには無い）。（根拠: https://developer-docs.shop-pro.jp/document/uninstallation/）

根拠のページ

つなぎ方（公式の資料にある範囲）

公式MCP あり

公式GitHub（pepabo/colormeshop-mcp、MIT）に「Official remote MCP server for Color Me Shop」とある。READMEの機能一覧：受注（一覧・検索、更新、キャンセル、売上統計、メール送信、決済URL生成）、商品（一覧・検索、登録、更新、在庫・カテゴリ・グループ管理、レコメンド商品設定）、顧客（一覧・検索、登録、更新、ポイント付与、会員ランク管理）、クーポン（作成・更新・削除）、ショップ設定（配送方法・決済方法・ギフト設定・商品レビューの参照）。エンドポイントは https://agent.colorme.app/api/mcp（Streamable HTTP）。公式トップにも「カラーミーショップAIコネクター」アプリの記載がある。

つなぎ方（公式の記載）
READMEの記載：claude mcp add --transport http colormeshop https://agent.colorme.app/api/mcp を実行し、Claude Code内で /mcp を開いて Authenticate でOAuthを完了する。事前にカラーミーショップのアプリストアで「Color Me Shop AI Connector」アプリをインストールしておく必要がある。

根拠のページ

公式CLI あり

カラーミーショップ公式CLI（コマンド名 colorme）。読み取り: API呼び出し（colorme api）、商品取得、FTP一覧・ダウンロード、テンプレート取得、ヘルプ記事検索。書き込み: API更新（PUT/POST）、FTPアップロード、テンプレートのpush。削除: colorme ftp delete でファイル削除（APIでの削除は同ページに明記なし）。Node.js v20以上、npm install -g @colorme/cli。colorme setup でブラウザ認証し、AI Agent Skills もインストールされる。

根拠のページ

公式API あり

カラーミーショップのAPI。開発者サイトに「開発のためのAPIや開発環境（ドキュメント、テストショップなど）を用意しており、全て無料で提供」とある。カラーミーショップデベロッパーでアカウント登録して開発し、アプリストアへ公開する場合は審査（通常5営業日ほど）がある。公式トップの「開発中・提供予定の機能」表には、Webhookイベント「受注通知」の公開（2026年9月予定、進捗100%）、定期販売「次回予定日の取得」の公開（2026年11月予定、進捗0%）が載っている。

根拠のページ

第三者製MCP（公式ではない） 見つからず

見つかっていません。

第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。

探した場所（1件）
  • WebSearch（カラーミーショップ MCP／API の検索。出てきたのは上記の提供元自身のpepabo/colormeshop-mcpのみで、提供元以外のMCPは見つからなかった）

できる操作

読み取りでできる操作

  • 【MCP】受注の一覧・検索（日付・顧客・支払い状況）、売上統計、商品の一覧・検索、顧客の一覧・検索、配送方法・決済方法・ギフト設定・商品レビューの参照

書き込みでできる操作

  • 【MCP】受注の更新、受注メールの送信、決済URLの生成、商品の登録・更新、在庫・カテゴリ・グループの管理、レコメンド商品の設定、顧客の登録・更新、ポイント付与、会員ランクの管理、クーポンの作成・更新

管理者操作（削除・課金・設定変更など）

  • 【MCP】受注のキャンセル、クーポンの削除（READMEに「create, update, and delete coupons」）。READMEに確認・承認の手順の記載はない

制限

  • MCP：カラーミーショップのアカウントと、アプリストアの「Color Me Shop AI Connector」アプリのインストールが必要。
  • MCP：READMEに「MCP server access is free on all Color Me Shop plans」。
  • MCP：リポジトリは9コミット・オープンPR 5件の状態（GitHubページの表示）。若いプロジェクトと読める。
  • API：アプリをアプリストアに公開する場合は審査あり（通常5営業日ほど）。
注意
  • MCPで受注のキャンセル・メール送信・クーポン削除などができる。取り消せるか／確認が入るかの記載はREADMEに見つからなかった。
  • 接続先は公式READMEにある https://agent.colorme.app/api/mcp を使う前提。READMEに警告・注意書きの節は見つからなかった。

認証・料金・日本語・実機検証

認証方式
【MCP】OAuth 2.1（Dynamic Client Registrationは対応クライアントが自動処理）。READMEに「Access is scoped via Color Me Shop OAuth with least-privilege permissions」とある。【API】OAuthの詳細は読めていない（APIドキュメントがメタ情報しか取得できなかった）。
公表されている料金（2026年10月16日確認）
公式トップの表示：レギュラー月額4,950円（決済手数料3.4%〜）、ラージ月額9,595円（同3.19%〜）、プレミアム月額35,640円〜（同2.99%〜）。ページ上で税込・税抜の表記は確認できず。フリープランは「初期費用・月額費用が無料」（FAQの記載）。MCPサーバーの利用は「全プランで無料」「通常のカラーミーショップの利用料はかかる」とREADMEに記載（2026-10-16確認） 料金ページ
日本語対応
あり。公式サイト、開発者サイトとも日本語。READMEは英語で、「Most documentation is in Japanese」と記載。管理画面の日本語は画面を開いていないが日本向けサービス。
Claude Code実機検証
未検証（この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます）
確認できていない点（9件）
  • APIドキュメント（developer.shop-pro.jp/docs/colorme-api）はメタ情報しか取得できず、スコープ・エンドポイント・レート制限・トークン有効期限は未確認。developer-docs.shop-pro.jp はrobots制限で開けなかった。
  • READMEにツール名の一覧がなく、読み取り・書き込み・削除の細かい内訳は確認できていない（機能一覧のみ）。
  • 公式CLIは、開発者サイトとトップに記載が見当たらなかったが、ドキュメント本体が読めていないため「未確認」とした。
  • 料金ページ（shop-pro.jp/plans/）は開かず、トップの表示のみを根拠にした。
  • GitHubページに最終コミット日が表示されておらず、更新日は未確認。
  • 2026-10-17再確認で残った点: official_cli: developer.shop-pro.jp トップ・スタートガイドにCLIの記載は見当たらないが、開発ドキュメント目次(developer-docs.shop-pro.jp/document/)は取得できず（robots制限）、API仕様ページは本文を読めなかったため確定せず
  • 2026-10-17再確認で残った点: permission.scope: pepabo/colormeshop-mcp のREADMEに「最小権限のOAuth」とあるのみでスコープ名の記載なし。APIドキュメント本文は取得できず
  • 2026-10-17再確認で残った点: permission.read_only: 同上、読み取り専用の記載を確認できず
  • 2026-10-17再確認で残った点: permission.scope / read_only: CLIページ・アンインストールページ・アプリの種類ページ・shop-pro.jp/func/api/・developer.shop-pro.jp/getting-started にスコープ一覧・読み取り専用の記載なし。developer.shop-pro.jp/docs/colorme-api は本文取得不可、developer-docs.shop-pro.jp/document/ は robots により取得不可
出典（6件）

この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。

ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。