Linkly MCP Server

Linkly の公式 Model Context Protocol（MCP）サーバー — URL 短縮とリンク管理のためのプラットフォームです。

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

⚠️ linkly-mcp-server npm パッケージは非推奨です。 セルフホスト / API キーフローは、もはや保守されていません。すべてのユーザーはホスト型サーバーへ移行してください。ホスト型サーバーは OAuth 2.1 with PKCE を使用し、API キーもローカルインストールも不要で、常に最新のツールセットが動作します。linkly-mcp-server npm パッケージは後方互換性のためにレジストリに残りますが、新しいツールやバグ修正は追加されず、将来非公開になる可能性があります。

ドキュメント

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

Related MCP server: DWZ Short URL MCP Server

機能

• 短縮リンクの作成、更新、削除

• クリック分析と統計の表示

• カスタムドメインとファビコンの管理

• クリックイベント用 Webhook の設定

• リンクの検索とフィルタリング

• クリックデータのエクスポート

ホスト型サーバーの利用

サーバー 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"
    }
  }
}

利用可能なツール

リンク

• Linkly ウェブサイト

• ドキュメント

• API リファレンス

• GitHub リポジトリ

サポート

ヘルプやサポートについては、Linkly サポート を参照するか、support@linklyhq.com までメールでお問い合わせください。

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

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

公開には linklyhq.com の DNS アクセスが必要です。com.linklyhq 名前空間は、ドメイン apex に設定された 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 つの安全性の正当化理由（read-only / open-world / destructive）を事前に入力するため、ダッシュボードで手入力する必要がありません。

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 の変更があった場合、このファイルをワーカーと同期させてください。destructive フラグが true になるのは、実際に破壊的な 5 つのツール（delete_link、delete_domain、batchDeleteLinks、unsubscribe_webhook、unsubscribe_link_webhook）だけです。作成・更新・購読は追加的な操作のため、false になります。

ライセンス

MIT