Máy chủ MCP YouTube

Chỉ một URL từ xa duy nhất giúp Claude, ChatGPT, Cursor và bất kỳ client tương thích MCP nào có quyền truy cập YouTube thực sự - transcript, tìm kiếm, kênh và danh sách phát - ngay trong cuộc trò chuyện.

  • ✓100 credit miễn phí để bắt đầu, không cần thẻ tín dụng
  • ✓Một API key dùng được cho cả máy chủ MCP và REST API
  • ✓Kiểm tra video mới nhất của một kênh luôn miễn phí
  • ✓Hoạt động với Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline và Codex

MCP là gì?

Model Context Protocol cho phép trợ lý AI gọi công cụ ngay giữa cuộc trò chuyện thay vì bạn phải sao chép - dán dữ liệu thủ công. Máy chủ này được lưu trữ sẵn - chỉ cần trỏ client đến một URL và nó sẽ tự động khám phá các công cụ khả dụng. Không cần cài đặt hay chạy bất cứ thứ gì cục bộ.

Kết nối trong khoảng một phút

Streamable HTTP. Mọi client bên dưới đều trỏ đến cùng một URL:

https://getyoutubetranscript.com/api/mcp

Claude (Web & Desktop)

Settings -> Connectors -> Add custom connector, sau đó dán URL bên dưới. Claude sẽ yêu cầu bạn đăng nhập và kết nối - không có key nào cần sao chép.

https://getyoutubetranscript.com/api/mcp

ChatGPT

Settings -> Connectors -> Advanced -> Developer mode, thêm connector với URL bên dưới, rồi kết nối và đăng nhập.

https://getyoutubetranscript.com/api/mcp

Claude Code

Chỉ một lệnh duy nhất, dùng API key từ dashboard của bạn:

claude mcp add --transport http getyoutubetranscript https://getyoutubetranscript.com/api/mcp \
  --header "Authorization: Bearer sk_live_..."

Cursor

Thêm vào ~/.cursor/mcp.json (mọi dự án) hoặc .cursor/mcp.json (chỉ dự án này):

{
  "mcpServers": {
    "getyoutubetranscript": {
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

VS Code (Copilot)

Thêm vào .vscode/mcp.json. VS Code sẽ hỏi key một lần qua ô nhập bên dưới và lưu an toàn thay vì ghi thẳng vào file:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "gyt-api-key",
      "description": "GetYouTubeTranscript API key",
      "password": true
    }
  ],
  "servers": {
    "getyoutubetranscript": {
      "type": "http",
      "url": "https://getyoutubetranscript.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:gyt-api-key}"
      }
    }
  }
}

Codex CLI

Thêm vào ~/.codex/config.toml, sau đó export biến môi trường được tham chiếu:

[mcp_servers.getyoutubetranscript]
url = "https://getyoutubetranscript.com/api/mcp"
bearer_token_env_var = "GYT_API_KEY"
export GYT_API_KEY="sk_live_..."

Windsurf & Cline

Cùng định dạng JSON mcpServers như Cursor ở trên, trong file cấu hình MCP riêng của Windsurf hoặc Cline.

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

ToolChức năngChi phí
get_youtube_transcriptTranscript đầy đủ cùng tiêu đề, tác giả, thumbnail1 tín dụng
search_youtubeTìm kiếm video hoặc kênh, có phân trang1 tín dụng
get_channel_latest_videosMetadata của một kênh và các video mới đăng gần đâyMiễn phí
search_channel_videosTìm kiếm trong một kênh1 tín dụng
list_channel_videosMọi video một kênh đã đăng1 tín dụng
list_playlist_videosMọi video trong một playlist1 tín dụng
get_creditsSố dư tín dụng còn lại của keyMiễn phí

Cùng công cụ, cùng chi phí credit, như REST API - xem tài liệu API để biết các endpoint tương ứng.

Trông như thế nào trong cuộc trò chuyện

> Video mới nhất của 3Blue1Brown nói gì về mạng nơ-ron?

Tôi sẽ kiểm tra kênh để tìm video mới nhất, sau đó lấy transcript của nó.

get_channel_latest_videos(channel: "@3blue1brown")

get_youtube_transcript(video_url: "...")

Video mới nhất giải thích lan truyền ngược như việc liên tục tự hỏi "thay đổi nhỏ ở con số này ảnh hưởng thế nào đến chi phí cuối cùng?" - bao gồm quy tắc chuỗi, vector gradient, và lý do các mạng sâu hơn cần khởi tạo cẩn thận hơn...

Giá

100 credit miễn phí để bắt đầu. Sau đó $5/tháng cho 1.000 credit ($4.50/tháng nếu thanh toán theo năm). Một credit tương ứng một lượt gọi công cụ thành công - các lượt gọi thất bại hoặc bị giới hạn tốc độ không bao giờ bị tính phí. Chi tiết đầy đủ, gồm cả giới hạn tốc độ theo từng gói, có trong tài liệu API.

Lưu ý

Đang xây dựng client riêng, hay đưa vào công cụ sinh mã? Toàn bộ hợp đồng endpoint REST được công bố tại /openapi.json (OpenAPI 3.0) - chính là các endpoint mà những công cụ MCP này gọi bên dưới. Phiên bản dễ đọc cho con người: tài liệu API.

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

Máy chủ này hoạt động với những client MCP nào?

Bất kỳ client nào nói được MCP qua Streamable HTTP: Claude (web, desktop, Code), ChatGPT, Cursor, VS Code, Windsurf, Cline và Codex CLI đã được đề cập ở trên. Nếu một client hỗ trợ máy chủ MCP HTTP từ xa, nó cũng sẽ hoạt động ở đây.

Tôi có cần cài đặt hoặc chạy gì không?

Không. Máy chủ được lưu trữ tại getyoutubetranscript.com - client chỉ cần URL (và, với các client không dùng OAuth, một API key). Không có tiến trình cục bộ, không yt-dlp, không cần quản lý proxy.

Khác gì so với một máy chủ MCP mã nguồn mở mà tôi tự chạy?

Một máy chủ tự lưu trữ chạy trên máy hoặc server của riêng bạn và thường yêu cầu bạn tự quản lý việc truy cập YouTube (cookie, proxy, giới hạn tốc độ). Máy chủ này được lưu trữ sẵn: đăng ký tự phục vụ, các yêu cầu chạy qua hạ tầng của chúng tôi, và bạn được tính phí bằng credit thay vì phải quản lý hạ tầng scraping.

Tôi gặp lỗi 401 - phải làm gì?

Với các client dùng OAuth (Claude, ChatGPT), hãy kết nối lại connector từ trang cài đặt của nó - kết nối có thể đã hết hạn hoặc bị thu hồi. Với các client dùng API key (Cursor, VS Code, Claude Code, Codex), kiểm tra xem key đã được dán đúng, không có khoảng trắng thừa, và chưa bị thu hồi từ dashboard.

Trợ lý của tôi trả lời theo trí nhớ thay vì gọi công cụ

Đôi khi mô hình cho rằng mình đã biết nội dung video. Hãy yêu cầu rõ ràng: "dùng công cụ MCP YouTube để lấy transcript trước" - thường thì như vậy đã đủ để buộc gọi công cụ.

Điều gì xảy ra nếu video không có phụ đề ở ngôn ngữ tôi yêu cầu?

get_youtube_transcript trả về lỗi TRANSCRIPT_NOT_FOUND thay vì đoán sai ngôn ngữ. Hãy thử lại không kèm tham số language (mặc định là tiếng Anh) hoặc kiểm tra trước xem video đó có thực sự có phụ đề ở ngôn ngữ đó trên YouTube không.

Việc này có tiêu tốn hạn ngạch YouTube Data API của tôi không?

Không. Nó không chuyển tiếp captions.download bằng key của riêng bạn, nên không có giới hạn 10.000 đơn vị mỗi ngày cần quản lý - chỉ có giới hạn tốc độ yêu cầu theo gói của bạn.

Tôi có thể dùng cùng một API key cho cả MCP và REST API không?

Có - một key, một số dư credit, dùng chung cho cả hai. Kết nối qua OAuth (connector của Claude/ChatGPT) thay vì key vẫn sử dụng cùng số dư tài khoản đó; chúng tôi tạo một key riêng ở phía sau xuất hiện trong danh sách key trên dashboard của bạn, để bạn có thể xem hoặc thu hồi kết nối này như bất kỳ key nào khác.