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日間の国別クリック数を表示して」
- リンクの検索 - 「製品ローンチに関連するすべてのリンクを見つけて」
- ドメインの管理 - 「カスタムドメインをリスト表示して」
- 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"
}
}
}
利用可能なツール
| ツール | 説明 |
|---|---|
create_link | オプションのUTMパラメータ、ピクセルなどを含む新しい短縮リンクを作成 |
update_link | 既存のリンクの設定を更新 |
delete_link | リンクを削除 |
get_link | 特定のリンクの詳細を取得 |
list_links | ワークスペース内のすべてのリンクをリスト表示 |
search_links | 名前、URL、メモでリンクを検索 |
get_clicks | 最近のクリックデータを取得 |
get_analytics | グラフ用の時系列クリックデータを取得 |
get_analytics_by | 国、ブラウザ、プラットフォームなどでグループ化されたクリックを取得 |
list_domains | カスタムドメインをリスト表示 |
list_webhooks | ワークスペースのWebhook購読をリスト表示 |
subscribe_webhook | クリックイベントを受信するためにURLを登録 |
リンク作成オプション
リンク作成時に指定できる項目:
- 基本:
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サーバーが実行されていることを確認してください(アシスタント内のツールアイコンを確認)
関連リソース
MCPサーバーFAQ
MCPサーバーを使用するために何かインストールする必要がありますか?
いいえ。https://mcp.linklyhq.com のホスト型サーバーはOAuthを使用しているため、ブラウザで一度サインインするだけで、AIアシスタントの接続は維持されます。AIアシスタント自体以外、お使いのマシンにインストールするものは何もありません。
APIキーは必要ですか?
いいえ。MCPサーバーはOAuthを使用しており、AIアシスタントが初めて接続する際にブラウザでLinklyにサインインするだけで、どこかにコピーや貼り付けが必要なAPIキーはありません。
どのAIアシスタントがMCPに対応していますか?
Claude Desktop、Claude Code(CLI)、ChatGPT DesktopのいずれもMCPに対応しています。CursorやWindsurfなどの他のツールもMCPサポートがあります。
アカウントは安全ですか?
はい。ホスト型サーバーはPKCE付きのOAuth 2.1を使用しています。Linklyのパスワードを入力するのは app.linklyhq.com だけで、AIアシスタントに渡されるのはワークスペースにスコープされたアクセストークンのみです。AIモデル自体が認証情報を目にすることはありません。
ClaudeやChatGPTのWeb版でMCPを使用できますか?
いいえ、MCPにはデスクトップアプリケーションまたはClaude Code CLIが必要です。Web版はMCP接続に対応していません。
MCPサーバーを更新するにはどうすればよいですか?
更新するものはありません。ホスト型サーバーには継続的に改善がデプロイされており、接続されているすべてのクライアントに自動的に適用されます。