MMO ALL

Documentation

Kết nối MMO ALL với AI của bạn qua MCP

MMO ALL cung cấp một MCP server để Claude, ChatGPT, Cursor, Copilot hay Gemini đọc và đăng nội dung trên nền tảng ngay trong khung chat — không cần copy/paste, không cần tự viết code gọi API.

Last updated:

1. MCP là gì và bạn được gì

Model Context Protocol (MCP) là chuẩn mở để một ứng dụng AI kết nối tới nguồn dữ liệu và công cụ bên ngoài. Thay vì bạn mô tả lại nội dung MMO ALL cho AI, AI tự gọi tới nền tảng và lấy đúng dữ liệu nó cần.

MMO ALL chạy MCP server ở chế độ Streamable HTTP: bạn chỉ cần khai báo một URL và một token trong công cụ AI đang dùng, không phải cài thêm phần mềm nào (trừ vài công cụ chỉ chạy được tiến trình cục bộ — xem mục 3).

  • Hỏi AI về thị trường: “Có source crawler nào dưới 2 triệu, license rõ ràng không?” — AI gọi list_sources rồi trả lời bằng dữ liệu thật.
  • Nghiên cứu trước khi viết: AI đọc bài viết và bình luận cùng chủ đề để bạn không viết trùng thứ đã có.
  • Soạn và đăng bài ngay trong khung chat, sau khi bạn đọc lại và duyệt nội dung.
  • Theo dõi việc làm: lọc tin tuyển dụng khớp kỹ năng của bạn rồi soạn thư ứng tuyển từ chính hồ sơ MMO ALL.

2. Chuẩn bị: endpoint và token

Token là chìa khoá để MCP server biết bạn là ai. Không có token, server vẫn chạy nhưng chỉ trả về dữ liệu công khai — các công cụ có tiền tố create_, apply_ hay list_my_ sẽ báo lỗi thiếu quyền.

Token chỉ hiển thị đúng một lần lúc tạo — lưu lại ngay, mất thì tạo cái mới chứ không xem lại được. Khi tạo, chỉ chọn những phạm vi quyền bạn thật sự cần (xem mục 5).

Endpoint

url
https://api.mmoall.com/mcp

Create a token on the MCP tab of your settings, then swap it in for the sample token in the snippets below.

3. Cấu hình theo từng công cụ AI

Pick the tool you use. Every client has its own config format, so paste its snippet into the exact file listed with it.

Paste into
Terminal — thêm --scope user để dùng cho mọi dự án
Connection
Streamable HTTP, direct
bash
claude mcp add --transport http mmoall https://api.mmoall.com/mcp \
  --header "Authorization: Bearer mmo_pat_xxxxxxxxxxxxxxxx"

Note: Kiểm tra lại bằng claude mcp list, hoặc gõ /mcp trong phiên Claude Code đang mở.

Official Claude Code documentation →

4. Danh sách công cụ (tools)

The MCP server exposes 22 tools. You never have to name them — ask in plain language and the model picks. The list below is here so you know what it can reach and what that costs in permissions.

Tìm kiếm

Điểm vào chung cho mọi loại nội dung. Nếu chưa biết slug của thứ cần lấy, gọi công cụ này trước rồi mới gọi các công cụ get_*.

search_mmoallcontent.read

Tìm bài viết, source code, tool và việc làm bằng một truy vấn duy nhất.

  • q · stringrequiredTừ khoá tìm kiếm.
  • type · stringGiới hạn theo loại: "post" | "source" | "tool" | "job". Bỏ trống để tìm tất cả.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.

Bài viết & thảo luận

Đọc và tạo nội dung trên feed cộng đồng.

list_postscontent.read

Liệt kê bài viết mới nhất, lọc theo chuyên mục hoặc theo tác giả.

  • category · stringSlug chuyên mục, ví dụ automation.
  • author · stringUsername của tác giả.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
get_postcontent.read

Lấy toàn bộ nội dung một bài viết, kèm tác giả, chuyên mục và số liệu tương tác.

  • slug · stringrequiredSlug bài viết.
list_trending_postscontent.read

Bài viết đang được đọc và tương tác nhiều nhất.

  • limit · numberSố bài trả về, tối đa 20. Mặc định 5.
list_post_commentscontent.read

Đọc bình luận của một bài viết, bao gồm các trả lời lồng nhau.

  • slug · stringrequiredSlug bài viết.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
create_postcontent.write

Đăng bài viết mới. Bài xuất hiện công khai ngay dưới tên tài khoản của bạn. Muốn chèn ảnh: gọi upload_image trước để lấy đường dẫn, rồi đặt ![chú thích](đường-dẫn) trên một dòng riêng.

  • title · stringrequiredTiêu đề bài viết.
  • summary · stringrequiredTóm tắt hiển thị ở feed.
  • category · stringrequiredSlug chuyên mục.
  • content · stringrequiredNội dung dạng Markdown. Ảnh phải đứng riêng một dòng thì mới thành khối ảnh; ảnh nằm lẫn trong đoạn văn chỉ còn lại phần chú thích.
  • tags · string[]Tối đa 5 thẻ.
upload_imagecontent.write

Tải ảnh lên kho công khai và nhận lại đường dẫn để dán vào nội dung bài viết. Ảnh gửi dưới dạng base64, tối đa 5 MB, định dạng png/jpg/jpeg/webp/gif. Ảnh không được dùng trong bài viết nào sẽ bị xoá sau một ngày, nên hãy đăng bài ngay trong cùng phiên làm việc.

  • fileName · stringrequiredTên file kèm đuôi, ví dụ anh-minh-hoa.png — đuôi quyết định định dạng được nhận.
  • data · stringrequiredNội dung ảnh mã hoá base64 (không kèm tiền tố data:image/...;base64,).
create_commentcontent.write

Bình luận vào một bài viết, hoặc trả lời một bình luận có sẵn.

  • slug · stringrequiredSlug bài viết.
  • content · stringrequiredNội dung bình luận.
  • parentId · stringID bình luận cha khi muốn trả lời.

Marketplace

Source code và tool đang được rao bán, kèm giá, license và thông tin người bán.

list_sourcesmarket.read

Liệt kê source code đang bán, lọc theo chuyên mục hoặc người bán.

  • category · stringSlug chuyên mục.
  • seller · stringUsername người bán.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
get_sourcemarket.read

Chi tiết một source: mô tả, tech stack, license, giá và đánh giá.

  • slug · stringrequiredSlug source.
list_toolsmarket.read

Liệt kê tool và SaaS đang bán.

  • category · stringSlug chuyên mục.
  • seller · stringUsername người bán.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
get_toolmarket.read

Chi tiết một tool: tính năng, bảng giá, nền tảng hỗ trợ và đánh giá.

  • slug · stringrequiredSlug tool.
create_sourcemarket.write

Đăng một source code open-source mới lên marketplace dưới tên tài khoản của bạn. Chỉ đăng được source dẫn về repo công khai — MCP không có kênh tải file lên, nên không bán được source đính kèm file.

  • title · stringrequiredTên source.
  • summary · stringrequiredMô tả ngắn.
  • category · stringrequiredSlug chuyên mục.
  • repoUrl · stringrequiredLink repo công khai chứa source. Listing đăng qua MCP luôn là miễn phí vì người mua tự lấy source từ repo.
  • license · stringLicense đi kèm, ví dụ MIT.

Việc làm

Bảng tin tuyển dụng và freelance.

list_jobsjobs.read

Liệt kê tin tuyển dụng đang mở.

  • type · stringNhóm công việc: "DEV" | "AUTOMATION" | "CONTENT" | "DESIGN". Giá trị không khớp trả về trang rỗng, không phải lỗi.
  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
get_jobjobs.read

Chi tiết một tin tuyển dụng: mô tả, yêu cầu, mức lương và nhà tuyển dụng.

  • slug · stringrequiredSlug tin tuyển dụng.
apply_jobjobs.write

Nộp đơn ứng tuyển cho một tin. Đơn được gửi dưới tên tài khoản của bạn.

  • slug · stringrequiredSlug tin tuyển dụng.
  • coverLetter · stringrequiredThư giới thiệu.

Cộng đồng & tài khoản

Hồ sơ thành viên, chuyên mục, số liệu nền tảng và dữ liệu của chính bạn.

get_user_profileprofile.read

Hồ sơ công khai của một thành viên: giới thiệu, kỹ năng, reputation và số liệu.

  • username · stringrequiredUsername cần xem.
list_top_contributorsprofile.read

Những thành viên đóng góp nhiều nhất trong cộng đồng.

  • limit · numberSố thành viên trả về, tối đa 20. Mặc định 5.
list_categoriescontent.read

Toàn bộ chuyên mục cùng slug — dùng để lọc ở các công cụ list_*.

No parameters.

get_platform_statscontent.read

Số liệu tổng quan của nền tảng: thành viên, bài viết, source, tool, việc làm.

No parameters.

list_my_bookmarksprofile.read

Các bài viết chính bạn đã lưu.

  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.
list_my_applicationsprofile.read

Trạng thái các đơn ứng tuyển bạn đã nộp.

  • page · numberTrang, tính từ 0. Mặc định 0.
  • size · numberSố bản ghi mỗi trang, tối đa 50. Mặc định 20.

5. Phạm vi quyền của token

Every token carries a set of scopes. The scope each tool needs is printed next to its name above.

  • content.readĐọc bài viết, bình luận, chuyên mục và kết quả tìm kiếm.
  • content.writeĐăng bài viết và bình luận dưới tên tài khoản của bạn.
  • market.readĐọc danh sách và chi tiết source code, tool đang bán.
  • market.writeĐăng source code hoặc tool mới lên marketplace.
  • jobs.readĐọc tin tuyển dụng và mô tả công việc.
  • jobs.writeĐăng tin tuyển dụng và nộp đơn ứng tuyển.
  • profile.readĐọc hồ sơ công khai, bài đã lưu và đơn ứng tuyển của chính bạn.

Write scopes are tinted amber because they change public data under your name. Grant them only when you actually need them.

6. Ví dụ prompt để bắt đầu

Once you are connected, try these to check the wiring:

  • Dùng MMO ALL: tìm 5 source code về automation Telegram, so sánh giá, license và đánh giá rồi lập bảng.
  • Đọc 10 bài viết mới nhất trong chuyên mục AI trên MMO ALL và tóm tắt các chủ đề đang được quan tâm.
  • Tôi muốn viết bài về n8n. Kiểm tra trên MMO ALL đã có bài nào tương tự chưa, rồi đề xuất một góc viết chưa ai làm.
  • Lọc tin tuyển dụng freelance trên MMO ALL hợp với kỹ năng trong hồ sơ của tôi, rồi soạn thư ứng tuyển cho tin phù hợp nhất.

7. Bảo mật

Token MCP tương đương mật khẩu tài khoản trong phạm vi quyền mà nó mang. Hãy đối xử với nó như vậy.

  • Chỉ cấp phạm vi tối thiểu. Nếu chỉ cần AI đọc và tổng hợp, đừng bật các quyền *.write.
  • Đừng commit token vào Git. Với VS Code hãy dùng khối inputs như mẫu ở mục 3 — token nằm trong secret storage của trình soạn thảo, không nằm trong file.
  • Mỗi máy một token. Khi mất máy hoặc rời khỏi một dự án, thu hồi đúng token đó thay vì đổi toàn bộ.
  • Luôn đọc lại trước khi duyệt. Công cụ ghi đăng nội dung công khai dưới tên bạn, và AI có thể hiểu sai ý bạn.
  • Cảnh giác với prompt injection: nội dung do người khác đăng lên MMO ALL cũng đi vào ngữ cảnh của AI. Hãy coi nó là dữ liệu, đừng để AI tự động làm theo chỉ dẫn nằm trong một bài viết hay bình luận.

8. Khắc phục sự cố

Công cụ AI báo không kết nối được server
Kiểm tra endpoint đã đúng chưa và máy bạn có ra được internet tới host đó không. Với bản tự triển khai, endpoint là địa chỉ backend của bạn kèm /mcp chứ không phải địa chỉ của mmoall.com.
Kết nối được nhưng không thấy tool nào
Phần lớn công cụ chỉ nạp danh sách tool lúc khởi động. Khởi động lại ứng dụng (hoặc bấm Refresh ở panel MCP), rồi kiểm tra bằng /mcp với Claude Code và Gemini CLI.
Lỗi 401 hoặc “unauthorized”
Token sai, hết hạn hoặc bị thu hồi. Tạo token mới ở tab MCP trong Cài đặt và nhớ giữ nguyên tiền tố Bearer trước token trong header Authorization.
Lỗi 403 khi AI cố đăng bài hoặc nộp đơn
Token thiếu phạm vi ghi tương ứng. Tạo lại token với content.write, market.write hoặc jobs.write tuỳ việc bạn cần.
AI gọi tool liên tục rồi bị giới hạn tốc độ
Server giới hạn theo token. Hãy yêu cầu AI thu hẹp truy vấn — dùng search_mmoall trước để tìm đúng slug, thay vì duyệt hết từng trang bằng list_posts.

Still not working?

Send the MMO ALL team your AI tool, the config you used (with the token removed) and the error you got. We reply within 1–2 business days.

Contact support →