Cài MCP Sensor Tower (IEC)

Dùng data Sensor Tower ngay trong khung chat của ChatGPT, Codex, Claude: report game, tìm đối thủ, phân tích creative, so sánh số liệu.

URL MCP (dán vào app): https://ww-sensor-tower-mcp.haleinteractive.vn/mcp

Cách hoạt động

Bạn hỏi trong app chatChatGPT / Codex / Claude

MCP Sensor Tower IECkiểm quyền, xem cache

Sensor Tower APIchỉ gọi khi cache chưa có

Trả lời kèm số liệughi kỳ, filter, quota

App chat tự chọn tool phù hợp với câu hỏi, bạn không cần nhớ tên tool.
Câu đã có người hỏi rồi thì lấy từ cache dùng chung, không tốn quota.
Đăng nhập bằng tài khoản Google công ty, quyền kiểm trên web-admin.

Trước khi cài

Tài khoản Google công ty phải có trên web-admin (đăng nhập được https://ww-core-web-admin.haleinteractive.vn).
Được cấp quyền Sensor Tower MCP - Dùng. Chưa có thì nhắn Quang BD.
Khi đăng nhập, luôn chọn tài khoản Google công ty, không chọn Gmail cá nhân.

Đăng nhập diễn ra như sau (giống nhau ở mọi app):

Thêm URL MCPvào app chat

Bấm Authenticate / Connecthoặc chạy lệnh login

Chọn Google công tytrình duyệt tự mở

Hệ thống kiểm quyềnsensor_tower.use

Dùng đượcdùng đều thì không phải đăng nhập lại

Codex

Áp dụng cho Codex CLI, app desktop và extension VS Code (dùng chung ~/.codex/config.toml). Mở Terminal, chạy:

codex mcp add iec_sensor_tower --url https://ww-sensor-tower-mcp.haleinteractive.vn/mcp
codex mcp login iec_sensor_tower

Lệnh thứ 2 tự mở trình duyệt → chọn tài khoản Google công ty → thấy báo thành công thì đóng tab.
Kiểm tra: codex mcp list có dòng iec_sensor_tower.
Mở lại Codex → gõ quota Sensor Tower còn bao nhiêu để thử.
Gõ / sẽ thấy các lệnh có sẵn: report-game, tim-doi-thu, phan-tich-creative, so-sanh-game.

Phiên tự gia hạn khi bạn dùng; bỏ không dùng quá 30 ngày thì chạy lại codex mcp login iec_sensor_tower.

Claude Code

claude mcp add --transport http --scope user iec-sensor-tower https://ww-sensor-tower-mcp.haleinteractive.vn/mcp

Mở claude → gõ /mcp → chọn iec-sensor-tower → Authenticate → chọn tài khoản Google công ty.
Quay lại terminal, /mcp hiện connected là xong.
Lệnh có sẵn hiện dạng /mcp__iec-sensor-tower__report-game.

--scope user = dùng ở mọi thư mục. Chỉ muốn dùng trong 1 repo thì đổi thành --scope project (tạo file .mcp.json, commit được vì không chứa khoá).

ChatGPT

Cần gói Business/Enterprise và admin workspace đã bật Developer mode.

ChatGPT → Settings → Apps & Connectors → Advanced settings → bật Developer mode.
Quay lại Apps & Connectors → Create (tạo connector mới).
Điền: Name = Sensor Tower IEC; MCP Server URL = URL MCP ở trên; Authentication = OAuth. Để trống Client ID / Client Secret.
Tick xác nhận tin tưởng app → Create → cửa sổ đăng nhập mở ra → chọn tài khoản Google công ty → Allow.
Khi chat: bấm + (hoặc biểu tượng công cụ) → Developer mode → bật Sensor Tower IEC → hỏi bình thường.

ChatGPT không hiện lệnh /, cứ gõ thường: report game Chaos Drink Sort.

Claude (web, desktop)

Claude → Settings → Connectors → Add custom connector.
Điền: Name = Sensor Tower IEC; URL = URL MCP ở trên → Add.
Bấm Connect cạnh connector vừa tạo → chọn tài khoản Google công ty → Allow.
Khi chat: bấm biểu tượng công cụ dưới ô chat → bật Sensor Tower IEC.

Gói Team/Enterprise: nếu không thấy nút Add custom connector, nhờ owner workspace thêm connector cho cả tổ chức (Admin settings → Connectors) rồi mỗi người tự bấm Connect.

Khi domain chính lỗi

Nếu ww-sensor-tower-mcp.haleinteractive.vn không vào được, dùng URL dự phòng (cùng server, đăng nhập y hệt):

https://ww-sensor-tower-mcp-747410401684.asia-southeast1.run.app/mcp

Codex: codex mcp add iec_sensor_tower_backup --url https://ww-sensor-tower-mcp-747410401684.asia-southeast1.run.app/mcp rồi codex mcp login iec_sensor_tower_backup. App khác: thêm connector mới với URL trên.

Link cá nhân (dự phòng)

Dùng khi app không hiện nút đăng nhập, hoặc đăng nhập OAuth lỗi mãi:

Nhắn adminxin key scope Sensor Tower MCP

Nhận link qua DMdạng …/mcp/u/ww_…

Dán link vào chỗ URLkhông cần đăng nhập

Admin tạo API key scope Sensor Tower MCP cho bạn trên web-admin rồi gửi link dạng https://ww-sensor-tower-mcp-…/mcp/u/ww_….
ChatGPT chọn Authentication = No authentication. Codex: codex mcp add iec_sensor_tower --url <link>, không cần login. Claude Code: claude mcp add --transport http iec-sensor-tower <link>.
Link chứa khoá riêng của bạn: không dán vào kênh chung, không commit vào repo. Lộ link thì báo admin revoke.

Hỏi gì

Gõ	Ra
`report game Chaos Drink Sort`	Report 7 phần + link trang HTML để chia sẻ / in PDF
`tìm đối thủ của Water Sort Puzzle`	Game cùng thể loại theo Game IQ (không tìm theo tên)
`phân tích creative Royal Match với 3 đối thủ`	So sánh creative, gợi ý hướng test
`so sánh downloads Chaos Drink Sort và Water Sort 3 tháng`	Bảng so sánh
`top game puzzle tăng nhanh nhất tháng trước ở US`	Bảng xếp hạng có Game IQ
`quota Sensor Tower còn bao nhiêu`	Quota API tháng này + của bạn hôm nay

Quota

Mỗi câu hỏi đi qua 3 cửa trước khi tốn quota:

Câu hỏi mới

Đã có trong cache?có → trả ngay, 0 request

Bạn còn quota hôm nay?hạn mức request mới / người / ngày

Công ty còn quota tháng?dừng ở điểm admin đặt

Gọi Sensor Towertốn 1 request mỗi lần gọi

Gói Sensor Tower của công ty là 500 request/tháng, dùng chung cho MCP và các job tự động.
Hạn mức request mới mỗi người mỗi ngày (reset lúc 0h giờ VN) và điểm dừng tháng do admin đặt trên web-admin (Tools → MCP Tools → Sensor Tower MCP). Hỏi quota Sensor Tower còn bao nhiêu để xem số đang áp.
Hỏi lại câu đã có thì không tốn.
1 report game mới tốn khoảng 11 request; mở lại report đó thì không tốn.
Cuối mỗi câu trả lời có dòng quota. Chạm trần thì chỉ trả data đã có, có ghi ngày lấy.

Số liệu

Toàn bộ là ước tính của Sensor Tower (downloads, revenue net sau phí store tính bằng USD, DAU, retention), không phải số console. Creative mặc định lấy tất cả network. Mọi câu trả lời đều ghi filter và kỳ đã áp; muốn đối chiếu thì mở trên Sensor Tower với đúng filter đó.

Gặp lỗi

Đọc nguyên văn câu báo lỗi, tìm dòng gần giống trong bảng:

Thấy báo	Nghĩa là	Làm gì
`Tài khoản thiếu quyền sensor_tower.use`	Chưa được cấp quyền	Nhắn Quang BD cấp quyền, rồi đăng nhập lại
`Tài khoản Google không có trong hệ thống`	Chọn nhầm Gmail cá nhân, hoặc chưa có tài khoản web-admin	Đăng nhập lại, chọn mail công ty
`Tài khoản đã bị khoá`	Tài khoản web-admin bị khoá	Nhắn admin
`Đã huỷ đăng nhập Google`	Đóng cửa sổ Google giữa chừng	Bấm Authenticate / Connect lại
`redirect_uri không được phép` / `không khớp`	App gửi địa chỉ quay về lạ	Chụp màn hình gửi Quang BD
`Cần đăng nhập (Authenticate)`	Chưa đăng nhập	Bấm Authenticate / Connect, hoặc `codex mcp login iec_sensor_tower`
`Phiên đăng nhập hết hạn hoặc tài khoản không còn quyền`	Hết phiên, hoặc vừa bị gỡ quyền	Đăng nhập lại; vẫn lỗi thì nhắn admin
Link cá nhân báo 404	Key sai, đã revoke, hoặc thiếu scope Sensor Tower	Xin admin link mới
`Bạn đã dùng N/N request API mới hôm nay`	Hết quota cá nhân trong ngày	Hỏi các câu đã có trong cache, chờ sau 0h, hoặc nhờ admin nâng hạn mức
`Đã chạm trần quota cho UA tháng này`	Cả UA đã dùng hết phần tháng này	Chỉ hỏi được data đã có; cần gấp thì nhắn Quang BD
`Không tìm thấy game "…" trên Sensor Tower`	Tên game sai hoặc chưa có trên Sensor Tower	Gõ tên đầy đủ như trên store, hoặc gửi link store
`Sensor Tower chưa gắn Game IQ cho game này`	Game quá mới / quá nhỏ, chưa có thể loại	Tự nêu thể loại: `tìm game puzzle sort giống …`
`Sensor Tower chưa có retention cho game này`	Game chưa đủ dữ liệu retention	Bỏ qua phần retention, các phần khác vẫn đúng
App không thấy tool / lệnh `/`	Connector chưa bật trong khung chat	Bật connector (ChatGPT: + → Developer mode; Claude: biểu tượng công cụ)
Bị bắt đăng nhập lại liên tục	Phiên lưu trong app bị hỏng	Xoá connector rồi thêm lại; vẫn lỗi thì dùng link cá nhân

Báo lỗi cho Quang BD thì gửi kèm: giờ xảy ra, app đang dùng, câu đã hỏi và nguyên văn lỗi — log phía server tra được theo các thông tin này.