Skip to main content
Glama
Linkly MCP Server

Linkly MCP Server

Linkly MCP Server

Claude connector directory Glama MCP registry

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: 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.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

ワークスペースの Webhook を一覧表示します

subscribe_webhook

Webhook を追加します

unsubscribe_webhook

Webhook を削除します

list_link_webhooks

リンク固有の Webhook を一覧表示します

subscribe_link_webhook

リンク用 Webhook を追加します

unsubscribe_link_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 の変更を自動的に検出しません。そのため、サーバー変更をデプロイした後は、新しいバージョンを公開してください。

  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

Available Tools

20 tools
create_domainCInspect

Add a custom domain to the workspace. The domain must be configured to point to Linkly's servers.

Inputs: name (required).

delete_domainCInspect

Remove a custom domain from the workspace.

Inputs: domain_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_webhooksAInspect

List all webhook URLs subscribed to the workspace. These receive click events for all links.

Inputs: no named parameters.

subscribe_webhookCInspect

Subscribe a webhook URL to receive click events for all links in the workspace.

Inputs: url (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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 20 tools

    Disambiguation5/5

    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).

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      9
      46 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables users to shorten links, bulk-create URLs, generate QR codes, and retrieve click analytics through MCP clients such as Claude, ChatGPT, Cursor, and n8n.
      9
      40 npm
      MIT