# Máy chủ MCP Twitter cho Claude và Cursor Máy chủ MCP Twitter cho Claude và Cursor giúp tác nhân đọc bài đăng X công khai, chuỗi và kết quả tìm kiếm dạng Markdown, tính phí theo bài. Page: https://twitterviewer.app/vi/twitter-mcp-server Giúp Claude, Cursor và Codex đọc nội dung công khai trên X. Một máy chủ từ xa, năm công cụ chỉ đọc, trả về Markdown. Đăng nhập một lần bằng trình duyệt hoặc dùng khóa API. TwitterViewer là dịch vụ độc lập, không phải API chính thức của X và không có liên kết với X Corp. Dịch vụ chỉ đọc bài đăng công khai: không thể đăng bài, thích, theo dõi, gửi tin nhắn hay đọc tài khoản riêng tư. ## Connect Server URL: https://twitterviewer.app/mcp (Streamable HTTP). Lần kết nối đầu tiên sẽ mở trình duyệt để bạn đăng nhập vào TwitterViewer. Không cần cấu hình thêm. ### Claude Code ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` With an API key: ``` claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp \ --header "Authorization: Bearer $TWITTERVIEWER_API_KEY" ``` ### Cursor ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` With an API key: ``` { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp", "headers": { "Authorization": "Bearer ${env:TWITTERVIEWER_API_KEY}" } } } } ``` ### Codex ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` With an API key: ``` [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" bearer_token_env_var = "TWITTERVIEWER_API_KEY" ``` ## Tools | Tool | Arguments | What it does | | --- | --- | --- | | convert_x_url | url, scope, format, stats, max | Turns a post, thread or profile link into Markdown, Obsidian, text or JSON. | | search_x_posts | query, max | Searches public posts (Pro and Business). | | get_x_replies | url, max | Reads the replies under a post. | | get_x_trends | region | Lists trends for a region. | | get_credits | none | Shows the balance. | Máy chủ MCP Twitter giúp trợ lý AI đọc nội dung trên X một cách an toàn. TwitterViewer cung cấp một máy chủ từ xa tại `https://twitterviewer.app/mcp`. Thêm máy chủ này vào Claude, Claude Code, Cursor hoặc Codex, trợ lý có thể chuyển liên kết X thành Markdown, đọc các câu trả lời dưới bài đăng, tìm kiếm bài đăng công khai và xem xu hướng mà bạn không cần sao chép hay dán nội dung. Máy chủ chỉ có quyền đọc. Nó không thể đăng bài, trả lời, thích, theo dõi, gửi tin nhắn hay truy cập tài khoản riêng tư. Đây là dịch vụ độc lập, không có liên hệ với X Corp. Hướng dẫn này giải thích máy chủ MCP Twitter là gì, cách kết nối trong từng ứng dụng, cách đăng nhập, chức năng của năm công cụ, cách tính điểm và cách xử lý các vấn đề thường gặp. ## Máy chủ MCP Twitter là gì? MCP, viết tắt của Model Context Protocol, là một tiêu chuẩn mở cho phép ứng dụng AI gọi các công cụ do chương trình khác cung cấp. Máy chủ MCP Twitter cung cấp các công cụ đọc X (Twitter) thông qua tiêu chuẩn đó. Thay vì dán một chuỗi bài đăng vào cuộc trò chuyện, bạn yêu cầu trợ lý đọc liên kết, rồi trợ lý gọi công cụ, nhận Markdown và xử lý nội dung đó. Máy chủ này chạy từ xa. Bạn không cần cài đặt hay duy trì tiến trình nào trên máy: ứng dụng kết nối đến một URL qua Streamable HTTP. Đây cũng là dịch vụ cung cấp [Twitter API](https://twitterviewer.app/vi/twitter-api), nên dùng chung số điểm, với mỗi bài đăng được trả về tốn một điểm và lần gọi thất bại không bị tính phí. Bạn cũng có thể thấy các tên gọi máy chủ MCP X hoặc MCP Twitter. Chúng đều chỉ cùng một thứ: máy chủ công cụ cho phép tác nhân AI đọc bài đăng công khai. Các máy chủ khác nhau ở chức năng mà chúng cung cấp. Máy chủ này được chủ đích thiết kế để chỉ đọc nội dung công khai. ## Máy chủ MCP Twitter có thể giúp tác nhân AI làm gì? Sau khi kết nối, tác nhân AI có thể thực hiện bốn loại công việc với nội dung trên X: - **Đọc liên kết.** Cung cấp địa chỉ của một bài đăng, chuỗi bài đăng hoặc hồ sơ để nhận lại Markdown, ghi chú Obsidian, văn bản thuần túy hoặc JSON. - **Tìm kiếm.** Yêu cầu tìm bài đăng công khai bằng các toán tử tìm kiếm của X, chẳng hạn mọi bài đăng từ một tài khoản có ít nhất 100 lượt thích. Tính năng tìm kiếm có trong gói Pro và Business. - **Đọc câu trả lời.** Hỏi mọi người đang trả lời gì dưới một bài đăng và những ý kiến phản đối nào xuất hiện nhiều lần. - **Xem xu hướng.** Liệt kê các chủ đề đang thịnh hành trong một khu vực. Vì kết quả được trả về dưới dạng Markdown, chúng chiếm ít dung lượng trong ngữ cảnh của mô hình và giữ nguyên cấu trúc nội dung gốc: thứ tự các bài trong chuỗi, liên kết tác giả chia sẻ và các tham chiếu đến hình ảnh. Tác nhân AI nhận được một tài liệu, không phải tự thu thập nội dung trang web rồi suy đoán. ## Kết nối máy chủ MCP Twitter URL máy chủ là `https://twitterviewer.app/mcp`. Chọn ứng dụng bạn dùng bên dưới. Mỗi đoạn cấu hình đều sử dụng cách đăng nhập qua trình duyệt, cũng là cách đơn giản nhất. ### Claude Code Chạy một lệnh trong cửa sổ dòng lệnh: ```bash claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp ``` Khởi động Claude Code, chạy `/mcp` để xem máy chủ và mở liên kết đăng nhập trong lần đầu sử dụng. Sau đó, yêu cầu bằng ngôn ngữ tự nhiên: "Đọc https://x.com/username/status/1234567890123456789 dưới dạng Markdown." ### Claude Trong Claude trên web hoặc ứng dụng máy tính, mở phần Cài đặt, vào mục Trình kết nối, chọn Thêm trình kết nối tùy chỉnh rồi dán URL máy chủ. Claude mở một cửa sổ trình duyệt để bạn đăng nhập vào TwitterViewer. Sau đó, các công cụ sẽ xuất hiện trong cuộc trò chuyện. ### Cursor Thêm máy chủ vào `mcp.json`: ```json { "mcpServers": { "twitterviewer": { "url": "https://twitterviewer.app/mcp" } } } ``` Mở phần cài đặt MCP của Cursor, bật máy chủ và đăng nhập khi được yêu cầu. ### Codex Thêm máy chủ vào tệp cấu hình Codex: ```toml [mcp_servers.twitterviewer] url = "https://twitterviewer.app/mcp" ``` Khởi động lại Codex để thấy danh sách năm công cụ. ## Đăng nhập bằng trình duyệt hoặc khóa API Có hai cách cấp quyền cho máy chủ MCP Twitter và bạn có thể chọn riêng cho từng ứng dụng. **Đăng nhập qua trình duyệt** là cách mặc định. Lần đầu ứng dụng kết nối, nó sẽ mở trình duyệt để bạn đăng nhập vào TwitterViewer và chấp thuận kết nối. Bạn không cần cấu hình thêm hay sao chép thông tin bí mật nào. **Khóa API** dành cho môi trường không có trình duyệt: máy chủ, tác vụ CI và một số trình soạn thảo. Tạo khóa trên trang API, đặt khóa vào biến môi trường `TWITTERVIEWER_API_KEY` rồi gửi dưới dạng mã thông báo Bearer. Trong Claude Code, thêm `--header "Authorization: Bearer $TWITTERVIEWER_API_KEY"` vào lệnh. Trong Cursor, thêm mục `headers` với cùng giá trị. Trong Codex, thêm `bearer_token_env_var = "TWITTERVIEWER_API_KEY"` bên dưới URL. Dù chọn cách nào, các lần gọi đều được tính vào tài khoản đã đăng nhập. Không lưu khóa trong tệp dùng chung hay kho mã nguồn, và xóa khóa trên trang API nếu bị lộ. Mọi tài khoản đều có thể sở hữu ít nhất một khóa: 1 khóa với tài khoản miễn phí, 2 với Plus, 5 với Pro và 20 với Business. ## Năm công cụ Cả năm công cụ đều chỉ có quyền đọc và xuất hiện với tác nhân AI dưới các tên sau. | Công cụ | Chức năng | Chi phí | | --- | --- | --- | | `convert_x_url` | Chuyển liên kết bài đăng, chuỗi bài đăng hoặc hồ sơ thành Markdown, Obsidian, văn bản hoặc JSON | 1 điểm cho mỗi bài đăng | | `search_x_posts` | Tìm bài đăng công khai bằng toán tử tìm kiếm của X (Pro và Business) | 1 điểm cho mỗi bài đăng | | `get_x_replies` | Đọc các câu trả lời công khai dưới một bài đăng | 1 điểm cho mỗi câu trả lời | | `get_x_trends` | Liệt kê các chủ đề đang thịnh hành trong một khu vực | 1 điểm cho mỗi lần gọi | | `get_credits` | Hiển thị số điểm còn lại và nguồn điểm | Miễn phí | `convert_x_url` nhận liên kết, phạm vi (`post`, `thread` hoặc `conversation`), định dạng và số bài đăng cần trả về nếu liên kết là hồ sơ. Đây là công cụ được tác nhân AI dùng nhiều nhất. `search_x_posts` nhận truy vấn và số bài đăng tối đa, đồng thời cần một tài khoản X đã kết nối vì X chỉ cung cấp tính năng tìm kiếm cho người dùng đã đăng nhập. Danh sách tham số đầy đủ có trong [Tài liệu API](https://twitterviewer.app/docs/api). ## Nên yêu cầu tác nhân AI làm gì? Máy chủ công cụ chỉ hữu ích khi bạn biết cần yêu cầu gì. Những câu lệnh sau hoạt động tốt sau khi máy chủ đã kết nối: - "Đọc chuỗi bài đăng này và nêu năm ý chính: https://x.com/username/status/1234567890123456789" - "Tìm trên X các bài đăng về đợt ra mắt của chúng tôi trong tuần vừa qua và nhóm chúng theo chủ đề." - "Mọi người đang trả lời gì dưới bài đăng này? Hãy chỉ ra những ý kiến phản đối xuất hiện nhiều lần." - "Chuyển chuỗi bài đăng này thành Markdown cho Obsidian và lưu dưới dạng ghi chú." - "Hiện giờ ở Nhật Bản đang có những xu hướng nào?" - "Tôi còn bao nhiêu điểm TwitterViewer?" Tác nhân AI có thể kết hợp các công cụ. Một tác vụ nghiên cứu có thể tìm bài đăng, chuyển đổi ba chuỗi bài đăng phù hợp nhất, đọc câu trả lời dưới một trong số đó rồi viết bản tóm tắt. Mỗi bước là một lần gọi công cụ riêng và được tính điểm theo số bài đăng trả về, nên bạn có thể xem chi phí bằng `get_credits` sau đó. Nếu chỉ cần đọc một chuỗi bài đăng một lần, trang [Chuyển X sang Markdown](https://twitterviewer.app/vi/x-to-markdown) thực hiện cùng công việc trong trình duyệt, còn [Đọc chuỗi bài đăng Twitter](https://twitterviewer.app/vi/twitter-thread-reader) hiển thị toàn bộ chuỗi trên một trang. Máy chủ MCP dành cho tác nhân AI cần tự thực hiện những việc này. ## Các quy trình sử dụng máy chủ MCP Twitter Những câu hỏi riêng lẻ rất dễ xử lý. Máy chủ phát huy giá trị khi tác nhân AI kết hợp các công cụ thành một quy trình nhỏ. Ba cách làm sau được sử dụng thường xuyên. **Sàng lọc danh sách đọc.** Bạn dán mười liên kết X vào cuộc trò chuyện và hỏi những nội dung nào đáng đọc. Tác nhân AI gọi `convert_x_url` cho từng liên kết, đặt `scope` thành `thread` và tắt `stats` để văn bản ngắn gọn, rồi xếp hạng theo lượng thông tin hữu ích mà mỗi nội dung mang lại. Chín trong mười liên kết có thể chỉ chứa một bài đăng, nên chi phí thường gần mười điểm. **Nghiên cứu chủ đề.** Bạn yêu cầu tác nhân AI tìm hiểu mọi người nghĩ gì về một sản phẩm. Nó dùng `search_x_posts` với một vài toán tử, chuyển đổi hai hoặc ba chuỗi bài đăng phù hợp nhất, đọc câu trả lời dưới bài được thảo luận nhiều nhất bằng `get_x_replies`, rồi viết báo cáo ngắn kèm liên kết đến nguồn. Số điểm sử dụng bằng số bài đăng thực tế đã đọc, được `get_credits` hiển thị sau đó. **Lưu ghi chú.** Bạn yêu cầu lưu một chuỗi bài đăng thành ghi chú Obsidian. Tác nhân AI gọi `convert_x_url` với định dạng `obsidian`, bổ sung phần frontmatter chứa tác giả, ngày và liên kết nguồn, rồi ghi tệp vào kho ghi chú của bạn. Kết quả giống với trang [Chuyển X sang Markdown](https://twitterviewer.app/vi/x-to-markdown), nhưng được tạo ngay trong cuộc trò chuyện. Hai thói quen giúp tiết kiệm điểm cho các quy trình này. Hãy yêu cầu đọc chuỗi bài đăng thay vì hồ sơ, trừ khi bạn thực sự cần các bài đăng gần đây, vì một hồ sơ gồm 200 bài đăng tốn 200 điểm. Đồng thời, yêu cầu tác nhân AI dừng lại và hỏi trước khi chuyển đổi quá vài chuỗi bài đăng dài để bạn kiểm soát được số điểm còn lại. ## Điểm và giới hạn Điểm được tính giống như trong REST API. Mỗi bài đăng trả về tốn một điểm. Thông tin tác giả được cung cấp miễn phí. Lần gọi thất bại, kết quả trống hoặc tệp PDF không thể kết xuất đều không bị tính phí. Tài khoản miễn phí được cấp 50 điểm một lần; các gói trả phí bổ sung 3.000, 8.000 hoặc 25.000 điểm mỗi tháng. Các gói điểm 1.000, 6.000 và 20.000 điểm có giá tương ứng $5, $20 và $50, không bao giờ hết hạn. Xem các gói trên trang [Bảng giá](https://twitterviewer.app/vi/pricing). Số lần gọi được giới hạn theo từng tài khoản mỗi phút: 10 với tài khoản miễn phí, 30 với Plus, 60 với Pro và 300 với Business. Nếu tác nhân AI chạy vòng lặp, giới hạn này cũng giúp bảo vệ số điểm của bạn. Khi hết điểm, công cụ không trả về lỗi kèm dấu vết ngăn xếp: nó phản hồi bằng một dòng thông báo và liên kết đến trang bảng giá để tác nhân AI chuyển lại cho bạn. Dữ liệu có cùng giới hạn như API. Chỉ có bài đăng công khai, nên tài khoản riêng tư, bài đăng được bảo vệ, tin nhắn riêng, bài đăng đã xóa và tài khoản bị đình chỉ sẽ không trả về nội dung hữu ích. Nội dung được lưu trong bộ nhớ đệm trong thời gian ngắn, khoảng hai phút đối với bài đăng, nên các chỉnh sửa vừa thực hiện có thể chưa xuất hiện. ## Được thiết kế để chỉ đọc Nhiều người lo ngại khi cho tác nhân AI truy cập tài khoản mạng xã hội, và điều đó có lý: tác nhân có quyền ghi có thể đăng bài nhầm. Máy chủ MCP Twitter này tránh được vấn đề đó. Nó không có công cụ đăng bài, trả lời, thích, đăng lại, theo dõi, chặn hay gửi tin nhắn, và không bao giờ yêu cầu mật khẩu hoặc mã thông báo X của bạn. Điều tệ nhất mà một tác nhân AI nhầm lẫn có thể làm là tiêu điểm để đọc nội dung, và mức tiêu này bị giới hạn bởi tần suất gọi cùng số điểm bạn có. Tìm kiếm là tính năng duy nhất sử dụng tài khoản X, vì X chỉ hiển thị kết quả tìm kiếm cho người dùng đã đăng nhập. Tính năng này dùng tài khoản X do bạn tự kết nối trên gói Pro hoặc Business, chỉ phục vụ những yêu cầu của bạn hoặc tác nhân AI, và bạn có thể ngắt kết nối bất cứ lúc nào. ## Nên dùng máy chủ MCP Twitter, API, CLI hay đổi tên miền? Bốn cách truy cập dùng chung một số dư điểm, vì vậy hãy chọn theo môi trường bạn làm việc. - **Máy chủ MCP:** phù hợp nhất khi trợ lý như Claude, Cursor hoặc Codex cần tự quyết định lúc nào đọc X. Không cần viết mã hay sao chép, dán nội dung. - **REST API:** phù hợp nhất cho các tập lệnh, quy trình xử lý và ứng dụng bạn tự viết. Xem trang [Twitter API](https://twitterviewer.app/vi/twitter-api). - **Công cụ dòng lệnh:** dùng `npx twitterviewer ` để chuyển đổi nhanh trong cửa sổ dòng lệnh hoặc tập lệnh shell. - **Đổi tên miền:** thay `x.com` bằng `twitterviewer.app` trong liên kết rồi gửi kèm khóa; kết quả trả về là Markdown. Một kỹ năng dành cho tác nhân AI tại `/.well-known/agent-skills/twitterviewer/SKILL.md` có thể hướng dẫn tác nhân chọn cách phù hợp khi gặp liên kết X. ## Khắc phục sự cố máy chủ MCP Twitter Nếu máy chủ không kết nối được, hãy kiểm tra những điểm sau trước. - **Ứng dụng báo không thể truy cập máy chủ.** Xác nhận URL chính xác là `https://twitterviewer.app/mcp`. Các ứng dụng chỉ hỗ trợ máy chủ cục bộ cần có cầu nối; Claude Code, Claude, Cursor và Codex kết nối trực tiếp với máy chủ từ xa. - **Đăng nhập qua trình duyệt bị lặp lại.** Hoàn tất đăng nhập trong đúng hồ sơ trình duyệt mà ứng dụng đã mở và bảo đảm bạn đăng nhập vào tài khoản muốn dùng để thanh toán. - **Công cụ báo đã hết điểm.** Kiểm tra `get_credits`, sau đó mua gói điểm trên trang bảng giá hoặc chờ số điểm hằng tháng được cấp lại. - **Yêu cầu tìm kiếm bị từ chối.** Tìm kiếm cần gói Pro hoặc Business và tài khoản X đã kết nối. Kết nối tài khoản tại trang Tài khoản X trong phần cài đặt. - **Liên kết không trả về nội dung.** Bài đăng có thể đã bị xóa hoặc được bảo vệ, hoặc tài khoản bị đình chỉ. Mở liên kết bằng công cụ [Xem hồ sơ Twitter](https://twitterviewer.app/vi/twitter-profile-viewer) để kiểm tra nội dung công khai. - **Bạn thấy thông báo giới hạn tần suất.** Chờ số giây được thông báo hoặc chuyển sang gói có giới hạn mỗi phút cao hơn. ## Câu hỏi thường gặp về Máy chủ MCP Twitter ### Máy chủ MCP Twitter là gì? Máy chủ MCP Twitter cho phép trợ lý AI đọc X thông qua Model Context Protocol. Phiên bản của TwitterViewer chạy từ xa, chỉ có quyền đọc và trả về Markdown, giúp tác nhân AI đọc chuỗi bài đăng, tìm bài đăng, đọc câu trả lời và xem xu hướng ngay trong Claude, Cursor hoặc Codex. ### Đây có phải máy chủ MCP X chính thức không? Không. Đây là dịch vụ độc lập, không liên kết với X Corp. Dịch vụ chỉ đọc bài đăng công khai và không thể đăng bài, thích, theo dõi hay gửi tin nhắn. ### Làm thế nào để thêm máy chủ MCP Twitter vào Claude Code? Chạy `claude mcp add --transport http twitterviewer https://twitterviewer.app/mcp`, sau đó mở `/mcp` trong Claude Code và đăng nhập bằng trình duyệt trong lần đầu sử dụng. Sau đó, yêu cầu trợ lý đọc một liên kết X. ### Máy chủ có hoạt động với Cursor và Codex không? Có. Trong Cursor, thêm URL vào mục `mcpServers` trong `mcp.json`. Trong Codex, thêm khối `[mcp_servers.twitterviewer]` chứa URL. Cả hai đều hỗ trợ đăng nhập qua trình duyệt hoặc dùng khóa API dưới dạng mã thông báo Bearer. ### Tôi có cần khóa API không? Không. Đăng nhập qua trình duyệt không cần khóa. Khóa hữu ích trong môi trường không có trình duyệt, chẳng hạn máy chủ và CI, và bạn có thể tạo khóa trên trang API. ### Các công cụ có thể làm gì? Có năm công cụ: `convert_x_url`, `search_x_posts`, `get_x_replies`, `get_x_trends` và `get_credits`. Tất cả đều chỉ có quyền đọc. Chúng chuyển đổi liên kết, tìm bài đăng công khai, đọc câu trả lời, liệt kê xu hướng và hiển thị số điểm còn lại. ### Chi phí sử dụng là bao nhiêu? Dịch vụ dùng chung điểm với API: mỗi bài đăng trả về tốn một điểm, còn thông tin tác giả và lần gọi thất bại được miễn phí. Tài khoản miễn phí được cấp 50 điểm một lần, còn các gói bổ sung 3.000, 8.000 hoặc 25.000 điểm mỗi tháng. Các gói điểm có giá $5, $20 và $50, không bao giờ hết hạn. ### Tác nhân AI có thể đăng bài hoặc thích thay tôi không? Không. Máy chủ không có công cụ ghi nội dung lên X. Nó không thể đăng bài, trả lời, thích, đăng lại, theo dõi hay gửi tin nhắn, và không bao giờ yêu cầu mật khẩu X của bạn. ### Tại sao tìm kiếm cần gói Pro hoặc Business? X chỉ hiển thị kết quả tìm kiếm cho người dùng đã đăng nhập, nên tính năng tìm kiếm cần tài khoản X. Tính năng này có trong gói Pro và Business, sử dụng tài khoản do bạn tự kết nối. ### Tôi có thể dùng máy chủ MCP Twitter cho tài khoản riêng tư không? Không. Chỉ có nội dung công khai. Tài khoản riêng tư, bài đăng được bảo vệ, tin nhắn riêng và bài đăng đã xóa sẽ không được trả về.