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

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日間の国別クリック数を表示してください」
• リンクの検索 - 「製品ローンチに関連するすべてのリンクを探してください」
• ドメインの管理 - 「カスタムドメインをリスト表示してください」
• 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"
    }
  }
}

利用可能なツール

リンク作成オプション

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

• 基本: 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
• Webhooks
• Model Context Protocol