Jumpseller

Jumpseller API ドキュメント

Jumpseller の EC プラットフォーム API の公式 OpenAPI 3.0.3 仕様です。

API の概要

Jumpseller API を使用すると、オンラインストアをプログラムから作成、管理できます。以下に対応しています。

• ストア - オンラインストアの作成、設定、管理
• 商品 - バリエーション、画像、カテゴリー、カスタムフィールドを含む完全な CRUD
• 注文 - 注文の作成、更新、検索、フルフィルメント
• 顧客 - 顧客アカウントとグループの管理
• 配送 - 配送方法と料金の設定
• 決済 - 決済ゲートウェイの設定
• テーマ - ストアのテーマの適用とカスタマイズ
• Webhook - ストアイベントの購読
• ページとカテゴリー - ストアのコンテンツとナビゲーションの管理

クイックスタート

ベース URL： https://api.jumpseller.com/v1

認証： ログイン情報と認証トークンを使用した Basic 認証（Admin Panel > Account で確認できます）。

curl -u YOUR_LOGIN:YOUR_AUTHTOKEN https://api.jumpseller.com/v1/products.json

リソース

• OpenAPI 仕様 - API 仕様の全内容- OpenAPI Light - 上位 30 個のエンドポイント。コードサンプルなし（ChatGPT、Copilot、その他、エンドポイント数に制限のある AI プラットフォーム向け）
• ライブ API リファレンス - インタラクティブなドキュメント
• OAuth 2 ガイド - Jumpseller アプリの構築向け

MCP サーバー（AI エージェント）

Jumpseller は、Claude、Cursor、Windsurf、GitHub Copilot などの AI エージェントに 20 個のストア管理ツールを提供する専用の Model Context Protocol (MCP) サーバーを提供しています。

サーバー URL： https://mcp.jumpseller.com

トランスポート： Streamable HTTP（POST 経由の JSON-RPC、ステートレス）

ドキュメント： jumpseller.com/support/mcp-server

クイックセットアップ

{
  "mcpServers": {
    "jumpseller": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.jumpseller.com/",
        "--header", "X-LOGIN-KEY:YOUR_LOGIN_KEY",
        "--header", "X-AUTH-TOKEN:YOUR_AUTH_TOKEN"
      ]
    }
  }
}

これを claude_desktop_config.json（Claude）、.cursor/mcp.json（Cursor）、または ~/.codeium/windsurf/mcp_config.json（Windsurf）に追加してください。認証情報は Jumpseller Admin > Settings > API から取得できます。

利用可能なツール

領域	ツール	アクセス
商品	list_products, get_product, search_products, create_product, update_product, delete_product	読み取り／書き込み
注文	list_orders, get_order, search_orders, update_order	読み取り／書き込み
顧客	list_customers, get_customer, search_customers	読み取り
カテゴリー	list_categories, create_category, delete_category	読み取り／書き込み
ページ	list_pages, create_page, delete_page	読み取り／書き込み
ストア	get_store_info	読み取り

商品ツールはバリエーション（サイズ、色）、画像、カテゴリーに対応しています。ツールは tools/list を介して自動検出されます。

認証

• API トークン： X-LOGIN-KEY + X-AUTH-TOKEN ヘッダー（ストアオーナー向け）
• OAuth 2.0： スコープ付き権限を持つ Authorization: Bearer <token>（サードパーティアプリ向け）。OAuth 2 ガイド を参照してください。

OpenAPI ベースの MCP（代替方法）

OpenAPI 仕様を介して接続し、API 全体（109 個のエンドポイント）を利用することもできます。

npx openmcp install https://api.jumpseller.com/swagger.json --client cursor

レート制限

• 1 分あたり 800 リクエスト
• 1 秒あたり 20 リクエスト
• レート制限ヘッダーはすべてのレスポンスに含まれます

ブランドと法的情報

• ロゴ： https://jumpseller.com/images/brand/jumpseller-logo-26.svg
• サポート： [email protected]
• 利用規約： https://jumpseller.com/terms/

ライセンス

このドキュメントは、プラットフォームとの連携を構築する開発者および AI エージェント向けに、Jumpseller が提供しています。