Linkly MCPサーバー

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

Model Context Protocol (MCP)は、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つの方法で利用できます：

ホスティングされたMCPサーバーを使用 - インストール不要：

https://mcp.linklyhq.com

npxを使用してローカルでインストール・実行：

npx -y linkly-mcp-server

またはグローバルにインストール：

npm install -g linkly-mcp-server

パッケージはnpmで確認できます。

1. 1Linklyダッシュボードにログイン
2. 2設定 → APIキーに移動
3. 3APIキーとワークスペースIDをコピー

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の設定ファイルを開きます：

• 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"
      }
    }
  }
}

リンク作成時に指定できる項目：

• 基本: 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

• APIキーとワークスペースIDが正しいか確認
• Node.js（v18以降）がインストールされているか確認
• ターミナルでnpx linkly-mcp-serverを実行してエラーを確認

• Linklyダッシュボードの設定 → APIキーでAPIキーを確認
• 認証情報に余分なスペースがないか確認
• APIキーを再生成してみる

• 設定を保存後、AIアシスタントを再起動
• 設定ファイルのJSON構文が有効か確認
• MCPサーバーが実行されているか確認（アシスタントのツールアイコンを確認）

• コマンドパスが正しいか確認
• ホスティングサーバーを使用している場合、インターネット接続を確認
• ターミナルから手動でMCPサーバーが実行できるか確認

• Claude Desktopインテグレーション
• ChatGPTインテグレーション
• Linkly APIドキュメント
• Webhooks
• npmのMCPサーバー
• Model Context Protocol