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 mình 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 rút gọ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 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:

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

Máy chủ MCP hay Linkly CLI?

Nếu trợ lý AI của bạn là một agent 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 là lựa chọn tốt hơn máy chủ MCP. Các agent mã hóa đã quen thuộc với việc sử dụng 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 toàn bộ cây lệnh, vì vậy agent có thể khám phá tất cả những gì 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.

Bạn có thể làm gì

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

• Tạo các liên kết rút gọn - "Tạo một 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ầ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 một địa chỉ đích mới"
• Xem phân tích - "Cho tôi xem các 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 ra mắt sản phẩm"
• Quản lý các 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 các 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 nào để 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 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 vẫn được 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:

https://mcp.linklyhq.com

Nhấp vào Add, sau đó Connect trên bộ kết nối Linkly. Một tab trình duyệt mở ra để 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à ủy quyền trong trình duyệt khi được nhắc.

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

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 rằng 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à máy 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 được lưu trong bộ nhớ cache và ủy quyền lại. Trong Claude Code, chạy /mcp → linkly → kết nối lại. Trong Claude Desktop, hãy xóa bộ kết nối Linkly trong 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ệ hay không
• Xác minh rằng 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

• Claude Desktop Integration
• ChatGPT Integration
• Linkly API Documentation
• Linkly CLI
• Webhooks
• Model Context Protocol