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など）の場合、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