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サーバーは2つの方法で利用できます:
オプション1:ホスト型サーバー(推奨)
ホスト型MCPサーバーを使用 - インストール不要:
https://mcp.linklyhq.com
オプション2:npmパッケージ
npxを使用してローカルでインストールして実行:
npx -y linkly-mcp-server
またはグローバルにインストール:
npm install -g linkly-mcp-server
パッケージはnpmで確認できます。
設定
API認証情報の取得
- 1Linklyダッシュボードにログイン
- 2設定 → APIキーに移動
- 3APIキーとワークスペースIDをコピー
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", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "your-api-key",
"LINKLY_WORKSPACE_ID": "your-workspace-id"
}
}
}
}
ChatGPT Desktopの設定
ChatGPTの設定ファイルを開きます:
- macOS:
~/Library/Application Support/ChatGPT/mcp_servers.json - Windows:
%APPDATA%\ChatGPT\mcp_servers.json
Linkly MCPサーバーを追加:
npxを使用する場合:
{
"servers": {
"linkly": {
"command": "npx",
"args": ["-y", "linkly-mcp-server"],
"env": {
"LINKLY_API_KEY": "your-api-key"
}
}
}
}
ホスト型サーバーを使用する場合:
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com",
"env": {
"LINKLY_API_KEY": "your-api-key"
}
}
}
}
利用可能なツール
| ツール | 説明 |
|---|---|
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
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
LINKLY_API_KEY | はい | LinklyのAPIキー |
LINKLY_WORKSPACE_ID | いいえ | ワークスペースID(一部のクライアントで必要) |
トラブルシューティング
「MCPサーバーに接続できませんでした」
- APIキーとワークスペースIDが正しいか確認してください
- Node.js(v18以降)がインストールされていることを確認してください
- ターミナルで
npx linkly-mcp-serverを実行してエラーを確認してください
「認証に失敗しました」
- Linklyダッシュボードの設定 → APIキーでAPIキーを確認してください
- 認証情報に余分なスペースがないことを確認してください
- APIキーの再生成を試してください
ツールが表示されない
- 設定を保存した後、AIアシスタントを再起動してください
- 設定ファイルのJSON構文が有効であることを確認してください
- MCPサーバーが実行されていることを確認してください(アシスタント内のツールアイコンを確認)
サーバーに到達できない
- コマンドパスが正しいことを確認してください
- ホスト型サーバーを使用している場合は、インターネット接続を確認してください
- ターミナルから手動でMCPサーバーが実行できることを確認してください
関連リソース
MCPサーバーFAQ
MCPサーバーを使用するために何かインストールする必要がありますか?
https://mcp.linklyhq.com のホスト型サーバーを使用する場合は不要です。ローカルで実行する場合は、Node.js v18以降のインストールが必要です。
どのAIアシスタントがMCPに対応していますか?
Claude DesktopとChatGPT Desktopの両方がMCPに対応しています。CursorやWindsurfなどの他のツールもMCPサポートがあります。
APIキーは安全ですか?
はい。APIキーはAIアシスタントの設定ファイルにローカルに保存され、APIリクエストを行う際にのみLinklyのサーバーに送信されます。AIモデル自体と共有されることはありません。
ClaudeやChatGPTのWeb版でMCPを使用できますか?
いいえ、MCPにはデスクトップアプリケーションが必要です。Web版はMCP接続に対応していません。
MCPサーバーを更新するにはどうすればよいですか?
npxを使用している場合は、毎回自動的に最新バージョンが取得されます。グローバルにインストールしている場合は、npm update -g linkly-mcp-serverを実行してください。