CCV Shop MCP by usefulapi について
CCV Shop MCP by usefulapi は、CCV Shop の店舗運営者向けのホスト型 MCP サーバーです。店舗データの読み取りに加え、注文への内部メモ追加ができ、OAuth 認証でローカルへの導入は不要です。
主な機能
- 01商品と注文の読み取り
- 02顧客と請求書の確認
- 03カテゴリ、ブランド、仕入先の参照
- 04注文への内部メモ追加
- 05ホスト型サービスと OAuth 認証
活用シーン
- 01注文詳細と明細の確認
- 02商品や顧客情報の検索
- 03請求書や仕入先情報の確認
- 04注文への内部メモの記録
MCP 対応
MCP クライアントに CCV Shop のデータ参照ツールと注文メモの書き込みツールを公開します。クライアントはホスト型エンドポイントに接続し、CCV Shop の認証情報で認証します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://ccv-shop.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-ccv-shop https://ccv-shop.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-ccv-shop":{"type":"http","url":"https://ccv-shop.usefulapi.io/mcp"}}}Cursor で開く{"servers":{"io-usefulapi-ccv-shop":{"type":"http","url":"https://ccv-shop.usefulapi.io/mcp"}}}VS Code で開く{"mcpServers":{"io-usefulapi-ccv-shop":{"type":"http","url":"https://ccv-shop.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-ccv-shop":{"serverUrl":"https://ccv-shop.usefulapi.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
usefulapi の CCV Shop MCP
CCV Shop アカウントを Claude、Cursor、または任意の MCP クライアントから利用できます。商品、注文、注文明細、顧客、請求書、カテゴリ、ブランド、サプライヤーを読み取り、注文に内部メモを追加できます。ホスト型のため、ローカルへのインストールは不要です。ご自身の認証情報を使って接続します。
ライブエンドポイント: https://ccv-shop.usefulapi.io/mcp · ホームページ: https://usefulapi.io
接続
- Claude(claude.ai、Desktop):Customize → Connectors を開き、+ Add → Add custom connector をクリックして、
https://ccv-shop.usefulapi.io/mcpを貼り付けます。 - Claude Code:
claude mcp add --transport http ccv-shop https://ccv-shop.usefulapi.io/mcpを実行し、続けて/mcpを実行してログインします。 - VS Code: VS Code に追加。
- Cursor およびその他のクライアント: URL をリモート MCP サーバーとして追加します。
{
"mcpServers": {
"ccv-shop": {
"url": "https://ccv-shop.usefulapi.io/mcp"
}
}
}
URL のみを追加してください。クライアント設定に Authorization ヘッダーや API キーを追加しないでください。サーバーが OAuth でサインインを行い、ログインページで CCV Shop の認証情報を尋ねます。
ステップごとの設定方法、認証情報の確認場所、よくある質問:https://usefulapi.io/ccv-shop/
初回接続時に、CCV Shop のショップ名、API キー、API シークレットを入力します(CCV Shop の My web shop、Settings、API settings にあります。ショップ名は .ccvshop.nl より前の部分です)。サーバーが認証情報を検証し、ユーザーごとに保存します。設定ファイルにキーを記載する必要はありません。
ツール
| ツール | 種類 | 内容 |
|---|---|---|
ccvshop_list_products | 読み取り | 商品一覧を取得 |
ccvshop_get_product | 読み取り | 商品を取得 |
ccvshop_list_orders | 読み取り | 注文一覧を取得 |
ccvshop_get_order | 読み取り | 注文を取得 |
ccvshop_list_order_rows | 読み取り | 注文明細一覧を取得 |
ccvshop_add_order_note | 書き込み | 注文に内部メモを追加 |
ccvshop_list_categories | 読み取り | カテゴリ一覧を取得 |
ccvshop_list_brands | 読み取り | ブランド一覧を取得 |
ccvshop_list_suppliers | 読み取り | サプライヤー一覧を取得 |
ccvshop_list_invoices | 読み取り | 請求書一覧を取得 |
ccvshop_get_invoice | 読み取り | 請求書を取得 |
ccvshop_list_users | 読み取り | 顧客一覧を取得 |
ccvshop_get_user | 読み取り | 顧客を取得 |
ccvshop_usage_status | メタ | 利用状況(無料プランの利用量) |
ccvshop_request_feature | メタ | 不足している機能をリクエスト |
ccvshop_upgrade | メタ | Pro にアップグレード(無制限*) |
ccvshop_cancel_subscription | メタ | Pro サブスクリプションを解約 |
read ツールは読み取り専用です。write ツールはデータを変更するため、クライアント側で確認が必要です。meta ツールは利用状況の報告、サブスクリプションの管理、機能リクエストの送信を行います。
料金
| プラン | 料金 | 上限 |
|---|---|---|
| Free | $0 | 月あたり 50 回のツール呼び出し |
| Pro(ユーザーごと) | $9/月 または $90/年(2 か月分無料) | 無制限* |
*このサーバーでは、Pro の公正利用上限は月あたり 10,000 回のツール呼び出しです。それ以上必要な場合は [email protected] にお問い合わせください。
Pro はこのサーバーのみが対象です。ccvshop_upgrade で登録してください(Stripe Checkout のリンクが返されます)。ccvshop_cancel_subscription でいつでも解約できます。Pro は支払い済み期間の終了まで利用でき、現在の期間分の返金はありません。期間終了前に ccvshop_upgrade を実行すると、解約は取り消されます。または [email protected] にお問い合わせください。
ライセンス
MIT — LICENSE を参照してください。ドキュメントのみです。サーバーはホスト型です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。