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.

Tài liệu

Máy chủ Bitly MCP

Chào mừng bạn đến với hướng dẫn về Máy chủ Bitly MCP.

Nếu bạn đang ở đây, có lẽ bạn đã biết Máy chủ MCP là gì, nhưng nếu cần tìm hiểu cơ bản, hãy xem trang MCP là gì? của chúng tôi.

Máy chủ Bitly MCP 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ừ mộ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 chọn.

Bạn muốn sử dụng Bitly với ChatGPT? Máy chủ Bitly MCP hoặc Bitly Custom GPT. Bạn muốn sử dụng Bitly với Claude? Máy chủ Bitly MCP. Bạn muốn sử dụng Bitly với Cursor, VSCode hoặc Windsurf? Máy chủ Bitly MCP.

Thiết lập nhanh

Máy chủ Bitly MCP đượ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 mã thông báo an toàn với đăng ký ứng dụng khách tự động
  • Mã thông báo API – 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 mã thông báo Bitly API của bạn từ https://bitly.com/settings/api

Dưới đây là bảng cấu hình kèm liên kết đến hướng dẫn chi tiết -- nếu chúng tôi thiếu cấu hình bạn đang 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 Đăng ký ứng dụng khách động
Giao diện Web Claude (claude.ai)Cấu hình Claude WebOAuth với Đăng ký ứng dụng khách động
Claude DesktopCấu hình Claude DesktopHỗ trợ cả OAuth và mã thông báo API
Claude CodeCấu hình Claude CodeTruyền tải HTTP – hỗ trợ cả OAuth và mã thông báo API
CursorCấu hình CursorTruyền tải HTTP – hỗ trợ cả OAuth và mã thông báo API
VS CodeCấu hình VS CodeTruyền tải HTTP – hỗ trợ cả OAuth và mã thông báo API
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 Mã thông báo API:

{
  "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:

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.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

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

Dành cho Mã thông báo API (sử dụng proxy npx):

Điều kiện tiên quyết: Yêu cầu Node.js 20 LTS trở lên có 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 không gian làm việc của bạn:

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

{
  "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:


### Claude Web

For Claude on the web (claude.ai), use OAuth authentication:

1. Navigate to your Claude workspace settings
2. Go to the MCP servers configuration section
3. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. Claude will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** OAuth support in Claude Web requires Workspace Admin enablement for Team and Enterprise Plans.

### ChatGPT

For ChatGPT, use OAuth authentication:

1. In ChatGPT, go to **Settings > Apps & Connectors > Advanced Settings**
2. Toggle **Developer Mode** on
3. Go back and click **Create**
4. Add the Bitly MCP Server:  
   * **Server URL:** `https://api-ssl.bitly.com/v4/mcp`  
   * **Authentication:** OAuth

When prompted, log in to your Bitly account and authorize the connection. ChatGPT will handle the OAuth flow automatically using Dynamic Client Registration.

> **Note:** MCP support in ChatGPT requires Plus, Team, Enterprise, or Edu plans. For workspace plans, you must be an admin to access these settings.

## Authentication

The Bitly MCP Server supports two authentication methods:

### OAuth 2.1 with Dynamic Client Registration (Recommended)

For clients that support OAuth (like Claude Web, ChatGPT, and other modern AI assistants), OAuth provides:

* **Enhanced Security** \- No need to manually manage API tokens
* **Automatic Client Registration** \- Dynamic Client Registration (DCR) handles client setup automatically
* **Token Refresh** \- Automatic token renewal without manual intervention

When configuring OAuth, your AI client will:

1. Redirect you to Bitly's authorization page
2. Ask you to log in and authorize the connection
3. Automatically register as an OAuth client using DCR
4. Receive and manage access tokens transparently

### API Token (Alternative)

For simpler setups or clients without OAuth support:

1. Log in to your Bitly account at bitly.com
2. Navigate to Settings → API
3. Click Generate Access Token
4. Copy the token and store it securely
5. Use it in your MCP client configuration as shown in the examples above

## Test It Out

Once configured, try asking your AI:

"Có những công cụ Bitly nào khả dụng?"

"Vui lòng rút ngắn URL này: https://example.com/very-long-url"


Từ đó trở đi bạn đã sẵn sàng!

---