Synchronity

Synchronity

AI を使ってオンラインで何でも購入できます。AI アシスタントから、接続済みのストアを横断して検索、比較、購入できます。

---

Synchronity は、AI アシスタント向けのコマースインフラストラクチャです。ホスト型の Synchronity gateway（https://api.synchronity.app）に接続するため、セルフホストする必要はありません。

このリポジトリには、MIT ライセンスの公開コンポーネントが含まれています。

コンポーネント	内容
packages/mcp	MCP サーバー。Claude、Cursor、あらゆる MCP クライアントにショッピングツールを提供します
packages/sdk	MCP サーバーが使用する、型定義付きのゲートウェイクライアント
desktop-extension	Claude Desktop 拡張機能（.mcpb）のソース。ゲートウェイへの依存関係ゼロのブリッジです
plugins/synchronity	アシスタント横断型プラグイン（Claude Code + Codex）。以下のマーケットプレイスからインストールできます
woocommerce	Synchronity WooCommerce プラグイン。ストアをエージェント対応にします

リリースにはビルド済みの成果物が添付されています。synchronity.mcpb デスクトップ拡張機能と WooCommerce プラグインの zip です。リリースをご覧ください。

購入者向け — AI アシスタントを接続する

Claude Desktop（最も簡単）

1. 最新リリース（または api.synchronity.app/setup/download）から synchronity.mcpb をダウンロードします。
2. Claude Desktop で開き、Install をクリックします。
3. Claude に買い物を頼みます。例：「Synchronity でワイヤレスキーボードを検索して。」

Claude Code（プラグインマーケットプレイス）

/plugin marketplace add themewireco/synchronity
/plugin install synchronity@synchronity

あとは買い物を頼むだけです。「登録しているストアから誕生日ケーキを探して。」 プラグインには synchronity-commerce スキルが含まれており、npx を使って MCP サーバーをローカルで実行するため、 リポジトリのクローンやビルドは必要ありません。

Codex

このリポジトリ（plugins/synchronity）から Synchronity プラグインを追加します。Codex は .codex-plugin/plugin.json を読み込み、ホスト型 MCP（https://api.synchronity.app/mcp）に 接続します。synchronity-commerce スキルも同じものを使用します。

あらゆる MCP クライアント（手動）

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 のデフォルト値は https://api.synchronity.app です。機密性の高い操作（チェックアウト、支払い）には購入者の承認が必要です。アシスタントが、初回の承認手順をご案内します。

アシスタントでできること

インライン画像付きの商品検索と詳細確認、ストア横断での商品比較、レビュー確認、カート管理、配送、チェックアウト、カード／モバイルマネー決済、注文追跡、機密性の高い操作に対する人間参加型の承認に対応しています。

マーチャント向け — WooCommerce ストアをエージェント対応にする

1. 最新リリースから WooCommerce プラグインの zip をダウンロードします。
2. WordPress で Plugins → Add New → Upload Plugin を開き、zip を選択して Install、Activate の順にクリックします。
3. WooCommerce → Synchronity を開き、コネクターキーをコピーして、Synchronity にストアを登録します。

ストアの商品カタログ、通貨、配送、注文はそれぞれのストアで管理されます。Synchronity はゲートウェイを通じて、エージェントからのリクエストをストアにルーティングします。

成果物を自分でビルドする

npm run build         # build the MCP server + client
npm run build:mcpb    # -> synchronity.mcpb (Claude Desktop extension)
npm run build:plugin  # -> synchronity-woocommerce-v<version>.zip

設定

環境変数	デフォルト	用途
GATEWAY_URL	https://api.synchronity.app	Synchronity ゲートウェイのベース URL
DEFAULT_SITE_ID	—	ツールの対象にするデフォルトのストアを指定（任意）
DEBUG	false	詳細なログを標準エラー出力に記録

レビューとテスト

初めて利用する方やコネクターをレビューする方は、エンドツーエンドの手順ガイドをご覧ください：docs/reviewer-testing.md。

プライバシーとサポート

• プライバシーポリシー：PRIVACY.md · synchronity.app/privacy-policy
• サポート：[email protected]

ライセンス

MIT © Themewire — LICENSE をご覧ください。