YouTube Transcript MCP Server: Setup Guide for Claude and Other AI Tools

Model Context Protocol chuẩn hóa cách một client AI khám phá và gọi các tool bên ngoài. Bên dưới lớp vỏ, nó là JSON-RPC 2.0 - client hỏi server có những tool nào và schema đầu vào của chúng, sau đó gọi chúng theo tên với các tham số có cấu trúc và nhận lại kết quả có cấu trúc, tất cả trong cùng một lượt trò chuyện.

MCP server chạy trên một trong hai giao thức truyền tải: stdio, nơi client khởi chạy server như một tiến trình con cục bộ (thường dùng cho các tool cần truy cập hệ thống tệp cục bộ), hoặc Streamable HTTP, nơi server ở xa và có thể truy cập qua HTTPS bởi bất kỳ số lượng client nào cùng lúc - đây là cách server này hoạt động. (Một giao thức HTTP+SSE cũ hơn tồn tại trong một số tài liệu nhưng đã bị loại bỏ để ưu tiên Streamable HTTP.) Trên thực tế, điều này nghĩa là bạn không bao giờ phải chạy gì ở máy cục bộ để dùng server này - chỉ cần trỏ client của bạn vào URL.

Các tool có phân trang (search, list-channel, list-playlist) đều nhận một token continuation từ response trước để lấy trang tiếp theo, thay vì một cặp offset/limit.

Đăng ký từ dashboard và tạo một API key - 100 tín dụng được tặng miễn phí, không cần thẻ. Key này chính là bearer token mà MCP server dùng để xác thực với hầu hết client.

Thêm đoạn này vào cấu hình client MCP của bạn (ví dụ claude_desktop_config.json, hoặc qua claude mcp add với Claude Code):

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

Thay sk_live_... bằng API key của riêng bạn. Khởi động lại client hoàn toàn và 6 tool ở trên sẽ tự xuất hiện - hầu hết client chỉ đọc cấu hình này khi khởi động, không phải khi hot reload.

Bất kỳ client nào hỗ trợ MCP server từ xa qua Streamable HTTP với header tùy chỉnh đều dùng cùng cấu trúc cấu hình - chỉ khác nhau về tên file và tên trường bao quanh (ví dụ .cursor/mcp.json của Cursor, bảng cài đặt MCP của Windsurf). Nếu một client chỉ hỗ trợ server dựa trên OAuth thay vì một header bearer tĩnh, hãy dùng luồng OAuth mô tả tiếp theo.

Với các client xác thực MCP server qua OAuth thay vì dán API key (ví dụ connector tùy chỉnh của ChatGPT), server này cũng hỗ trợ OAuth 2.1 với Dynamic Client Registration - trỏ client vào cùng URL server đó và nó sẽ tự khám phá metadata OAuth và dẫn bạn qua một luồng ủy quyền thay vì hỏi trực tiếp bearer token.

Sau khi kết nối, chỉ cần lời nhắc tự nhiên là đủ - mô hình sẽ tự quyết định gọi tool nào:

• "Lấy transcript cho youtube.com/watch?v=dQw4w9WgXcQ và tóm tắt trong 3 gạch đầu dòng."
• "Tìm trên YouTube về 'Next.js server actions' và liệt kê 5 kết quả hàng đầu."
• "Liệt kê mọi video @mkbhd đã đăng và tìm những video nhắc đến 'battery'."