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サーバーは https://mcp.linklyhq.com で利用できます。インストールするものも、コピーするAPIキーもありません。サーバーはOAuthを使用するため、AIアシスタントが初めて接続する際にブラウザウィンドウが開き、Linklyにサインインしてアクセスを承認するよう求められます。その後は、アシスタントの接続が維持されます。

https://mcp.linklyhq.com

設定

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", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Desktopを再起動してください。初めてLinklyのツールを使用する際に、サインインしてアクセスを承認するためのブラウザタブが開きます。

Claude Code(CLI)

Claude CodeはリモートMCPサーバーをネイティブにサポートしています。以下のコマンド1つでLinklyを追加できます:

claude mcp add --transport http linkly https://mcp.linklyhq.com

その後、Claude Code内で /mcp を実行し、linkly を選択して、プロンプトが表示されたらブラウザで承認してください。

ChatGPT Desktop

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

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

Linkly MCPサーバーを追加します:

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

利用可能なツール

ツール説明
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

トラブルシューティング

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

  • お使いのマシンから https://mcp.linklyhq.com に到達できるか確認してください
  • クライアントが mcp-remote を使用している場合は、Node.js v18以降がインストールされていることを確認してください
  • Claude Codeでは、/mcp を実行して linkly を選択し、OAuthフローを再度トリガーしてください

「認証に失敗しました」/ブラウザで繰り返しサインインを求められる

クライアントにキャッシュされているMCP認証情報をクリアして、再度認証してください。Claude Codeでは、/mcplinkly → 再接続を実行します。Claude Desktopでは、アプリを終了し、~/.mcp-auth/ にキャッシュされた mcp-remote のトークンを削除してから再起動してください。

ツールが表示されない

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

関連リソース

MCPサーバーFAQ

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

いいえ。https://mcp.linklyhq.com のホスト型サーバーはOAuthを使用しているため、ブラウザで一度サインインするだけで、AIアシスタントの接続は維持されます。AIアシスタント自体以外、お使いのマシンにインストールするものは何もありません。

APIキーは必要ですか?

いいえ。MCPサーバーはOAuthを使用しており、AIアシスタントが初めて接続する際にブラウザでLinklyにサインインするだけで、どこかにコピーや貼り付けが必要なAPIキーはありません。

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

Claude Desktop、Claude Code(CLI)、ChatGPT DesktopのいずれもMCPに対応しています。CursorやWindsurfなどの他のツールもMCPサポートがあります。

アカウントは安全ですか?

はい。ホスト型サーバーはPKCE付きのOAuth 2.1を使用しています。Linklyのパスワードを入力するのは app.linklyhq.com だけで、AIアシスタントに渡されるのはワークスペースにスコープされたアクセストークンのみです。AIモデル自体が認証情報を目にすることはありません。

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

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

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

更新するものはありません。ホスト型サーバーには継続的に改善がデプロイされており、接続されているすべてのクライアントに自動的に適用されます。

月500クリックを追跡でき、すべての機能が含まれています。

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