Linkly MCP サーバー

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

MCP とは

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

サポートされている AI アシスタント

Linkly MCP サーバーは以下で動作します:

• Claude Desktop
• ChatGPT Desktop
• その他の MCP 互換クライアント (Cursor、Windsurf など)

見つける場所

Linkly MCP サーバーはメイン MCP ディレクトリにリストされているため、コネクタを探している場所からインストールできます:

• Claude コネクタディレクトリ — Claude (Web および Desktop) でワンクリック接続
• 公式 MCP レジストリ — com.linklyhq/linkly
• Smithery
• Glama
• mcp.so
• ClaudePluginHub — Claude Code および Cowork 用 Linkly プラグイン
• GitHub のソース — MIT ライセンス

MCP サーバーと Linkly CLI のどちらを選ぶ？

AI アシスタントが Claude Code や Cursor のようにシェルコマンドを実行できるコーディングエージェントである場合、Linkly CLI は多くの場合 MCP サーバーより優れた選択肢です。コーディングエージェントはコマンドラインツールの操作に慣れており、CLI はすべてのコマンドで --json 出力を提供し、エージェントが実行できるすべてのコマンドを発見できる linkly schema コマンドを提供します。MCP サーバーは Claude Desktop や ChatGPT Desktop のようにシェルコマンドを実行できないアシスタントでより適切です。

できること

接続後、AI アシスタントに以下をリクエストできます:

• ショートリンクを作成 - 「https://example.com のショートリンクを作成してください」
• パフォーマンスを追跡 - 「今週のリンクは何回クリックされましたか？」
• リンクを管理 - 「'promo' というリンクを新しい宛先で更新してください」
• 分析を表示 - 「過去 30 日間の国別クリック数を表示してください」
• リンクを検索 - 「製品ローンチに関連するすべてのリンクを検索してください」
• ドメインを管理 - 「カスタムドメインをリストアップしてください」
• ウェブフックを設定 - 「https://my-site.com/webhook を登録してクリックイベントを受け取ってください」

はじめに

ホストされている Linkly MCP サーバーは https://mcp.linklyhq.com にあります。インストールするものはなく、API キーもコピーする必要がありません。サーバーは OAuth を使用するため、AI アシスタントが初めて接続するときは、ブラウザウィンドウが開いて Linkly にサインインし、アクセスを承認するよう求められます。その後、アシスタントは接続されたままです。

https://mcp.linklyhq.com

設定

Claude desktop

Claude Desktop で、設定 → コネクタ → カスタムコネクタを追加 に移動します。名前 (Linkly) とリモート MCP サーバーの URL を入力します:

https://mcp.linklyhq.com

追加 をクリックし、Linkly コネクタで 接続 をクリックします。ブラウザタブが開いてサインインしてアクセスを承認します。その後、Claude Desktop は接続されたままです。設定ファイルや追加ツーリングは不要です。

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"
    }
  }
}

利用可能なツール

リンク作成オプション

リンクを作成する際は、以下を指定できます:

• 基本: 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 がマシンからアクセス可能であることを確認してください
• Claude Code で /mcp を実行し、linkly を選択して OAuth フローを再度トリガーします

「認証に失敗しました」、「invalid_client」、またはブラウザが何度もサインインを求める

これはクライアントが古い接続登録を保持していることを意味します。キャッシュされた認証情報をクリアして再認可してください。Claude Code で /mcp → linkly → 再接続を実行します。Claude Desktop では、設定 → コネクタ から Linkly コネクタを削除して再度追加してから、再度サインインします。

ツールが表示されていない

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

関連リソース

• Claude Desktop 統合
• ChatGPT 統合
• Linkly API ドキュメント
• Linkly CLI
• ウェブフック
• Model Context Protocol