Bitly MCP Server

chính thức

Biến trợ lý AI của bạn thành trung tâm tiếp thị kỹ thuật số có khả năng tạo, tổ chức và phân tích các liên kết cũng như mã QR theo yêu cầu.

Bạn có thể làm gì với Bitly MCP?

  • Rút gọn URL — Yêu cầu AI của bạn rút gọn một URL dài, ví dụ: "Vui lòng rút gọn URL này: https://example.com/very-long-url"
  • Khám phá các công cụ có sẵn — Hỏi AI của bạn "Có những công cụ Bitly nào khả dụng?" để liệt kê các khả năng của máy chủ MCP
  • Quản lý liên kết Bitly — Sử dụng máy chủ MCP để tạo, truy xuất và quản lý các liên kết ngắn thông qua API Bitly

Tài liệu

Bitly MCP Server

Chào mừng bạn đến với hướng dẫn Bitly MCP Server.

Nếu bạn đang ở đây, có lẽ bạn đã biết MCP Server là gì, nhưng nếu bạn cần phần giới thiệu cơ bản, hãy xem trang What is MCP? của chúng tôi.

Bitly MCP Server cung cấp quyền truy cập vào tất cả các chức năng mà bạn mong đợi từ giao diện Bitly -- như Bitly API, như trang web bitly.com, như Bitly Chrome Extension, như ứng dụng Bitly Mobile -- nhưng lần này dành cho tác nhân AI mà bạn lựa chọn.

Muốn sử dụng Bitly với ChatGPT? Bitly MCP Server hoặc Bitly Custom GPT. Muốn sử dụng Bitly với Claude? Bitly MCP Server. Muốn sử dụng Bitly với Cursor, VSCode hoặc Windsurf? Bitly MCP Server.

Thiết lập nhanh

Bitly MCP Server được lưu trữ tại https://api-ssl.bitly.com/v4/mcp.

Tùy chọn xác thực:

  • OAuth 2.1 (Khuyến nghị) - Dành cho các ứng dụng khách hỗ trợ OAuth, phương thức này cung cấp xác thực dựa trên token an toàn với đăng ký ứng dụng khách tự động
  • API Token - Dành cho các thiết lập đơn giản hơn hoặc ứng dụng khách không hỗ trợ OAuth, hãy sử dụng token API Bitly của bạn từ https://bitly.com/settings/api

Dưới đây là bảng cấu hình với các liên kết đến hướng dẫn chi tiết -- nếu chúng tôi thiếu một cấu hình mà bạn sử dụng, bạn sẽ tìm thấy hướng dẫn trên trang Chi tiết cấu hình. Chúng tôi sẽ bổ sung thêm các hướng dẫn cấu hình theo thời gian.

Tác nhân AIHướng dẫn cấu hìnhGhi chú
ChatGPTCấu hình ChatGPTOAuth với Dynamic Client Registration
Giao diện Claude Web (claude.ai)Cấu hình Claude WebOAuth với Dynamic Client Registration
Claude DesktopCấu hình Claude DesktopHỗ trợ cả OAuth và API token
Claude CodeCấu hình Claude CodeHTTP transport – hỗ trợ cả OAuth và API token
CursorCấu hình CursorHTTP transport – hỗ trợ cả OAuth và API token
VS CodeCấu hình VS CodeHTTP transport – hỗ trợ cả OAuth và API token
WindsurfCấu hình WindsurfSử dụng proxy npx cho kết nối cục bộ
Hầu hết các tác nhân tương thích HTTP khácXem phần Cấu hình của chúng tôiThiết lập HTTP chung hoạt động cho hầu hết

Cấu hình

Claude Code

Thêm vào ~/.claude/mcp.json:

Dành cho OAuth (khuyến nghị):

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Dành cho API Token:

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Khởi động lại Claude Code sau khi thêm cấu hình.

Cursor

Thêm vào ~/.cursor/mcp.json:

Dành cho OAuth (khuyến nghị):

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Dành cho API Token:

{
  "mcpServers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Khởi động lại Cursor sau khi thêm cấu hình.

Claude Desktop

Thêm vào tệp cấu hình Claude của bạn:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Dành cho OAuth (khuyến nghị):

{
  "mcpServers": {
    "Bitly": {
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Dành cho API Token (sử dụng npx proxy):

Điều kiện tiên quyết: Yêu cầu Node.js 20 LTS trở lên với hỗ trợ npx.

{
  "mcpServers": {
    "Bitly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api-ssl.bitly.com/v4/mcp",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Khởi động lại Claude Desktop sau khi thêm cấu hình.

VS Code

Thêm vào ~/.vscode/mcp.json trong workspace của bạn:

Dành cho OAuth (khuyến nghị):

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp"
    }
  }
}

Dành cho API Token:

{
  "servers": {
    "Bitly": {
      "type": "http",
      "url": "https://api-ssl.bitly.com/v4/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Windsurf

Thêm vào ~/.windsurf/config.json:

{
  "mcpServers": {
    "Bitly": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api-ssl.bitly.com/v4/mcp",
        "--header",
        "Authorization: Bearer ${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "YOUR_BITLY_AUTH_TOKEN"
      }
    }
  }
}

Claude Web

Đối với Claude trên web (claude.ai), hãy sử dụng xác thực OAuth:

  1. Điều hướng đến cài đặt workspace Claude của bạn
  2. Đi đến phần cấu hình máy chủ MCP
  3. Thêm Bitly MCP Server:
    • Server URL: https://api-ssl.bitly.com/v4/mcp
      • Xác thực: OAuth

Khi được nhắc, hãy đăng nhập vào tài khoản Bitly của bạn và ủy quyền kết nối. Claude sẽ tự động xử lý quy trình OAuth bằng Dynamic Client Registration.

Lưu ý: Hỗ trợ OAuth trong Claude Web yêu cầu quản trị viên Workspace kích hoạt cho các gói Team và Enterprise.

ChatGPT

Đối với ChatGPT, hãy sử dụng xác thực OAuth:

  1. Trong ChatGPT, đi đến Cài đặt > Apps & Connectors > Cài đặt nâng cao
  2. Bật Chế độ nhà phát triển
  3. Quay lại và nhấp Tạo
  4. Thêm Bitly MCP Server:
    • Server URL: https://api-ssl.bitly.com/v4/mcp
      • Xác thực: OAuth

Khi được nhắc, hãy đăng nhập vào tài khoản Bitly của bạn và ủy quyền kết nối. ChatGPT sẽ tự động xử lý quy trình OAuth bằng Dynamic Client Registration.

Lưu ý: Hỗ trợ MCP trong ChatGPT yêu cầu các gói Plus, Team, Enterprise hoặc Edu. Đối với các gói workspace, bạn phải là quản trị viên để truy cập các cài đặt này.

Xác thực

Bitly MCP Server hỗ trợ hai phương thức xác thực:

OAuth 2.1 với Dynamic Client Registration (Khuyến nghị)

Đối với các ứng dụng khách hỗ trợ OAuth (như Claude Web, ChatGPT và các trợ lý AI hiện đại khác), OAuth cung cấp:

  • Bảo mật nâng cao - Không cần quản lý API token thủ công
  • Đăng ký ứng dụng khách tự động - Dynamic Client Registration (DCR) xử lý thiết lập ứng dụng khách tự động
  • Làm mới token - Gia hạn token tự động mà không cần can thiệp thủ công

Khi cấu hình OAuth, ứng dụng khách AI của bạn sẽ:

  1. Chuyển hướng bạn đến trang ủy quyền của Bitly
  2. Yêu cầu bạn đăng nhập và ủy quyền kết nối
  3. Tự động đăng ký làm ứng dụng khách OAuth bằng DCR
  4. Nhận và quản lý access token một cách minh bạch

API Token (Phương án thay thế)

Dành cho các thiết lập đơn giản hơn hoặc ứng dụng khách không hỗ trợ OAuth:

  1. Đăng nhập vào tài khoản Bitly của bạn tại bitly.com
  2. Đi đến Cài đặt → API
  3. Nhấp vào Tạo Access Token
  4. Sao chép token và lưu trữ an toàn
  5. Sử dụng nó trong cấu hình ứng dụng khách MCP của bạn như trong các ví dụ ở trên

Thử nghiệm

Sau khi cấu hình xong, hãy thử hỏi AI của bạn:

"What Bitly tools are available?"

hoặc

"Please shorten this URL: https://example.com/very-long-url"

Từ đó, bạn đã sẵn sàng!