Pullpush

PullPush MCP — 任意の 2 つの API を接続して同期を維持

PullPush.ai の公式 MCP サーバーです。EC ストア、倉庫、マーケットプレイス、ERP、POS システムを接続し、在庫数、注文、商品をすべてのシステム間で同期する統合プラットフォームです。

このサーバーを使うと、AI エージェント（Claude、Cursor、または Model Context Protocol に対応するあらゆるもの）が、こうした 統合を最初から最後まで構築、実行、監視できます。2 つのシステムを接続し、安全に同期をプレビューしてから、本番環境に切り替えられます。 人がダッシュボードを操作する必要はありません。

エージェントに選ばれる理由

• 決定論的な実行環境で、重要な処理経路に LLM は介在しません。 AI は構築時（コネクターの 生成、フィールドマッピングの提案）に役立ちます。同期エンジン自体は予測可能で、バージョン管理され、 可観測性を備えています。
• デフォルトで安全です。 新しいフローは シャドーモード（読み取り専用）で開始します。pullpush.sync action:"preview" は、データを書き込む前に、ソースと宛先の差分を構造化して表示します。
• 認証情報がマシンや環境変数に触れることはありません。 接続シークレットは作成された時点で、 サーバー側でエンベロープ暗号化されます（AES-256-GCM、テナントごとのキー）。
• 自己記述型です。 MCP プロンプト get-started が、何もない状態から動作する統合までを案内します。 pullpush:// リソースからツールカタログ、クイックスタート、エージェントガイドを利用できるため、 事前説明は必要ありません。
• 構造化され、実行につながるエラーです。 エラーは {code, suggestion, suggestedTool, retryable} を返すため、エージェントは次の手順を常に把握できます。
• サーバーグレードの信頼性を備えています。 サーキットブレーカー、キーごとの順序付き配信、冪等性、 リトライ付きのデッドレターキュー、指数バックオフを備えています。

サインアップなしで 60 秒で試す

curl -X POST https://api.pullpush.ai/api/sandbox

無料の 48 時間サンドボックステナントが返されます。API キー、すぐに貼り付けられる MCP 設定、 在庫データが意図的に一致しない、事前接続済みのデモ接続 2 つが含まれています。そのため、最初の pullpush.sync action:"preview" では、実際の正規化された差分（数量の不一致、欠落項目、同期済みの行）が表示されます。 サンドボックスは期限が切れると自動削除されます。引き続き利用する場合は、 POST /api/sandbox/claim（Bearer = サンドボックスキー、{"email": "..."}）を実行すると、 構築した内容をすべて保持したまま、永続的な無料テナントに変換されます。

クイックスタート

ホストされたエンドポイントに直接接続します。最も堅牢な方法です。マシン上では何も実行されないため、 プロセスがクラッシュしたり、古い状態になったりすることはありません。

{
  "mcpServers": {
    "pullpush": {
      "type": "streamable-http",
      "url": "https://api.pullpush.ai/mcp",
      "headers": { "Authorization": "Bearer <your-api-key>" }
    }
  }
}

これを ~/.cursor/mcp.json（Cursor）、Claude Desktop の設定、またはクライアントの MCP 設定に追加します。

stdio のみに対応するクライアント

このパッケージをローカル stdio プロキシとして使い、同じエンドポイントに接続します。バージョンを固定して一度インストールし、 バイナリを実行してください。クライアントがサーバーを起動するたびにパッケージを再解決し（ネットワーク接続も必要になる） npx ...@latest を使わないでください。

npm i -g [email protected]

{
  "mcpServers": {
    "pullpush": {
      "command": "kaduno-pullpush-mcp",
      "env": { "PULLPUSH_API_KEY": "<your-api-key>" }
    }
  }
}

API に接続できなくても、プロキシは終了しません。起動してクライアントに応答し、バックグラウンドで接続します （指数バックオフを使用し、Retry-After に従います）。ネットワークの一時的な切断や API の再起動後には再接続します。 オフライン中のツール呼び出しは、何も変更しないリトライ可能な「再接続中」エラーを返します。 ツールカタログはディスクにキャッシュされるため、API が停止中でも再起動後にツールが一覧表示されます。

エージェントに get-started プロンプトを実行するよう依頼してください。全体の流れを案内します。 コネクターのカタログ化 → 接続の作成とテスト → フィールドマッピングの提案 → シャドーモードでのフロー作成 → 差分のプレビュー → 本番環境への切り替え。

API キーの取得

使い捨てのキーには、上記のサンドボックスを使用してください。永続的なテナントを利用するには、次の手順を実行します。

1. 無料で登録（接続 1 件、月間イベント数 1,000 件 — クレジットカード不要）
2. 管理パネル → 設定 → API Keys
3. 必要なスコープ（テナント、組織、または管理者）でキーを作成します

ツール

48 個のツール（30 個の明示的なツールに加え、18 個のドメインルーターにわたる 188 個のアクション）で、統合のライフサイクル全体をカバーします。明示的なツールにはそれぞれ個別の名前が付いています。ドメインルーターは、複数の操作に対応する action パラメーターを受け取ります。

接続

• pullpush.connection.create — 外部システム（Shopify、WooCommerce、Linnworks、Xero、HubSpot など 20 以上）への接続を作成して設定します
• pullpush.connection.test — 接続認証情報をライブでテストし、健全性メトリクスと失敗回数を返します
• pullpush.connection — 接続の一覧表示、取得、更新、削除、設定を行います（アクション：list、get、update、delete、health、config に対応するルーター）

フロー

• pullpush.flow.create — トリガー、マッピング、正規データモデルを使用して、ソース→宛先の同期パイプラインを構築します
• pullpush.flow.dryRun — 配信せずにフローの変換／フィルター処理を通してイベントをドライランし、マッピング済みのペイロードを返します
• pullpush.flow.natural — 自然言語の説明からフローを作成します。マッピングを提案し、シャドウモードで作成します
• pullpush.flow — フローの一覧表示、取得、更新、一時停止／再開、削除、配信履歴の表示を行います（ルーター）

同期と照合

• pullpush.sync.reconcile — 照合して配信します。ソースと宛先の差分を確認し、アイテムごとの進捗を示しながら変更を配信します
• pullpush.sync — 差分のプレビュー、データのスナップショット取得、単一キーの調査、カタログのスキャン、未照合の SKU の診断、ベースラインの管理を行います（アクション：preview、snapshot、inspect、reconcile、scan、reset-baseline、baseline.history、baseline.rollback、channel-cache、unmatched に対応するルーター）

フィールドマッピング

• pullpush.mapping.suggest — ソースのサンプルからターゲットの形式へのフィールドマッピングを AI が提案し、マッピング、信頼度、プレビューを返します
• pullpush.mapping.validate — ソースと宛先のスキーマに照らしてマッピング設定を検証します
• pullpush.mapping.compare — 2 つのマッピングを並べて比較します
• pullpush.mapping.explain — マッピングによるデータ変換の手順を説明します
• pullpush.mapping.diff — 2 つのマッピングバージョンの差分を確認し、変更点を把握します
• pullpush.mapping.get — フローの現在のマッピング設定、ソースフィールド、宛先フィールドを取得します

診断

• pullpush.explain — フロー、接続、または配信が失敗した理由を診断します。エラーを収集し、パターンを特定して、修正方法を提案します
• pullpush.diagnose.recent — すべてのフローをスキャンして最近の失敗を調べ、優先順位付きの問題一覧を返します
• pullpush.ask — テナントの失敗や異常をもとに、運用に関する自然言語の質問に回答します

コネクターの作成

• pullpush.connector.generate — AI が TypeScript コネクターコードを生成し、型チェックとテストを行って登録します
• pullpush.connector — コネクター定義の一覧表示、取得、更新、管理を行います（ルーター）

データ操作

• pullpush.data.push — ファイルデータ（CSV、JSON、XML）を接続に送信します
• pullpush.import — ファイルベースのデータインポート操作を行います（ルーター）
• pullpush.export — スケジュールされたエクスポートパイプラインの作成、一覧表示、更新、削除、テスト、実行を行います（ルーター）
• pullpush.canonical — 正規データモデルの確認と管理を行います（ルーター）

シャドウモードと安全性

• pullpush.shadow — 統合を読み取り専用で実行してから本番稼働に移行し、シャドウ結果とライブ結果を比較します（ルーター）

一括操作

• pullpush.batch.test — 複数の接続を並列でテストします
• pullpush.batch.status — すべてのフローのステータスマトリックスを取得します
• pullpush.batch.setup — 1 回の操作で接続とフローを作成し、テストまで行います
• pullpush.batch — 複数フローの一括操作とプロアクティブレポートを行います（ルーター）

運用と健全性

• pullpush.health.overview — テナントの健全性ダッシュボード：接続、フロー、失敗、バックログ、配信率、異常
• pullpush.health.mcp — MCP サーバーの健全性：データベース、登録済みツール、稼働時間
• pullpush.ops — 異常検知、デッドレターの復旧、運用監視（ルーター）

ワークフロー

• pullpush.workflow.create — トリガーとステップ DAG を含む複数ステップのワークフローを作成
• pullpush.workflow.trigger — 既存のイベントからワークフローの実行を手動でトリガー
• pullpush.workflow — ワークフローの一覧表示、取得、管理（ルーター）

インテグレーションとマーケットプレイス

• pullpush.integration.create — フロー／ワークフローを1つの名前でまとめるインテグレーションを作成
• pullpush.integration — インテグレーションの一覧表示と管理（ルーター）
• pullpush.marketplace.install — マーケットプレイスのリスティングをテナントにインストール
• pullpush.marketplace — マーケットプレイスのコネクターを閲覧、管理（ルーター）
• pullpush.destination.provision — 宛先 API にカスタムフィールドをプロビジョニング（例：HubSpot のプロパティ）

管理

• pullpush.tenant — テナント管理：一覧表示、取得、作成、更新（ルーター）
• pullpush.billing — サブスクリプションと使用状況の管理（ルーター）
• pullpush.partner — パートナープログラムの運用（ルーター）
• pullpush.backup — バックアップと復元の操作（ルーター）
• pullpush.feedback — MCP ツールの品質や不足している機能についてフィードバックを送信

ツールの全リファレンス：pullpush.ai/docs/mcp

環境変数

変数	必須	デフォルト	説明
PULLPUSH_API_KEY	はい	—	PullPush API キー
PULLPUSH_API_URL	いいえ	https://api.pullpush.ai	API ベース URL（セルフホスト環境での上書き用）
PULLPUSH_CACHE_DIR	いいえ	OS のキャッシュディレクトリ	ツールカタログのキャッシュ先
PULLPUSH_TIMEOUT_MS	いいえ	55000	プロキシがタイムアウトエラーを返すまでにツール呼び出しを待機する時間

認証スコープ

スコープ	アクセス
テナントキー	テナントの接続、フロー、同期、診断
組織キー	組織内のすべてのテナント（読み取り、または読み取り＋書き込み）
管理者キー	プラットフォーム全体へのフルアクセス（請求、パートナー、すべてのテナント）

ツールは自動的にスコープが設定されます。テナントキーで他のテナントのデータが表示されることはありません。

機能

• 接続に問題があっても停止しません：API が停止していても起動し、自動的に再接続します。 その間、キャッシュ済みのツールカタログを提供します
• 自動更新：ツールカタログは5分ごとに更新されます。再起動しなくてもサーバー側の新しいツールが表示されます （カタログに実際の変更があった場合のみ、クライアントに通知されます）
• オフラインでのクイックスタート：組み込みの pullpush://docs/quickstart-local リソースは、 ネットワーク接続なしで使用できます
• 不明なツールの再試行：ツールが見つからない場合、カタログを自動的に更新します
• 明確なエラーメッセージ：認証の失敗、ネットワークの問題、バージョンの不一致について説明します

ドキュメント

• はじめに — 5分で最初のインテグレーションを開始
• MCP ガイド — ツールの全リファレンスとクライアントのセットアップ
• シャドウモード · プレビューと照合 · セキュリティ
• llms.txt — 機械可読な製品概要
• 機械可読なインテグレーションカタログ
• MCP レジストリエントリー：ai.pullpush/pullpush-mcp

pullpush-mcp-dev も利用可能

コネクターの作成者、プラットフォーム管理者、社内開発者向けに、 pullpush-mcp-dev では、次の追加ツールを利用できます。

• AI を活用したコネクターの生成と構成
• 標準スキーマの管理
• マーケットプレイスへの公開
• 請求とパートナーの管理
• すべてのテナントを対象とした一括操作

開発

git clone https://github.com/Kaduno-systems/pullpush-mcp.git
cd pullpush-mcp
npm install
npm run dev    # Run from source via tsx
npm run build  # Compile with tsup

このリポジトリは、MCP クライアントパッケージの公開ミラーです。プラットフォーム自体は、非公開のモノレポで開発されています。問題や質問は、こちらまたは [email protected]までお寄せください。

ライセンス

MIT

開発

開発はPullPushプラットフォームのモノレポで行われます。Kaduno-systems/pullpush-mcpリポジトリは、各リリースの公開ミラーです。問題はそちらにお寄せください。コードの変更はモノレポ経由で反映されます。