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 앱을 고른 다음 설정을 복사하세요.
GATEWAY_URL, DEFAULT_SITE_ID필요한 것
어떤 앱을 쓰세요?
위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.
웹, 데스크톱, 모바일의 Claude에서 쓸 수 있어요:
https://api.synchronity.app/mcpClaude Desktop → Settings → Developer → Edit Config를 열고 claude_desktop_config.json에 이 내용을 붙여 넣으세요
{
"mcpServers": {
"synchronity": {
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}터미널에서 이 명령어를 실행하세요
claude mcp add --transport http synchronity https://api.synchronity.app/mcpclaude mcp add synchronity --env GATEWAY_URL=your-value --env DEFAULT_SITE_ID=your-value -- npx -y @synchronity/mcp-server실행하기 전에 빈 값을 채워 주세요.
프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"synchronity": {
"url": "https://api.synchronity.app/mcp"
}
}
}프로젝트의 .cursor/mcp.json 또는 ~/.cursor/mcp.json에 붙여 넣으세요
{
"mcpServers": {
"synchronity": {
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"synchronity": {
"type": "http",
"url": "https://api.synchronity.app/mcp"
}
}
}프로젝트의 .vscode/mcp.json에 붙여 넣으세요
{
"servers": {
"synchronity": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@synchronity/mcp-server"
],
"env": {
"GATEWAY_URL": "your-value",
"DEFAULT_SITE_ID": "your-value"
}
}
}
}브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.
ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요:
https://api.synchronity.app/mcp메뉴 이름은 요금제나 시기에 따라 조금 다를 수 있어요.
선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.
GATEWAY_URL envDEFAULT_SITE_ID env이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 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월 11일 점검
레지스트리 이름이 GitHub 계정 themewireco 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
코드 마지막 변경: 4개월 전
아직 GitHub에서 이 저장소를 읽어 오지 않았어요
288ms 만에 응답(HTTP 200)
로그인 필요 없음
도구 설명 26개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 4개 중 4개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.
GitHub 저장소는 마지막으로 4개월 전 변경됐고, 최신 버전(0.5.21)은 4개월 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.
같은 카테고리에는: Spree Commerce developer docs for AI agents, Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP
같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
Spree Commerce docs for AI coding agents: build headless B2B and marketplace ecommerce on its APIs.
Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
MCP server integrating with Stripe - tools for customers, products, payments, and more.
제작자의 저장소에서 쓰인 그대로 가져왔어요. 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.