Linkly MCP Server
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-servernpm パッケージは非推奨です。 セルフホスト / API キーフローは、もはや保守されていません。すべてのユーザーはホスト型サーバーへ移行してください。ホスト型サーバーは OAuth 2.1 with PKCE を使用し、API キーもローカルインストールも不要で、常に最新のツールセットが動作します。linkly-mcp-servernpm パッケージは後方互換性のためにレジストリに残りますが、新しいツールやバグ修正は追加されず、将来非公開になる可能性があります。
ドキュメント
完全なドキュメント、セットアップガイド、使用例については、https://linklyhq.com/support/mcp-server を参照してください。
Related MCP server: filoo 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.comChatGPT Desktop
{
"servers": {
"linkly": {
"type": "url",
"url": "https://mcp.linklyhq.com"
}
}
}利用可能なツール
ツール | 説明 |
| 新しい短縮リンクを作成します |
| 既存のリンクを更新します |
| リンクを削除します |
| リンクの詳細を取得します |
| ワークスペース内の全リンクを一覧表示します |
| 名前・URL・メモでリンクを検索します |
| 時系列のクリックデータを取得します |
| ディメンション別のクリック数を取得します |
| 最近のクリックデータを取得します |
| 詳細なクリック記録をエクスポートします |
| カスタムドメインを一覧表示します |
| カスタムドメインを追加します |
| カスタムドメインを削除します |
| ドメインのファビコンを更新します |
| ワークスペースの Webhook を一覧表示します |
| Webhook を追加します |
| Webhook を削除します |
| リンク固有の Webhook を一覧表示します |
| リンク用 Webhook を追加します |
| リンク用 Webhook を削除します |
リンク
サポート
ヘルプやサポートについては、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 の変更を自動的に検出しません。そのため、サーバー変更をデプロイした後は、新しいバージョンを公開してください。
ワーカーをデプロイします(接続済みのブランチへのプッシュ /
wrangler deploy)。プラットフォームダッシュボード → Linkly アプリ → 新しいドラフトバージョンを作成します(MCP URL は
https://mcp.linklyhq.comのままにします)。MCP セクションで Scan Tools をクリックし、ライブのツールリストと注釈を再読み込みします。
フォーム(ページ上部)に
chatgpt-app-submission.jsonをドラッグして、正当化理由を入力します。Testing を確認し、Submit で公開します。公開されたバージョンは、新しいバージョンが承認されるまでライブサーバー上で動作し続けます。
ツールの追加・削除、または readOnlyHint / destructiveHint の変更があった場合、このファイルをワーカーと同期させてください。destructive フラグが true になるのは、実際に破壊的な 5 つのツール(delete_link、delete_domain、batchDeleteLinks、unsubscribe_webhook、unsubscribe_link_webhook)だけです。作成・更新・購読は追加的な操作のため、false になります。
ライセンス
MIT
Available Tools
20 toolscreate_domainCInspect
Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.
Inputs: name (required).
create_linkCInspect
Create a new Linkly short link. Returns the created link with its short URL.
Inputs: url (required), name, note, slug, +19 more.
delete_domainCInspect
Remove a custom domain from the workspace.
Inputs: domain_id (required).
delete_linkCInspect
Delete a Linkly link by its ID
Inputs: link_id (required).
export_clicksCInspect
Export detailed click records with full information (timestamp, browser, country, URL, platform, referer, bot, ISP, params).
Inputs: end, bots, start, country, +2 more.
get_analyticsAInspect
Get time-series click analytics data for charting. Returns click counts over time.
Inputs: end, bots, start, unique, +5 more.
get_analytics_byBInspect
Get click counts grouped by a dimension (country, platform, browser, etc.). Useful for breakdowns and top-N reports.
Inputs: counter (required), end, bots, start, +4 more.
get_clicksCInspect
Get recent click data for the workspace
Inputs: link_id.
list_domainsBInspect
List all custom domains in the workspace.
Inputs: no named parameters.
list_linksBInspect
List all links in the workspace. Returns links with click statistics.
Inputs: no named parameters.
list_link_webhooksBInspect
List all webhook URLs subscribed to a specific link.
Inputs: link_id (required).
list_webhooksAInspect
List all webhook URLs subscribed to the workspace. These receive click events for all links.
Inputs: no named parameters.
search_linksBInspect
Search for links by name, URL, or note. Returns matching links with click statistics.
Inputs: query (required).
subscribe_link_webhookCInspect
Subscribe a webhook URL to receive click events for a specific link.
Inputs: url (required), link_id (required).
subscribe_webhookCInspect
Subscribe a webhook URL to receive click events for all links in the workspace.
Inputs: url (required).
unsubscribe_link_webhookBInspect
Unsubscribe a webhook URL from a specific link's click events.
Inputs: url (required), link_id (required).
unsubscribe_webhookCInspect
Unsubscribe a webhook URL from workspace click events.
Inputs: url (required).
update_domain_faviconCInspect
Update the favicon URL for a custom domain.
Inputs: domain_id (required), favicon_url (required).
update_linkCInspect
Update an existing Linkly link by its ID
Inputs: link_id (required), url, name, note, +18 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool has a distinct purpose with clear boundaries, targeting specific resources (domains, links, webhooks, analytics) and actions (create, delete, get, list, update, subscribe, unsubscribe, export). There is no overlap or ambiguity; for example, get_analytics and get_analytics_by serve different analytical functions, and webhook tools are clearly separated by scope (link-specific vs. workspace-wide).
Tool names follow a consistent verb_noun pattern throughout, with verbs like create, delete, get, list, update, subscribe, unsubscribe, export, and search applied to nouns such as domain, link, webhook, analytics, and clicks. There are no deviations in style (e.g., no camelCase or mixed conventions), making the set predictable and readable.
With 20 tools, the count is slightly high but reasonable for a link management and analytics domain, covering domains, links, webhooks, and analytics comprehensively. It avoids being excessive (e.g., not over 25) and each tool appears justified, though it could be streamlined slightly without losing functionality.
The tool set provides complete CRUD/lifecycle coverage for domains (create, list, delete, update_favicon), links (create, get, list, update, delete, search), and webhooks (subscribe, unsubscribe, list for both link-specific and workspace-wide). Analytics tools (get_analytics, get_analytics_by, export_clicks, get_clicks) offer robust data access, leaving no obvious gaps for agent workflows in this domain.
Maintenance
Related MCP Connectors
Create branded short links and QR codes, and pull click analytics by country, device and referrer.
Create, search and pause deep links; QR codes; analytics, taps, events; domains; webhooks.
Short links, QR codes, link and website analytics: create and edit links, read clicks and visitors.
Create, edit and track LickityClick short links, campaigns and click stats from your AI assistant.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables interaction with the Firelinks link shortening platform to create and manage short links, track click statistics, manage custom domains, and compare analytics periods through natural language.3MIT
- AlicenseAqualityDmaintenanceEnables AI agents to shorten URLs, manage links, and track click analytics through 8 first-class tools, designed for use with Claude Desktop, Cursor, and other MCP clients.946 npmMIT
- AlicenseAqualityBmaintenanceEnables users to shorten links, bulk create URLs, generate QR codes, manage and disable links, and retrieve click analytics from MCP clients like Claude, ChatGPT, Cursor, and n8n.9MIT
- AlicenseBqualityCmaintenanceEnables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.940 npmMIT