Whalesync MCP Server

Whalesync MCP Server とは？

Whalesync MCP Server は Whalesync 公式のリモート MCP エンドポイントです。Claude、ChatGPT、Cursor、VS Code の AI エージェントが、API キーではなくブラウザでのサインインを使って、Whalesync の同期と Live Export をあなたの代わりに作成・設定・監視できます。

Whalesync は Airtable、Notion、Webflow、HubSpot、Salesforce、Google Sheets、Postgres、Supabase などのツール間でデータを同期し続けます。同期の設定には、テーブルの選択、フィールドのマッピング、問題の監視が必要です。MCP サーバーを使えば、作りたい同期を説明するだけ（「Airtable の商品テーブルを Webflow CMS と同期させて」）でエージェントが下書きを作成し、承認は引き続き人が Whalesync アプリで行います。サーバーは Whalesync REST API と同じリソース、ID、エラーコードを使います。

Whalesync MCP Server の使い方

Whalesync アカウントが必要です。クライアントに必要なのはサーバー URL だけです。

https://api.whalesync.com/mcp

設定にキーやシークレットは入りません。エージェントが初めてサーバーを呼び出すと、ブラウザで Whalesync の同意ページが開きます。サインインし、要求されたアクセスを確認して Connect をクリックします。

Claude Code

claude mcp add --transport http whalesync https://api.whalesync.com/mcp

初回利用時にブラウザでサインインが開きます（/mcp から開始することもできます）。

Claude Desktop と claude.ai

Whalesync は Claude のコネクタディレクトリに掲載されています。Settings > Connectors > Browse connectors で見つけて Connect をクリックします。組織がディレクトリのコネクタを制限している場合は、URL https://api.whalesync.com/mcp でカスタムコネクタを追加できます。Claude は初回利用時に Whalesync のサインインを開きます。

Cursor

~/.cursor/mcp.json、またはプロジェクトの .cursor/mcp.json に次を追加します。

{
  "mcpServers": {
    "whalesync": {
      "url": "https://api.whalesync.com/mcp"
    }
  }
}

VS Code

Whalesync のドキュメントに記載されているコマンド：

code --add-mcp '{"name":"whalesync","type":"http","url":"https://api.whalesync.com/mcp"}'

または .vscode/mcp.json に "type": "http" とこの URL で同じサーバーを追加します。

ChatGPT、Codex、Grok

Whalesync は ChatGPT のアプリディレクトリにも掲載されており、ドキュメントでは Codex（codex mcp add whalesync --url https://api.whalesync.com/mcp のあと codex mcp login whalesync）と Grok のカスタムコネクタについても説明しています。

Whalesync MCP Server の主な機能

• Whalesync が公式にホストしており、インストール不要です。
• API キー不要の OAuth ブラウザ同意。クライアントが要求したより弱いスコープは付与できますが、強いスコープは付与できません。
• 3 つのスコープ：read（同期、マッピング、ステータス、オペレーション、課題、レコードの閲覧）、operate（一時停止、有効化、再試行、Live Export の実行を追加）、readwrite（同期、マッピング、Live Export の作成・編集・削除を追加）。
• 同期ツールは sync_ で始まり（例：sync_list、sync_create、sync_get_status）、Live Export ツールは live_export_ で始まります。
• sync_whats_next と live_export_whats_next が、セットアップの進捗と次にやるべきことをエージェントに伝えます。
• 人が関与するステップ：OAuth アプリの接続、新規または編集した同期の承認、保留中の削除の承認は、常にブラウザで行います。
• 接続済みのエージェントは Settings > MCP に一覧表示され、そこで取り消せます。

Whalesync MCP Server のユースケース

• 説明から同期を作成：「Airtable の Products テーブルと Webflow の Products コレクションの双方向同期を作り、対応するフィールドをマッピングして」
• 状態の監視：「失敗している同期はある？未解決の課題とその原因を一覧にして」
• 修正と再試行：operate スコープがあれば、課題の再試行や、フィールド修正中の同期の一時停止をエージェントに頼めます。
• レコードの確認：「このレコードの同期状態は？削除レビューのキューに保留中のものはある？」
• Live Export：Live Export の設定、ソーステーブルの選択、スケジュール設定、実行のトリガーをエージェントに任せます。

Whalesync MCP Server のトラブルシューティング

• 401 または認可の期限切れ：クライアントから再接続してください。接続が Settings > MCP に表示されなくなっている場合は取り消されているため、再接続すると同意手続きが再度行われます。
• 同意ページに「Connection request has expired」：クライアントが接続を開始してから 10 分以上経過しています。クライアントから再試行してください。
• 同期が開始しない：新規および編集した同期は、Whalesync アプリで人がレビューして承認する必要があります。エージェントがレビュー用リンクを送ります。
• エージェントが何も変更できない：付与したスコープを確認してください。read 接続は閲覧のみです。編集させたい場合は再接続して readwrite を付与します。
• レート制限：リクエストはユーザーごとに毎分 120 件までです。