Linkly MCP Server

🚀 Linkly MCP Server

このMCP（Model Context Protocol）サーバーは、ClaudeやChatGPTなどのAIアシスタントが短縮URLの作成と管理、クリックの追跡、URL管理の自動化を行うことを可能にします。

📚 Linklyについて

Linkly は強力なリンク管理プラットフォームで、ブランド化された短縮URLの作成、クリックのリアルタイム追跡、マーケティングキャンペーンの最適化ができます。機能には、カスタムドメイン、UTMパラメータ、リターゲティングピクセル、QRコード、詳細な分析が含まれます。

✨ 主な機能

リンク管理

• create_link - 完全にカスタマイズ可能な新しい短縮URLを作成します（UTMパラメータ、ピクセル、Open Graphなど）。
• update_link - 既存のリンクを更新します。
• delete_link - リンクを削除します。
• get_link - 特定のリンクの詳細を取得します。
• list_links - ワークスペース内のすべてのリンクをクリック統計とともに一覧表示します。
• search_links - 名前、URL、またはメモでリンクを検索します。

分析

• get_clicks - 最近のクリックデータを取得します。
• get_analytics - グラフ化用の時系列クリックデータを取得します（日次/時間単位）。
• get_analytics_by - 次元（国、プラットフォーム、ブラウザなど）でグループ化されたクリック数を取得します。
• export_clicks - 詳細なクリックレコードをエクスポートします。

ドメイン管理

• list_domains - ワークスペース内のすべてのカスタムドメインを一覧表示します。
• create_domain - カスタムドメインを追加します。
• delete_domain - カスタムドメインを削除します。

ウェブフック管理

• list_webhooks - ワークスペースレベルのウェブフックサブスクリプションを一覧表示します。
• subscribe_webhook - すべてのリンクのクリックイベントを受信するためにURLをサブスクライブします。
• unsubscribe_webhook - ウェブフックURLのサブスクリプションを解除します。
• list_link_webhooks - 特定のリンクのウェブフックを一覧表示します。
• subscribe_link_webhook - 特定のリンクのクリックイベントを受信するためにURLをサブスクライブします。
• unsubscribe_link_webhook - 特定のリンクのクリックイベントのサブスクリプションを解除します。

📦 インストール

cd integrations/mcp-server
npm install

🔧 設定

以下の環境変数を設定してください。

export LINKLY_API_KEY="your-api-key"
export LINKLY_WORKSPACE_ID="your-workspace-id"

これらはLinklyダッシュボードの 設定 → API で見つけることができます。

🚀 クイックスタート（Claude Desktop）

Claude Desktopの設定ファイル（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

詳細なセットアップ手順と使用例については、Claude Desktopセットアップガイド を参照してください。

🚀 クイックスタート（ChatGPT）

Actionsを使用してカスタムGPTを作成することで、ChatGPTでLinklyを使用することができます。これにより、ChatGPTの会話内で直接短縮URLを管理することができます。

ステップバイステップの手順については、ChatGPTセットアップガイド を参照してください。

💻 Claude Codeでの使用

Claude CodeのMCP設定に以下を追加します。

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

💻 使用可能なツール

create_link

新しい短縮URLを作成します。

必須パラメータ:

• url - 宛先URL

オプションパラメータ:

• name - リンクのニックネーム
• note - 非公開メモ
• domain - カスタムドメイン
• slug - カスタムスラッグ（/で始める必要があります）
• enabled - リンクがアクティブかどうか（デフォルト: true）
• utm_source, utm_medium, utm_campaign, utm_term, utm_content - UTMパラメータ
• og_title, og_description, og_image - Open Graphメタデータ
• fb_pixel_id - Meta/FacebookピクセルID
• ga4_tag_id - Google Analytics 4タグID
• gtm_id - Google Tag Manager ID
• cloaking - 宛先URLをiframe内で非表示にする
• forward_params - URLパラメータを宛先に転送する
• block_bots - ボットとスパイダーをブロックする
• hide_referrer - リファラー情報を非表示にする
• expiry_datetime - リンクの有効期限（ISO 8601形式）
• expiry_destination - 有効期限切れ後のフォールバックURL

update_link

既存のリンクを更新します。

必須パラメータ:

• link_id - 更新するリンクのID

create_link の他のすべてのパラメータはオプションです。

delete_link

リンクを削除します。

必須パラメータ:

• link_id - 削除するリンクのID

get_link

特定のリンクの詳細を取得します。

必須パラメータ:

• link_id - 取得するリンクのID

list_links

ワークスペース内のすべてのリンクを一覧表示します。パラメータは必要ありません。

get_clicks

最近のクリックデータを取得します。

オプションパラメータ:

• link_id - リンクIDでクリックをフィルタリングする

get_analytics

グラフ化用の時系列クリック分析データを取得します。

オプションパラメータ:

• start - 開始日（YYYY-MM-DD、デフォルト: 30日前）
• end - 終了日（YYYY-MM-DD、デフォルト: 今日）
• link_id - 特定のリンクでフィルタリングする
• frequency - 時間粒度: day（デフォルト）または hour
• country - 国コードでフィルタリングする（例: 'US', 'GB'）
• platform - プラットフォームでフィルタリングする（デスクトップ、モバイル、タブレット）
• browser - ブラウザ名でフィルタリングする
• unique - 一意のクリックのみをカウントする（IPごと）
• bots - ボットフィルタリング: include（デフォルト）、exclude、または only

get_analytics_by

次元でグループ化されたクリック数を取得します。内訳やトップNレポートに役立ちます。

必須パラメータ:

• counter - グループ化する次元: country, platform, browser_name, referer, isp, link_id, destination, bot_name

オプションパラメータ:

• start - 開始日（YYYY-MM-DD）
• end - 終了日（YYYY-MM-DD）
• link_id - 特定のリンクでフィルタリングする
• country - 国コードでフィルタリングする
• platform - プラットフォームでフィルタリングする
• unique - 一意のクリックのみをカウントする
• bots - ボットフィルタリング

export_clicks

詳細なクリックレコードを完全な情報でエクスポートします。

オプションパラメータ:

• start - 開始日（YYYY-MM-DD、デフォルト: 30日前）
• end - 終了日（YYYY-MM-DD、デフォルト: 昨日）
• link_id - 特定のリンクでフィルタリングする
• country - 国コードでフィルタリングする
• platform - プラットフォームでフィルタリングする
• bots - ボットフィルタリング

戻り値: タイムスタンプ、ブラウザ、国、URL、リンクID、プラットフォーム、リファラー、ボット、ISP、およびパラメータを含むクリックレコードの配列。

search_links

名前、URL、またはメモでリンクを検索します。

必須パラメータ:

• query - リンク名、URL、およびメモと照合する検索文字列

list_domains

ワークスペース内のすべてのカスタムドメインを一覧表示します。パラメータは必要ありません。

create_domain

ワークスペースにカスタムドメインを追加します。

必須パラメータ:

• name - ドメイン名（例: 'links.example.com'）

delete_domain

ワークスペースからカスタムドメインを削除します。

必須パラメータ:

• domain_id - 削除するドメインのID

list_webhooks

ワークスペースにサブスクライブされているすべてのウェブフックURLを一覧表示します。パラメータは必要ありません。

subscribe_webhook

すべてのリンクのクリックイベントを受信するためにウェブフックURLをサブスクライブします。

必須パラメータ:

• url - クリックイベント通知を受信するウェブフックURL

unsubscribe_webhook

ワークスペースのクリックイベントからウェブフックURLのサブスクリプションを解除します。

必須パラメータ:

• url - サブスクリプションを解除するウェブフックURL

list_link_webhooks

特定のリンクにサブスクライブされているすべてのウェブフックURLを一覧表示します。

必須パラメータ:

• link_id - リンクのID

subscribe_link_webhook

特定のリンクのクリックイベントを受信するためにウェブフックURLをサブスクライブします。

必須パラメータ:

• link_id - リンクのID
• url - クリックイベント通知を受信するウェブフックURL

unsubscribe_link_webhook

特定のリンクのクリックイベントからウェブフックURLのサブスクリプションを解除します。

必須パラメータ:

• link_id - リンクのID
• url - サブスクリプションを解除するウェブフックURL

📄 ライセンス

MIT