Máy chủ Linkly MCP

Máy chủ Linkly MCP cho phép bạn kết nối các trợ lý AI với tài khoản Linkly của bạn bằng Model Context Protocol. Sau khi kết nối, bạn có thể tạo và quản lý các liên kết ngắn thông qua cuộc trò chuyện tự nhiên.

MCP là gì?

Model Context Protocol (MCP) là một tiêu chuẩn mở cho phép các trợ lý AI kết nối một cách 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 của bạn thực hiện các hành động trực tiếp.

Các trợ lý AI được hỗ trợ

Máy chủ Linkly MCP hoạt động với:

Nơi tìm nó

Máy chủ Linkly MCP được liệt kê trong các thư mục MCP chính, vì vậy bạn có thể cài đặt nó từ bất cứ nơi nào bạn đã tìm kiếm các trình kết nối:

Máy chủ MCP hay CLI của Linkly?

Nếu trợ lý AI của bạn là một tác nhân mã hóa có thể chạy các lệnh shell — chẳng hạn như Claude Code hoặc Cursor — thì Linkly CLI thường phù hợp hơn với máy chủ MCP. Các tác nhân mã hóa đã quen thuộc với việc điều khiển các công cụ dòng lệnh, và CLI cung cấp cho họ đầ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, vì vậy tác nhân có thể khám phá mọi thứ nó có thể làm. Máy chủ MCP 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 bạn:

  • Tạo liên kết ngắn - "Tạo một liên kết ngắ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ần nhấp tuần này?"
  • Quản lý liên kết - "Cập nhật liên kết gọi là 'promo' với đích đến mới"
  • Xem phân tích - "Hiển thị cho tôi lần nhấp theo quốc gia trong 30 ngày qua"
  • Tìm kiếm liên kết - "Tìm tất cả các liên kết liên quan đến việc phát hành sản phẩm"
  • Quản lý miền - "Liệt kê các miền tùy chỉnh của tôi"
  • Thiết lập webhook - "Đăng ký https://my-site.com/webhook để nhận sự kiện nhấp chuột"

Bắt đầu

Máy chủ Linkly MCP được lưu trữ tại https://mcp.linklyhq.com. Không có gì để cài đặt và không có khóa API để sao chép — 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ở 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 vẫn được kết nối.

https://mcp.linklyhq.com

Cấu hình

Claude Desktop

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

https://mcp.linklyhq.com

Nhấp vào Add, sau đó Connect trên trình kết nối Linkly. Một tab trình duyệt sẽ mở để bạn đăng nhập và phê duyệt quyền truy cập. Claude Desktop sau đó vẫn được kết nối — không cần tệp cấu hình hoặc công cụ bổ sung.

Claude Code (CLI)

Claude Code hỗ trợ các máy chủ MCP từ xa một cách tự nhiên. Thêm Linkly bằng một lệnh:

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

Sau đó chạy /mcp bên trong Claude Code, chọn linkly, và phê duyệt trong trình duyệt khi được yêu cầu.

ChatGPT Desktop

Mở tệp cấu hình ChatGPT của bạn:

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

Thêm máy chủ Linkly MCP:

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

Các công cụ có sẵn

Công cụMô tả
create_linkTạo một liên kết ngắn mới với các tham số UTM tùy chọn, pixel, v.v.
update_linkCập nhật cài đặt của một liên kết hiện có
delete_linkXóa một liên kết
get_linkLấy chi tiết của một liên kết cụ thể
list_linksLiệt kê tất cả các liên kết trong không gian làm việc của bạn
search_linksTìm kiếm liên kết theo tên, URL hoặc ghi chú
get_clicksLấy dữ liệu nhấp chuột gần đây
get_analyticsLấy dữ liệu nhấp chuột theo thời gian cho biểu đồ
get_analytics_byLấy các nhấp chuột được nhóm theo quốc gia, trình duyệt, nền tảng, v.v.
list_domainsLiệt kê các miền tùy chỉnh của bạn
list_webhooksLiệt kê các đăng ký webhook 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ố

"Could not connect to 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

"Authentication failed", "invalid_client", hoặc trình duyệt tiếp tục yêu cầu đăng nhập

Những điều 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 đăng nhập được lưu trong bộ nhớ đệm và phê duyệt lại. Trong Claude Code, chạy /mcplinkly → kết nối lại. Trong Claude Desktop, xóa trình kết nối Linkly dưới Settings → Connectors và thêm lại, sau đó đăng nhập lại.

Các 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 xem cú pháp JSON trong tệp cấu hình của bạn có hợp lệ không
  • Xác minh máy chủ MCP đang chạy (kiểm tra biểu tượng công cụ trong trợ lý của bạn)

Các tài nguyên liên quan

Câu hỏi thường gặp về máy chủ MCP

Tôi có cần cài đặt bất cứ thứ gì để sử dụng máy chủ MCP 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 vẫn được kết nối. Không có phần mềm để cài đặt trên máy của bạn ngoài chính trợ lý AI của bạn.

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

Không. Máy chủ MCP sử dụng OAuth — bạn đăng nhập vào Linkly thông qua trình duyệt của bạn lần đầu tiên trợ lý AI của bạn kết nối, và không có khóa API nào để sao chép hoặc dán ở 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 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 token truy cập được giới hạn trong không gian làm việc của bạn. Chính mô hình AI không bao giờ thấy thông tin đăng nhập của bạn.

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

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

Tôi cập nhật máy chủ MCP như thế nào?

Không có gì để cập nhật — chúng tôi triển khai 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 nhận được chúng tự động.

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

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

So sánh các gói cước →

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