Linkly MCP Server

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

MCPとは?

Model Context Protocol (MCP)は、AIアシスタントが外部ツールやデータソースに安全に接続できるようにするオープン標準です。アプリ間でコピー&ペーストするのではなく、AIアシスタントに直接アクションを実行してもらうことができます。

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

Linkly MCP Serverは以下に対応しています:

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

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

AIアシスタントがシェルコマンドを実行できるコーディングエージェント(Claude CodeやCursorなど)の場合、MCPサーバーよりもLinkly CLIの方が適していることがあります。コーディングエージェントはすでにコマンドラインツールを使用する習慣があり、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の設定ファイルを開きます:

• 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ドキュメンテーション
• Linkly CLI
• ウェブフック
• Model Context Protocol