Cài MCP Sensor Tower (IEC)

Dùng data Sensor Tower ngay trong khung chat của ChatGPT và Claude (cả Codex, Claude Code cho dev): 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

• 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

1. 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).
2. Được cấp quyền Sensor Tower MCP - Dùng. Chưa có thì nhắn Quang BD.
3. 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):

ChatGPT

Dùng được trên chatgpt.com, app desktop và app điện thoại (cài 1 lần trên web là dùng ở mọi nơi).

1. Mở https://chatgpt.com/plugins (hoặc Settings → Plugins).
2. Bấm nút + → Add custom MCP server.
3. Điền:
   • Name: Sensor Tower IEC
   • Description: Data Sensor Tower của IEC (tuỳ ý)
   • Connection: chọn Public endpoint, dán URL https://ww-sensor-tower-mcp.haleinteractive.vn/mcp
   • Authentication: OAuth. Để trống Client ID / Client Secret nếu được hỏi.
4. Đọc cảnh báo → bấm I understand and want to continue → Create as a plugin.
5. Cửa sổ đăng nhập mở ra → chọn tài khoản Google công ty → quay lại ChatGPT, thấy danh sách tool là xong. Bấm Install nếu được hỏi.
6. Khi chat: mở cuộc trò chuyện mới → gõ @ → chọn Sensor Tower IEC → hỏi, ví dụ @Sensor Tower IEC report game Chaos Drink Sort.

ChatGPT không có lệnh / như Codex — cứ gõ câu hỏi bình thường.

Claude (claude.ai, app desktop)

Dùng được trên claude.ai, Claude Desktop và app điện thoại.

1. Vào Customize → Connectors (bản cũ: Settings → Connectors).
2. Bấm + Add → Add custom connector.
3. Điền Name = Sensor Tower IEC, URL = https://ww-sensor-tower-mcp.haleinteractive.vn/mcp → Continue.
4. Màn hình xác thực:
   • Authentication: Sign in now (hoặc Sign in when needed).
   • OAuth client: chọn Register automatically. Không chọn "Use Claude's published identity" — hệ thống công ty chưa hỗ trợ kiểu này, sẽ báo Ứng dụng kết nối không hợp lệ.
   • Request headers: để trống.
5. Bấm Add → cửa sổ đăng nhập mở ra → chọn tài khoản Google công ty. (Nếu chưa đăng nhập ngay: bấm Connect cạnh connector.)
6. Khi chat: bấm + ở góc dưới bên trái ô chat → Connectors → bật Sensor Tower IEC → hỏi bình thường.

Link cá nhân (khi không đăng nhập được)

Dùng khi app không cho chọn OAuth, workspace chặn, hoặc đăng nhập lỗi mãi:

1. 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_….
2. Dán link đó vào ô URL thay cho URL MCP ở trên; Authentication chọn No authentication / None (Claude: No sign in).
3. 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.

Cho dev: Codex, Claude Code

Codex (CLI, app desktop, extension VS Code dùng chung ~/.codex/config.toml):

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 mở trình duyệt → chọn Google công ty. Kiểm tra bằng codex mcp list. Gõ / để thấy lệnh có sẵn: report-game, tim-doi-thu, phan-tich-creative, so-sanh-game. Bỏ không dùng quá 30 ngày thì chạy lại lệnh login.

Claude Code:

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

Mở claude → /mcp → chọn iec-sensor-tower → Authenticate → chọn Google công ty. Lệnh có sẵn dạng /mcp__iec-sensor-tower__report-game. Chỉ muốn dùng trong 1 repo thì đổi --scope user thành --scope project.

Link cá nhân: codex mcp add iec_sensor_tower --url <link> (không cần login) hoặc claude mcp add --transport http iec-sensor-tower <link>.

Khi domain chính lỗi

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

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

Hỏi gì

Quota

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

• 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:

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.