Linkly MCPサーバー

Linkly MCPサーバーを使用すると、Model Context Protocolを使ってAIアシスタントをLinklyアカウントに接続できます。接続後は、自然な会話を通じて短縮リンクを作成・管理できます。

MCPとは?

Model Context Protocol (MCP)は、AIアシスタントが外部ツールやデータソースに安全に接続できるオープンスタンダードです。アプリ間でコピー&ペーストする代わりに、AIアシスタントに直接アクションを実行するよう依頼できます。

対応しているAIアシスタント

Linkly MCPサーバーは以下に対応しています:

できること

接続後、AIアシスタントに以下のことを依頼できます:

  • 短縮リンクの作成 - 「https://example.com の短縮リンクを作成して」
  • パフォーマンスの追跡 - 「今週リンクがクリックされた回数は?」
  • リンクの管理 - 「'promo'という名前のリンクを新しい転送先で更新して」
  • 分析の表示 - 「過去30日間の国別クリック数を表示して」
  • リンクの検索 - 「製品ローンチに関連するすべてのリンクを見つけて」
  • ドメインの管理 - 「カスタムドメインをリスト表示して」
  • Webhookの設定 - 「クリックイベントを受信するために https://my-site.com/webhook を登録して」

インストールオプション

Linkly MCPサーバーは2つの方法で利用できます:

オプション1:ホスト型サーバー(推奨)

ホスト型MCPサーバーを使用 - インストール不要:

https://mcp.linklyhq.com

オプション2:npmパッケージ

npxを使用してローカルでインストールして実行:

npx -y linkly-mcp-server

またはグローバルにインストール:

npm install -g linkly-mcp-server

パッケージはnpmで確認できます。

設定

API認証情報の取得

  1. 1Linklyダッシュボードにログイン
  2. 2設定 → APIキーに移動
  3. 3APIキーワークスペースIDをコピー

Claude Desktopの設定

Claude Desktopの設定ファイルを開きます:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Linkly MCPサーバーを追加:

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

ChatGPT Desktopの設定

ChatGPTの設定ファイルを開きます:

  • macOS: ~/Library/Application Support/ChatGPT/mcp_servers.json
  • Windows: %APPDATA%\ChatGPT\mcp_servers.json

Linkly MCPサーバーを追加:

npxを使用する場合:

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

ホスト型サーバーを使用する場合:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com",
      "env": {
        "LINKLY_API_KEY": "your-api-key"
      }
    }
  }
}

利用可能なツール

ツール説明
create_linkオプションのUTMパラメータ、ピクセルなどを含む新しい短縮リンクを作成
update_link既存のリンクの設定を更新
delete_linkリンクを削除
get_link特定のリンクの詳細を取得
list_linksワークスペース内のすべてのリンクをリスト表示
search_links名前、URL、メモでリンクを検索
get_clicks最近のクリックデータを取得
get_analyticsグラフ用の時系列クリックデータを取得
get_analytics_by国、ブラウザ、プラットフォームなどでグループ化されたクリックを取得
list_domainsカスタムドメインをリスト表示
list_webhooksワークスペースのWebhook購読をリスト表示
subscribe_webhookクリックイベントを受信するためにURLを登録

リンク作成オプション

リンク作成時に指定できる項目:

  • 基本: url, name, note, domain, slug, enabled
  • UTMパラメータ: utm_source, utm_medium, utm_campaign, utm_term, utm_content
  • Open Graph: og_title, og_description, og_image
  • トラッキング: fb_pixel_id, ga4_tag_id, gtm_id
  • 詳細: cloaking, forward_params, block_bots, hide_referrer
  • 有効期限: expiry_datetime, expiry_destination

環境変数

変数必須説明
LINKLY_API_KEYはいLinklyのAPIキー
LINKLY_WORKSPACE_IDいいえワークスペースID(一部のクライアントで必要)

トラブルシューティング

「MCPサーバーに接続できませんでした」

  • APIキーとワークスペースIDが正しいか確認してください
  • Node.js(v18以降)がインストールされていることを確認してください
  • ターミナルでnpx linkly-mcp-serverを実行してエラーを確認してください

「認証に失敗しました」

  • Linklyダッシュボードの設定 → APIキーでAPIキーを確認してください
  • 認証情報に余分なスペースがないことを確認してください
  • APIキーの再生成を試してください

ツールが表示されない

  • 設定を保存した後、AIアシスタントを再起動してください
  • 設定ファイルのJSON構文が有効であることを確認してください
  • MCPサーバーが実行されていることを確認してください(アシスタント内のツールアイコンを確認)

サーバーに到達できない

  • コマンドパスが正しいことを確認してください
  • ホスト型サーバーを使用している場合は、インターネット接続を確認してください
  • ターミナルから手動でMCPサーバーが実行できることを確認してください

関連リソース

MCPサーバーFAQ

MCPサーバーを使用するために何かインストールする必要がありますか?

https://mcp.linklyhq.com のホスト型サーバーを使用する場合は不要です。ローカルで実行する場合は、Node.js v18以降のインストールが必要です。

どのAIアシスタントがMCPに対応していますか?

Claude DesktopとChatGPT Desktopの両方がMCPに対応しています。CursorやWindsurfなどの他のツールもMCPサポートがあります。

APIキーは安全ですか?

はい。APIキーはAIアシスタントの設定ファイルにローカルに保存され、APIリクエストを行う際にのみLinklyのサーバーに送信されます。AIモデル自体と共有されることはありません。

ClaudeやChatGPTのWeb版でMCPを使用できますか?

いいえ、MCPにはデスクトップアプリケーションが必要です。Web版はMCP接続に対応していません。

MCPサーバーを更新するにはどうすればよいですか?

npxを使用している場合は、毎回自動的に最新バージョンが取得されます。グローバルにインストールしている場合は、npm update -g linkly-mcp-serverを実行してください。

月500クリックまで追跡、すべての機能を含む。

クレジットカードは不要です