Linkly Link Shortener

Linkly MCP Server

Linkly MCP Server cho phép bạn kết nối trợ lý AI với tài khoản Linkly bằng Model Context Protocol. Sau khi kết nối, bạn có thể tạo và quản lý liên kết rút gọn thông qua hội thoại tự nhiên.

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép trợ lý AI kết nối an toàn với các công cụ và nguồn dữ liệu bên ngoài. Thay vì sao chép và dán giữa các ứng dụng, bạn có thể yêu cầu trợ lý AI thực hiện hành động trực tiếp.

Trợ lý AI được hỗ trợ

Linkly MCP Server hoạt động với:

• Claude Desktop
• ChatGPT Desktop
• Các ứng dụng khách tương thích MCP khác (Cursor, Windsurf, v.v.)

MCP server hay Linkly CLI?

Nếu trợ lý AI của bạn là một tác nhân lập trình có thể chạy lệnh shell — chẳng hạn như Claude Code hoặc Cursor — thì Linkly CLI thường phù hợp hơn MCP server. Các tác nhân lập trình đã quen thuộc với việc điều khiển công cụ dòng lệnh và CLI cung cấp cho chúng đầu ra --json trên mỗi lệnh cùng với lệnh linkly schema in ra toàn bộ cây lệnh, để tác nhân có thể khám phá mọi thứ nó có thể làm. MCP server vẫn là lựa chọn tốt hơn cho các trợ lý không thể chạy lệnh shell, chẳng hạn như Claude Desktop và ChatGPT Desktop.

Những gì bạn có thể làm

Sau khi kết nối, bạn có thể yêu cầu trợ lý AI của mình:

• Tạo liên kết rút gọn - "Tạo liên kết rút gọn cho https://example.com"
• Theo dõi hiệu suất - "Liên kết của tôi đã nhận được bao nhiêu lượt nhấp trong tuần này?"
• Quản lý liên kết - "Cập nhật liên kết có tên 'promo' với đích đến mới"
• Xem phân tích - "Hiển thị lượt nhấp theo quốc gia trong 30 ngày qua"
• Tìm kiếm liên kết - "Tìm tất cả liên kết liên quan đến ra mắt sản phẩm"
• Quản lý tên miền - "Liệt kê các tên miền tùy chỉnh của tôi"
• Thiết lập webhooks - "Đăng ký https://my-site.com/webhook để nhận sự kiện nhấp chuột"

Bắt đầu

Linkly MCP Server được lưu trữ tại https://mcp.linklyhq.com. Không cần cài đặt gì và không cần sao chép khóa API — máy chủ sử dụng OAuth, vì vậy lần đầu tiên trợ lý AI của bạn kết nối, một cửa sổ trình duyệt sẽ mở ra yêu cầu bạn đăng nhập vào Linkly và phê duyệt quyền truy cập. Sau đó, trợ lý của bạn sẽ duy trì kết nối.

https://mcp.linklyhq.com

Cấu hình

Claude desktop

Trong Claude Desktop, đi tới Settings → Connectors → Add custom connector. Nhập tên (Linkly) và URL máy chủ MCP từ xa:

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" } } }

## Công cụ khả dụng

| Công cụ            | Mô tả                                                                 |
| ------------------ | --------------------------------------------------------------------- |
| create_link       | Tạo liên kết rút gọn mới với tham số UTM, pixel tùy chọn, v.v.       |
| update_link       | Cập nhật cài đặt của liên kết hiện có                                 |
| delete_link       | Xóa liên kết                                                          |
| get_link          | Lấy chi tiết của một liên kết cụ thể                                  |
| list_links        | Liệt kê tất cả liên kết trong không gian làm việc của bạn             |
| search_links      | Tìm kiếm liên kết theo tên, URL hoặc ghi chú                          |
| get_clicks        | Lấy dữ liệu nhấp chuột gần đây                                        |
| get_analytics     | Lấy dữ liệu nhấp chuột theo chuỗi thời gian cho biểu đồ               |
| get_analytics_by | Lấy lượt nhấp được nhóm theo quốc gia, trình duyệt, nền tảng, v.v.   |
| list_domains      | Liệt kê các tên miền tùy chỉnh của bạn                                |
| list_webhooks     | Liệt kê đăng ký webhook của không gian làm việc                       |
| subscribe_webhook | Đăng ký một URL để nhận sự kiện nhấp chuột                            |

## Tùy chọn tạo liên kết

Khi tạo liên kết, bạn có thể chỉ định:

* **Cơ bản:** `url`, `name`, `note`, `domain`, `slug`, `enabled`
* **Tham số UTM:** `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`
* **Open Graph:** `og_title`, `og_description`, `og_image`
* **Theo dõi:** `fb_pixel_id`, `ga4_tag_id`, `gtm_id`
* **Nâng cao:** `cloaking`, `forward_params`, `block_bots`, `hide_referrer`
* **Hết hạn:** `expiry_datetime`, `expiry_destination`

## Khắc phục sự cố

### "Không thể kết nối với MCP server"

* Xác nhận `https://mcp.linklyhq.com` có thể truy cập được từ máy của bạn
* Trong Claude Code, chạy `/mcp` và chọn **linkly** để kích hoạt lại luồng OAuth

### "Xác thực thất bại", "invalid_client", hoặc trình duyệt liên tục yêu cầu đăng nhập

Những lỗi này có nghĩa là ứng dụng khách của bạn đang giữ một đăng ký kết nối cũ. Xóa thông tin xác thực đã lưu trong bộ nhớ đệm và ủy quyền lại. Trong Claude Code, chạy `/mcp` → **linkly** → kết nối lại. Trong Claude Desktop, xóa trình kết nối Linkly trong **Settings → Connectors** và thêm lại, sau đó đăng nhập lại.

### Công cụ không xuất hiện

* Khởi động lại trợ lý AI của bạn sau khi lưu cấu hình
* Kiểm tra cú pháp JSON trong tệp cấu hình của bạn có hợp lệ không
* Xác minh MCP server đang chạy (kiểm tra biểu tượng công cụ trong trợ lý của bạn)

## Tài nguyên liên quan

* Tích hợp Claude Desktop
* Tích hợp ChatGPT
* Tài liệu Linkly API
* Linkly CLI
* Webhooks
* Model Context Protocol

### Dùng thử trình rút gọn URL miễn phí của Linkly

Nhận 100 liên kết rút gọn và 500 lượt nhấp hàng tháng miễn phí. Không cần thẻ tín dụng.

Nhận liên kết miễn phí của bạn

500 lượt nhấp được theo dõi/thángTên miền tùy chỉnhKhông yêu cầu thẻ tín dụng

## Câu hỏi thường gặp về MCP server

### Tôi có cần cài đặt gì để sử dụng MCP server không?

Không. Máy chủ được lưu trữ tại https://mcp.linklyhq.com sử dụng OAuth — bạn đăng nhập một lần trong trình duyệt và trợ lý AI của bạn duy trì kết nối. Không có phần mềm nào cần cài đặt trên máy của bạn ngoài chính trợ lý AI.

### Tôi có cần khóa API không?

Không. MCP server sử dụng OAuth — bạn đăng nhập vào Linkly thông qua trình duyệt lần đầu tiên trợ lý AI kết nối và không có khóa API nào để sao chép hoặc dán vào bất cứ đâu.

### Những trợ lý AI nào hỗ trợ MCP?

Claude Desktop, Claude Code (CLI) và ChatGPT Desktop đều hỗ trợ MCP. Các công cụ khác như Cursor và Windsurf cũng có hỗ trợ MCP.

### Tài khoản của tôi có an toàn không?

Có. Máy chủ được lưu trữ sử dụng OAuth 2.1 với PKCE — mật khẩu Linkly của bạn chỉ được nhập trên app.linklyhq.com và trợ lý AI của bạn chỉ thấy một mã thông báo truy cập được giới hạn trong không gian làm việc của bạn. Bản thân mô hình AI không bao giờ thấy thông tin xác thực của bạn.

### Tôi có thể sử dụng MCP với phiên bản web của Claude hoặc ChatGPT không?

Không, MCP yêu cầu ứng dụng máy tính để bàn hoặc Claude Code CLI. Các phiên bản web không hỗ trợ kết nối MCP.

### Làm cách nào để cập nhật MCP server?

Không có gì để cập nhật — chúng tôi triển khai các cải tiến cho máy chủ được lưu trữ liên tục và mọi ứng dụng khách được kết nối sẽ tự động nhận được chúng.

Tính khả dụng của gói

Có sẵn trên gói Pro trở lên

So sánh các gói →

Miễn phíKhởi đầuProDoanh nghiệpDoanh nghiệp lớn

Nhận 100 liên kết rút gọn và theo dõi 500 lượt nhấp hàng tháng miễn phí.

Bắt đầu miễn phí

Không yêu cầu thẻ tín dụng

Khối lượng lớn? Nói chuyện với đội ngũ của chúng tôi