mcpField
S
Spree Commerce: open-source B2B and marketplace ecommerce

Spree Commerce: open-source B2B and marketplace ecommerce

リモート
spreecommerce.orgその他15.8k今日更新
リポジトリ公式サイト

Spree Commerce: open-source B2B and marketplace ecommerce について

Spree バックオフィス向けの MCP サーバーです。MCP クライアントから自然言語でカタログ管理、レポートの照会、ストア設定を行えます。ツールは Spree API キーのテナンシーと権限に従い、spree_core が提供します。

主な機能

  1. 01商品カタログの管理
  2. 02業務レポートの照会
  3. 03ストア設定の管理
  4. 04API キーのスコープによるツール表示制御
  5. 05spree_core のツールと権限の再利用

活用シーン

  1. 01エージェントで商品構成を調整
  2. 02自然言語で売上レポートを確認
  3. 03付与された権限内でストアを設定

MCP 対応

POST /api/v3/admin/mcp で Spree バックオフィスのツールを MCP クライアントに公開し、Spree secret API key で認証します。認証情報のスコープが利用可能なツールを決め、定義と権限制御は spree_core にあります。

設定

リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。

エンドポイントhttps://{store_domain}/api/v3/admin/mcp
インストールコマンドをコピー
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。

ツール

詳細

Spree MCP Server

Spree バックオフィス向けのModel Context Protocolサーバーです。Claude Code、Cursor、社内エージェントなど、あらゆる MCP クライアントから、Admin API と同じテナントおよび権限ルールのもと、カタログのマーチャンダイジング、レポートに関する質問への回答、ストア設定の管理を自然言語で行えます。

spree add mcp   # or add gem 'spree_mcp' to the Gemfile

エンドポイントは POST /api/v3/admin/mcp です。Spree のシークレット API キーを X-Spree-API-Key: sk_… または Authorization: Bearer sk_… として送信し、認証します。キーのスコープによってモデルに提示されるツールが決まるため、エージェントが、認証情報で利用できない機能を知らされることはありません。

この gem はプロトコルアダプターであり、それ以上のものではありません。ツール、そのスキーマ、およびそれらを制御する権限は spree_core の Spree.admin_agent_tools にあります。そのため、拡張機能はこの gem に依存せずにツールを登録でき、ダッシュボードアシスタントは別のトランスポート経由で同じツールを提供できます。

ドキュメントと docs/plans/6.0-mcp-server.md を参照してください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。