Spree Commerce developer docs for AI agents
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Shop connected e-commerce stores: search, compare, cart, and checkout with buyer approval.
使っているAIアプリを選んで、設定をコピーしてください。
チェック 5/5 合格 · 質問内容は提供元のサーバー(api.synchronity.app)を通ります · ✓ コマンド確認済み 2026年11月13日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげます · 約 2 分
キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
CustomizeConnectors
ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します
Synchronityhttps://api.synchronity.app/mcpClaude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します
+ConnectorsSynchronity
Synchronity を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が Synchronity を使っていると言うか、回答に Synchronity のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT との接続はプランしだい
フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ
Plugins+Add custom MCP server
名前を入れ、Connection にアドレスを貼り付け、注意事項にチェックして Create as a plugin を押します
Synchronityhttps://api.synchronity.app/mcp新しいチャットを開き、入力前にプラグインの一覧から Synchronity を選びます
Synchronity を使って、私に何ができるか教えて、1 つやってみせて✓ ChatGPT が Synchronity を使っていると言うか、回答に Synchronity のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Claude Code につなげます · 約 2 分
キー不要、インストール不要
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --transport http --scope user synchronity https://api.synchronity.app/mcpSynchronity が一覧にあり、接続済みと表示されれば OK です
Synchronity を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が Synchronity を使っていると言うか、回答に Synchronity のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげます · 約 2 分
キー不要、インストール不要
Synchronity を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が Synchronity を使っていると言うか、回答に Synchronity のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげます · 約 2 分
キー不要、インストール不要
Synchronity を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が Synchronity を使っていると言うか、回答に Synchronity のツール名が出れば接続成功です
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
Web 経由でつなぐアプリ用のアドレス
https://api.synchronity.app/mcpJSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --transport http --scope user synchronity https://api.synchronity.app/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"synchronity": {
"url": "https://api.synchronity.app/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"synchronity": {
"type": "http",
"url": "https://api.synchronity.app/mcp"
}
}
}Claude Code
claude mcp add --scope user synchronity --env GATEWAY_URL=your-value --env DEFAULT_SITE_ID=your-value -- npx -y @synchronity/mcp-serverClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"synchronity": {
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"synchronity": {
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"synchronity": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}GATEWAY_URL envDEFAULT_SITE_ID envこの設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
npm: @synchronity/mcp-serverこのサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
インターネット経由でつなげるアプリ
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
ツールの名前と説明は、サーバーが2026年11月10日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。
list_sitesList all registered e-commerce sites. Use this first to find a site by name (e.g. "Pronto Partners") and get its site_id, which is required by all other tools.
search_productsFind products on a registered store. To BROWSE a store's catalog (open-ended requests like "what do they sell", "show me what's available"), call with NO query — this returns the store's products. To SEARCH, pass `query` (a product name/keyword). Returns paginated products as an
get_productRetrieve detailed information about a specific product including variants, pricing, images, and availability. May also return `addons` — customer-selectable options defined by the store (e.g. engraving, gift wrap, size add-ons). When a product has addons, present them to the buye
get_product_reviews🔍 **RECOMMENDED STEP** — Fetch product reviews and authenticity consensus before making purchase decisions. Returns: average rating, trust score (0.0-1.0), review sentiment analysis, authenticity flags (fake reviews, seller issues, negative trends), and recent reviews with verif
request_back_in_stockSubscribe the buyer to a back-in-stock alert for an out-of-stock product. Use when the buyer asks to be notified/told/pinged when an item restocks ("notify me when X is back", "let me know when it's in stock"). Collect the buyer's email so the alert can reach them (without it onl
compare_productsCompare products across multiple registered e-commerce sites simultaneously. Uses fail-open strategy: partial results from successful sites are returned even if some sites time out.
create_cartCreate a new shopping cart for a specific site. Returns a cart_id. IMPORTANT: Reuse the active cart_id across multiple products in the same session. Do NOT call create_cart again if you already have a cart_id for this site in the chat history.
add_to_cartAdd a product variant (or base product) to an existing cart. Reuse the active cart_id from the chat history if one already exists. Only call create_cart first if no cart exists yet.
quick_checkoutAssemble checkout-ready cart(s) in ONE call for a multi-product (and optionally multi-store) request. Creates a cart per store, adds all items, and sets the shipping address — then returns the cart(s) with delivery options to choose. Use this when the buyer lists several products
remove_from_cartRemove a line item from the cart. Requires the item_id from the cart contents.
set_cart_quantitySet a cart line's quantity (the server cart is the checkout source of truth, so this updates it live). Requires the item_id from the cart contents and the new absolute quantity. A quantity of 0 removes the line. Returns the updated cart card.
apply_couponApply a discount or promotional code to the cart. Returns the updated cart with discount applied.
get_cartRetrieve current cart contents, including items, pricing, discounts, and totals. The card already shows the line items and totals to the user, so keep your text reply to one brief sentence — do not re-list the cart contents.
get_active_cartRetrieve the buyer's in-progress cart for a site (resumes a conversation). Call this before assuming a new cart when a shopping conversation continues or after a cart error. Returns the cart with its items rebuilt if the connector cart expired, or null if no cart exists.
set_shipping_addressSet the cart shipping destination (collected from the buyer) and return available shipping options with costs. Call after items are in the cart and before select_shipping_option. country_code is required; include postal_code/state for accurate rates.
select_shipping_optionSelect one of the shipping options returned by set_shipping_address. Binds the rate to the cart so the total includes shipping; call before execute_checkout so the hosted checkout opens pre-filled.
execute_checkoutExecute checkout for a cart to create an order. Requires a buyer delegation token (from user auth) and a shipping address. The order is created UNPAID (status "pending"). IMPORTANT — do NOT stop here or just hand the user the payment_url. Immediately continue the in-chat payment
get_orderRetrieve details for an order by its ID, including items, status, shipping, and tracking information. Orders are buyer-private — pass `buyer_delegation_token` (the delegation token from this buyer's checkout approval) so the gateway can confirm the buyer owns this order. If check
list_ordersList recent orders for a site, optionally filtered by status (pending, processing, completed, cancelled, refunded). Orders are buyer-private — pass `buyer_delegation_token` (from this buyer's checkout approval); only that buyer's orders are returned.
request_delegationStart the human delegation (approval) flow needed for checkout/payment. PREFERRED: pass the buyer's `email` — the gateway emails them a 6-digit code and returns a device_code; ask the user for the code and call submit_delegation_otp. This keeps approval fully in-chat (no link) an
submit_delegation_otpSubmit the 6-digit code the buyer received by email (from request_delegation with an email) to approve the delegation in-chat. On success returns a delegation_token to use as buyer_delegation_token for checkout/payment. You cannot obtain this code yourself — the user must read it
check_delegationPoll for human approval of a delegation request. When status is "approved", returns the delegation_token to use as buyer_delegation_token in execute_checkout.
get_payment_methodsSTEP 1 of the in-chat payment flow. Returns the payment channels available for an order (e.g. "mobile_money", "card") plus a `gateways` array of the enabled payment gateways (each with id, label, and its channels). When more than one gateway is listed, ask the buyer which they wa
initiate_paymentSTEP 2 of the in-chat payment flow. Starts a payment session for an order and returns a PaymentSession with an `instruction` the agent renders in chat. REQUIRES a buyer_delegation_token — obtain it exactly like execute_checkout: call request_delegation, have the user approve in c
submit_payment_otpSTEP 3 (mobile_money only, when initiate_payment returned instruction.action == "submit_otp"). Submits the one-time password the buyer received to authorise the mobile-money charge. REQUIRES the same buyer_delegation_token used for initiate_payment. After submitting, poll get_pay
get_payment_statusFINAL STEP of the in-chat payment flow. Returns the current PaymentSession for an order. Poll this (every ~5 seconds) after initiate_payment/submit_payment_otp until payment_status becomes "paid" or "processing" (success — the order is confirmed) or "failed" (tell the user; they
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月14日にチェック
質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
GitHubリポジトリの最終更新は4 か月前、最新バージョン(0.5.21)がレジストリに届いたのは4 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。
同じカテゴリには:Spree Commerce developer docs for AI agents, Stripe MCP, Sessy — Amazon SES observability
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Synchronity
Shop anything online with AI — search, compare, and buy across connected stores from any AI assistant.
Synchronity is commerce infrastructure for AI assistants. It connects to the hosted Synchronity gateway at https://api.synchronity.app — there is nothing to self-host.
This repository contains the public, MIT-licensed pieces:
| Part | What it is |
|---|---|
packages/mcp | The MCP server — exposes shopping tools to Claude, Cursor, and any MCP client |
packages/sdk | Typed gateway client used by the MCP server |
desktop-extension | Claude Desktop extension (.mcpb) source — a zero-dependency bridge to the gateway |
plugins/synchronity | Cross-assistant plugin (Claude Code + Codex) — install via the marketplace below |
woocommerce | The Synchronity WooCommerce plugin — makes a store agent-ready |
Releases attach prebuilt artifacts: the `synchronity.mcpb` desktop extension and the WooCommerce plugin zip. See Releases.
/plugin marketplace add themewireco/synchronity
/plugin install synchronity@synchronity
Then just shop — *"find me a birthday cake from my stores"*. The plugin bundles the synchronity-commerce skill and runs the MCP server locally via npx, so there is nothing to clone or build.
Add the Synchronity plugin from this repo (plugins/synchronity). Codex reads .codex-plugin/plugin.json and connects to the hosted MCP at https://api.synchronity.app/mcp, with the same synchronity-commerce skill.
npm install && npm run build
{
"mcpServers": { "synchronity": { "command": "node", "args": ["/absolute/path/to/synchronity/packages/mcp/dist/index.js"], "env": { "GATEWAY_URL": "https://api.synchronity.app" } } } }
GATEWAY_URL defaults to https://api.synchronity.app. Sensitive actions (checkout, payment) require buyer approval — the assistant walks you through a one-time approval step.
Product search & details (with inline images), compare across stores, reviews, cart management, shipping, checkout, card/mobile-money payment, order tracking, and human-in-the-loop approval for sensitive actions.
Your store keeps its own catalog, currency, shipping, and orders — Synchronity routes agent requests to it through the gateway.
npm run build # build the MCP server + client
npm run build:mcpb # -> synchronity.mcpb (Claude Desktop extension) npm run build:plugin # -> synchronity-woocommerce-v .zip
| Env var | Default | Purpose |
|---|---|---|
GATEWAY_URL | https://api.synchronity.app | Synchronity gateway base URL |
DEFAULT_SITE_ID | — | Optional default store to scope tools to |
DEBUG | false | Verbose logging to stderr |
New here or reviewing the connector? Follow the end-to-end walkthrough: docs/reviewer-testing.md.
MIT © Themewire — see LICENSE.