Whooshly

Whooshly MCP

AI アシスタントにキャンペーンリンク用ツールキットを追加しましょう。Whooshly はホスト型の Model Context Protocol サーバーを提供しており、Claude、ChatGPT、あらゆる MCP クライアントが会話から直接、短縮リンク、動的な QR コード、UTM テンプレート、ホスト型 vCard ページ、リード情報を取得する ランディングページを作成し、実際のクリック数やスキャン数の分析データを読み取れます。

「このローンチ URL を短縮して、チラシ用の QR コードを作り、有料ソーシャルキャンペーン用の UTM テンプレートを保存して」→ 1 つのメッセージで 3 つのツールを使い、自分が所有するリンクを作成できます。

• 🔗 クリック数をリアルタイムで追跡できる、whooshly.co の 短縮リンク
• 🟧 チャット内にスキャン可能な PNG として返される 動的 QR コード
• 🏷️ キャンペーン間で再利用できる UTM テンプレート
• 📇 ホスト型の vCard デジタル名刺
• 📊 実際の分析データ – リンクごとの正確なクリック数／スキャン数と日別データ
• 💸 一度だけのお支払い。 コアツールキットを一度限りの料金で利用可能にできます。サブスクリプションはありません。料金を見る →

サーバーはホスト型なので、URL ベースのクライアントでは何も実行する必要はありません。この npm パッケージは、リモート MCP にまだ対応していないクライアント（Claude Desktop など）向け、および npx で手軽に使うための小さな stdio ブリッジです。

---

1. エージェントトークンを取得する

各ツールはあなたの Whooshly アカウントで動作するため、トークンが必要です。

1. app.whooshly.co にサインインします
2. Agents → New token を開きます
3. トークンをコピーします（一度だけ表示されます）

読み取りと書き込みには、一度限りの Core のロック解除が必要です。get_billing_status はどのアカウントでも使用できるため、エージェントは操作を実行する前に状態を確認できます。

---

2. 接続する

Claude.ai / Claude（ウェブ、デスクトップ、モバイル） – URL で接続、インストール不要

リモートサーバーを指定する Custom Connector を追加します。Claude はブラウザーで OAuth フローを実行します。承認するとツールが表示されます。

https://app.whooshly.co/api/mcp

Settings → Connectors → Add custom connector → URL を貼り付けます。

ChatGPT – URL で接続

同じ URL を使ってコネクター／カスタム MCP サーバーを追加します。

https://app.whooshly.co/api/mcp

Claude Code – 1 つのコマンドで接続

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp

その後、Claude Code 内で /mcp を使って認証するか、トークンヘッダーを渡します。

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp \
  --header "Authorization: Bearer $WHOOSHLY_TOKEN"

Claude Desktop（または任意の stdio クライアント） – このブリッジを使用

stdio のみをサポートするクライアントでは、このパッケージを使用します。claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "whooshly": {
      "command": "npx",
      "args": ["-y", "whooshly-mcp"],
      "env": {
        "WHOOSHLY_TOKEN": "your-agent-token"
      }
    }
  }
}

これで完了です。クライアントを再起動すると、Whooshly のツールを利用できます。

---

ツール

ツール	機能	アクセス
get_billing_status	アカウントで Core / Pro がロック解除されているか確認します	すべて
create_link	短縮リンクを作成します → ID、スラッグ、短縮 URL	Core
list_links	自分のリンクを新しい順に一覧表示します（カーソルページネーション）	Core
get_link_stats	リンクの正確なクリック数／スキャン数と日別データを取得します	Core
create_qr	動的 QR コードを作成し、スキャン可能な PNG として返します	Core
get_qr	保存済みの QR コードを PNG として再取得します	Core
create_utm	再利用可能な UTM テンプレートを保存します	Core
list_utm	保存済みの UTM テンプレートを一覧表示します	Core
create_vcard	ホスト型デジタル名刺（vCard）ページを作成します	Core
create_page	コンテンツブロックからサブドメイン上にランディングページを作成します	Core
update_page	ページのブロック、テーマ、スラッグを編集します。削除は行いません	Core
list_pages	リード数とともに自分のランディングページを一覧表示します	Core
get_page	1 つのページのコンテンツ、リード数、Webhook 配信の集計情報を取得します	Core
search	スラッグ／リンク先で自分のリンクを検索します（詳細調査）	Core
fetch	ID で指定した 1 つのリンクの詳細をすべて取得します（詳細調査）	Core

すべての読み取りツールには readOnlyHint が注釈されており、書き込みツールでできるのは作成または編集のみです。エージェントが何かを削除したり、リードの個人情報を読み取ったり（件数のみ）、リードの Webhook を確認または変更したりすることはありません。各ツールはあなた自身のアカウントのみを対象に動作します（openWorldHint: false）。

---

プロンプトの例

接続したら、次を試してみてください：

• 「https://example.com/2026-summer-launch を summer26 というスラッグで短縮し、QRコードを表示してください。」
• 「ソース instagram、メディア cpc、キャンペーン summer-launch の UTM テンプレートを paid-social という名前で作成してください。」
• 「今週、summer26 のリンクは何回クリックされましたか？」
• 「Acme のグロース責任者である Jane Doe の vCard を作成してください。メールアドレスは [email protected] です。」

---

設定

環境変数	デフォルト	用途
WHOOSHLY_TOKEN	–	stdio ブリッジに必須です。エージェントトークンです。
WHOOSHLY_MCP_URL	https://app.whooshly.co/api/mcp	エンドポイントを上書きします（セルフホスト／ステージング）。

WHOOSHLY_API_TOKEN は WHOOSHLY_TOKEN のエイリアスとして使用できます。

---

ブリッジの仕組み

whooshly-mcp は stdin から改行区切りの JSON-RPC を読み取り、各メッセージをベアラートークンとともにホストサーバーへ POST し、対応する応答を stdout に書き込みます。npm 依存関係は一切なく（Node 18 以降の組み込み機能のみを使用）、小さく、監査も容易です。ブリッジ全体が 1 つのファイルに収まっています：bin/whooshly-mcp.mjs。

認証、レート制限、利用資格の確認、QR コードの生成、分析などの主要な処理は、すべて Whooshly 上のサーバー側で行われます。このブリッジはトランスポートの中継にすぎません。

---

リンク

• ウェブサイト： https://whooshly.co
• MCP サーバー／接続ガイド： https://whooshly.co/mcp
• アプリ／ダッシュボード： https://app.whooshly.co
• MCP エンドポイント： https://app.whooshly.co/api/mcp

ライセンス

MIT © Whooshly