Linkly MCP Server

Linkly MCP Serverを使用すると、Model Context Protocolを使ってAIアシスタントをLinklyアカウントに接続できます。接続すると、自然な会話を通じてショートリンクを作成・管理できます。

MCPとは

Model Context Protocol (MCP)は、AIアシスタントが外部ツールとデータソースに安全に接続できるようにするオープンスタンダードです。アプリ間でコピー・ペーストする代わりに、AIアシスタントに直接アクションを実行させることができます。

サポートされているAIアシスタント

Linkly MCP Serverは以下で動作します：

• Claude Desktop
• ChatGPT Desktop
• その他のMCP互換クライアント（Cursor、Windsurf等）

MCP serverまたはLinkly CLI？

AIアシスタントがシェルコマンドを実行できるコーディングエージェント（Claude CodeやCursorなど）の場合、MCPサーバーよりもLinkly CLIの方が適していることがあります。コーディングエージェントはコマンドラインツールの操作に慣れており、CLIはすべてのコマンドで--json出力と、エージェントが実行可能なすべてを発見するためのlinkly schemaコマンドを提供します。MCPサーバーはClaude DesktopやChatGPT Desktopなど、シェルコマンドを実行できないアシスタントに適しています。

できること

接続後、AIアシスタントに以下の操作をお願いできます：

• ショートリンクの作成 - 「https://example.com のショートリンクを作成してください」
• パフォーマンストラッキング - 「今週、私のリンクはどのくらいのクリック数を獲得しましたか？」
• リンク管理 - 「'promo'というリンクを新しい宛先に更新してください」
• アナリティクス表示 - 「過去30日間の国別クリック数を表示してください」
• リンク検索 - 「製品ローンチに関連するすべてのリンクを検索してください」
• ドメイン管理 - 「カスタムドメインのリストを表示してください」
• ウェブフック設定 - 「https://my-site.com/webhookでクリックイベントを受け取るよう登録してください」

はじめ方

ホストされているLinkly MCP Serverは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 Integration
• ChatGPT Integration
• Linkly API Documentation
• Linkly CLI
• Webhooks
• Model Context Protocol