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 など)

できること

接続後、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 の設定ファイルを開きます:

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

利用可能なツール

リンク作成オプション

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

• 基本: 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 では、/mcp → linkly → 再接続を実行してください。Claude Desktop では、アプリを終了し、~/.mcp-auth/ 内のキャッシュされた mcp-remote トークンを削除してから、再起動してください。

ツールが表示されない

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

関連リソース

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