Linkly Link Shortener

官方

Linkly 是一個連結縮短器,具備地理重新導向、連結輪播、轉換追蹤,以及強大的連結縮短 API。

你可以用 Linkly Link Shortener MCP 做什麼?

  • 建立短連結 — 要求您的助理透過 create_link 建立新的短連結,可自訂別名、UTM 參數或追蹤像素。
  • 搜尋與管理連結 — 使用 search_links 依名稱或 URL 尋找連結,然後透過 update_linkdelete_link 更新或刪除。
  • 取得點擊分析 — 透過 get_analytics 取得時間序列的點擊數據,或使用 get_analytics_by 依國家、瀏覽器或平台進行細分。
  • 管理自訂網域 — 使用 list_domains 列出工作區中設定的所有自訂網域。
  • 訂閱 Webhook — 使用 subscribe_webhook 註冊一個 URL,以程式化方式接收點擊事件。

文件

Linkly MCP 伺服器

Linkly MCP 伺服器讓您可以使用模型上下文協定 (Model Context Protocol),將 AI 助理連接到您的 Linkly 帳戶。連接後,您就能透過自然對話來建立和管理短連結。

什麼是 MCP?

模型上下文協定 (MCP) 是一項開放標準,允許 AI 助理安全地連接到外部工具和資料來源。您不必在不同應用程式之間複製貼上,而是可以直接要求 AI 助理執行操作。

支援的 AI 助理

Linkly MCP 伺服器適用於:

  • Claude Desktop
  • ChatGPT Desktop
  • 其他與 MCP 相容的客戶端 (Cursor、Windsurf 等)

MCP 伺服器還是 Linkly CLI?

如果您的 AI 助理是一個可以執行 shell 指令的編碼代理 (例如 Claude Code 或 Cursor),那麼 Linkly CLI 通常比 MCP 伺服器更適合。編碼代理本身就擅長驅動命令列工具,而 CLI 會在每個指令提供 --json 輸出,還有一個 linkly schema 指令可以印出完整的指令樹,讓代理能夠探索所有可執行的操作。對於無法執行 shell 指令的助理 (例如 Claude Desktop 和 ChatGPT Desktop),MCP 伺服器仍然是較好的選擇。

您可以執行的操作

連接後,您可以要求 AI 助理:

  • 建立短連結 - "為 https://example.com 建立一個短連結"
  • 追蹤成效 - "我這週的連結獲得了多少次點擊?"
  • 管理連結 - "更新名為 'promo' 的連結,設定新的目標網址"
  • 查看分析 - "顯示過去 30 天按國家劃分的點擊次數"
  • 搜尋連結 - "找出所有與產品發布相關的連結"
  • 管理網域 - "列出我的自訂網域"
  • 設定 webhook - "訂閱 https://my-site.com/webhook 以接收點擊事件"

開始使用

託管的 Linkly MCP 伺服器位於 https://mcp.linklyhq.com。無需安裝任何東西,也無需複製 API 金鑰 — 伺服器使用 OAuth,因此當您的 AI 助理首次連接時,會開啟一個瀏覽器視窗,要求您登入 Linkly 並核准存取權限。之後,您的助理就會保持連接狀態。

https://mcp.linklyhq.com

設定

Claude desktop

在 Claude Desktop 中,前往 Settings → Connectors → Add custom connector。輸入名稱 (Linkly) 和遠端 MCP 伺服器 URL:


Click **Add**, then **Connect** on the Linkly connector. A browser tab opens for you to sign in and approve access. Claude Desktop then stays connected — no config file or extra tooling needed.

### Claude code (CLI)

Claude Code supports remote MCP servers natively. Add Linkly with one command:

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


Then run `/mcp` inside Claude Code, pick **linkly**, and authorize in the browser when prompted.

### ChatGPT desktop

Open your ChatGPT config file:

* **macOS:** `~/Library/Application Support/ChatGPT/mcp_servers.json`
* **Windows:** `%APPDATA%\ChatGPT\mcp_servers.json`

Add the Linkly MCP server:

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


## 可用工具

| 工具               | 說明                                                        |
| ------------------ | ------------------------------------------------------------------ |
| create_link       | 建立新的短連結,可選擇加入 UTM 參數、像素等 |
| update_link       | 更新現有連結的設定                                 |
| delete_link       | 刪除連結                                                      |
| get_link          | 取得特定連結的詳細資料                                     |
| list_links        | 列出工作區中的所有連結                                   |
| search_links      | 按名稱、網址或備註搜尋連結                     |
| get_clicks        | 取得最近的點擊資料                                              |
| get_analytics     | 取得用於圖表的時間序列點擊資料                              |
| get_analytics_by | 取得按國家、瀏覽器、平台等分組的點擊次數             |
| list_domains      | 列出您的自訂網域                                           |
| list_webhooks     | 列出工作區 webhook 訂閱                               |
| subscribe_webhook | 訂閱一個網址以接收點擊事件                            |

## 連結建立選項

建立連結時,您可以指定:

* **基本:** `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` 可以從您的機器連線
* 在 Claude Code 中,執行 `/mcp` 並選擇 **linkly** 以重新觸發 OAuth 流程

### "驗證失敗"、"invalid_client",或瀏覽器持續要求登入

這表示您的客戶端正持有過時的連線註冊資訊。請清除快取的憑證並重新授權。在 Claude Code 中,執行 `/mcp` → **linkly** → 重新連線。在 Claude Desktop 中,於 **Settings → Connectors** 下移除 Linkly 連接器,然後重新新增,再重新登入。

### 工具未顯示

* 儲存設定後重新啟動您的 AI 助理
* 檢查設定檔中的 JSON 語法是否有效
* 確認 MCP 伺服器正在執行 (檢查助理中是否顯示工具圖示)

## 相關資源

* Claude Desktop 整合
* ChatGPT 整合
* Linkly API 文件
* Linkly CLI
* Webhooks
* 模型上下文協定 (Model Context Protocol)

### 試用 Linkly 的免費網址縮短服務

免費獲得 100 個短連結和每月 500 次點擊。無需信用卡。

免費取得您的連結

每月 500 次追蹤點擊自訂網域無需信用卡

## MCP 伺服器常見問題

### 使用 MCP 伺服器需要安裝任何東西嗎?

不需要。位於 https://mcp.linklyhq.com 的託管伺服器使用 OAuth — 您只需在瀏覽器中登入一次,您的 AI 助理就會保持連接。除了 AI 助理本身,無需在您的機器上安裝任何軟體。

### 我需要 API 金鑰嗎?

不需要。MCP 伺服器使用 OAuth — 當您的 AI 助理首次連接時,您會透過瀏覽器登入 Linkly,無需在任何地方複製或貼上 API 金鑰。

### 哪些 AI 助理支援 MCP?

Claude Desktop、Claude Code (CLI) 和 ChatGPT Desktop 都支援 MCP。其他工具如 Cursor 和 Windsurf 也具備 MCP 支援。

### 我的帳戶安全嗎?

是的。託管伺服器使用帶有 PKCE 的 OAuth 2.1 — 您的 Linkly 密碼只會在 app.linklyhq.com 上輸入,而您的 AI 助理只會看到一個限定於您工作區範圍的存取權杖。AI 模型本身永遠不會看到您的憑證。

### 我可以在 Claude 或 ChatGPT 的網頁版使用 MCP 嗎?

不可以,MCP 需要桌面應用程式或 Claude Code CLI。網頁版不支援 MCP 連線。

### 如何更新 MCP 伺服器?

無需更新 — 我們會持續將改進內容部署到託管伺服器,每個連接的客戶端都會自動獲得這些更新。

方案適用性

適用於 Pro 及以上方案

比較方案 →

FreeStarterProBusinessEnterprise

免費獲得 100 個短連結並追蹤每月 500 次點擊。

免費開始使用

無需信用卡

流量大嗎?與我們的團隊聯繫