Linkly Link Shortener

Linkly MCP サーバー

Linkly の公式 Model Context Protocol（MCP）サーバーです。Linkly は、URL 短縮サービスおよびリンク管理プラットフォームです。

このリポジトリは、ホスト型 MCP サーバー https://mcp.linklyhq.com を提供しています。 MCP 経由で AI アシスタントを Linkly に接続する方法としてサポートされているのは、これだけです。セットアップ手順については、https://linklyhq.com/support/mcp-server をご覧ください。

⚠️ linkly-mcp-server npm パッケージは非推奨です。 セルフホスト／API キーを使用する方法は、今後メンテナンスされません。すべてのユーザーはホスト型サーバーに移行してください。ホスト型サーバーは PKCE を使用した OAuth 2.1 を採用しており、API キーもローカルへのインストールも不要で、常に最新のツールセットを実行します。npm パッケージは後方互換性のためレジストリに引き続き公開されますが、新しいツールの追加やバグ修正は行われず、将来的に公開が停止される可能性があります。

ドキュメント

詳細なドキュメント、セットアップガイド、使用例については、https://linklyhq.com/support/mcp-server をご覧ください。

機能

• 短縮リンクの作成、更新、削除
• クリック分析と統計の表示
• カスタムドメインとファビコンの管理
• クリックイベント用ウェブフックの設定
• リンクの検索とフィルタリング
• クリックデータのエクスポート

ホスト型サーバーの使用

サーバー URL： https://mcp.linklyhq.com

MCP クライアントをホスト型サーバーに接続し、ブラウザーが開いたら Linkly にサインインしてください。これで完了です。API キーもインストールも不要で、設定の不整合が生じることもありません。

Claude Desktop

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linklyhq.com"]
    }
  }
}

Claude Code（CLI）

claude mcp add --transport http linkly https://mcp.linklyhq.com

ChatGPT Desktop

{
  "servers": {
    "linkly": {
      "type": "url",
      "url": "https://mcp.linklyhq.com"
    }
  }
}

利用可能なツール

ツール	説明
create_link	新しい短縮リンクを作成します
update_link	既存のリンクを更新します
delete_link	リンクを削除します
get_link	リンクの詳細を取得します
list_links	ワークスペース内のすべてのリンクを一覧表示します
search_links	名前、URL、メモでリンクを検索します
get_analytics	時系列のクリックデータを取得します
get_analytics_by	ディメンション別にグループ化したクリック数を取得します
get_clicks	最近のクリックデータを取得します
export_clicks	詳細なクリック記録をエクスポートします
list_domains	カスタムドメインを一覧表示します
create_domain	カスタムドメインを追加します
delete_domain	カスタムドメインを削除します
update_domain_favicon	ドメインのファビコンを更新します
list_webhooks	ワークスペースのウェブフックを一覧表示します
subscribe_webhook	ウェブフックを追加します
unsubscribe_webhook	ウェブフックを削除します
list_link_webhooks	リンク固有のウェブフックを一覧表示します
subscribe_link_webhook	リンクのウェブフックを追加します
unsubscribe_link_webhook	リンクのウェブフックを削除します

リンク

• Linkly のウェブサイト
• ドキュメント
• API リファレンス
• GitHub リポジトリ

サポート

ヘルプやサポートについては、Linkly サポートをご覧いただくか、[email protected] までメールでお問い合わせください。

MCP レジストリへの公開（メンテナー向け）

リポジトリのルートにある server.json は、com.linklyhq/linkly サーバー用の公式 MCP レジストリのマニフェストです。リモート専用で、ホストされたサーバーをクライアントに指定し、意図的にパッケージを含めていません（非推奨となった npm 配布は v2.0.0 で廃止されました）。

公開には linklyhq.com の DNS へのアクセスが必要です。com.linklyhq 名前空間は、ドメインのルートにある DNS TXT レコードを使用して検証されます。

# 1. Generate an Ed25519 key + TXT record (macOS: use openssl@3; system LibreSSL lacks Ed25519)
openssl genpkey -algorithm Ed25519 -out key.pem
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "linklyhq.com. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""   # add at the APEX of linklyhq.com

# 2. Authenticate the namespace + publish
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 'priv:' | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain linklyhq.com --private-key "$PRIVATE_KEY"
mcp-publisher publish

詳細は、レジストリ認証ガイドをご覧ください。

ChatGPT アプリの更新（メンテナー向け）

chatgpt-app-submission.json は、OpenAI の Apps SDK 提出用インポートファイルです。25 個すべてのツールについて、ツールごとのアノテーションと 3 つの安全性に関する根拠（読み取り専用／オープンワールド／破壊的）を事前に入力しているため、ダッシュボードで手入力する必要はありません。

OpenAI は公開時にメタデータのスナップショットを固定し、MCP の変更を自動検出しないため、サーバーの変更をデプロイした後は新しいバージョンを公開します。

1. ワーカーをデプロイします（接続済みのブランチにプッシュするか、wrangler deploy を実行します）。
2. プラットフォームダッシュボード → Linkly アプリ → 新しいドラフトバージョンを作成します（MCP URL https://mcp.linklyhq.com は変更しません）。
3. MCP セクションで Scan Tools をクリックし、最新のツール一覧とアノテーションを読み込みます。
4. chatgpt-app-submission.json をフォーム（ページ上部）にドラッグして、根拠を入力します。
5. Testing を確認し、Submit します。公開済みバージョンは、新しいバージョンが承認されるまでライブサーバーに接続して動作し続けます。

ツールの追加・削除や readOnlyHint／destructiveHint の変更があった場合は、このファイルをワーカーと同期してください。破壊的フラグが true になるのは、真に破壊的な 5 つのツール（delete_link、delete_domain、batchDeleteLinks、unsubscribe_webhook、unsubscribe_link_webhook）のみです。作成・更新・登録の操作は追加的なため、false です。

ライセンス

MIT