Điều kiện tiên quyết
- Một tài khoản PostHog Cloud (US hoặc EU) có quyền truy cập vào project bạn muốn CloudThinker đọc. PostHog tự host không được hỗ trợ: kết nối chỉ truy cập được cloud US và EU của PostHog.
- Quyền tạo personal API key trong tài khoản đó.
- Một project đang nhận event. Project không có event nào sẽ cho câu trả lời trống, không phải kết nối bị lỗi.
Thiết lập
1
Tạo personal API key trong PostHog
Trong PostHog, mở cài đặt tài khoản (personal API key thuộc về người dùng của bạn, không nằm trong cài đặt project), vào Personal API keys và nhấn + Create a personal API Key. Đặt nhãn là
CloudThinker.2
Chọn preset MCP Server
Chọn preset MCP Server. Preset này giới hạn key trong một project. Trước khi tạo key, hãy xem lại các scope mà preset chọn, và bỏ chọn mọi scope ghi mà bạn không muốn CloudThinker có. Nếu tự chọn scope, chỉ chọn các mục trong Quyền yêu cầu.
3
Sao chép key
Sao chép giá trị key (bắt đầu bằng
phx_). PostHog chỉ hiển thị một lần và ẩn đi sau khi bạn tải lại trang.4
Kết nối trong CloudThinker
Trên thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn PostHog. Dán key vào POSTHOG_PERSONAL_API_KEY, chọn POSTHOG_REGION và nhấn Connect. CloudThinker kiểm tra kết nối bằng cách mở một phiên với MCP server của PostHog cho region đó.Trạng thái thành công: kết nối PostHog hiển thị trạng thái Connected. Chạy prompt xác minh bên dưới để xác nhận key đọc được project của bạn.
Xác minh kết nối
Chi tiết kết nối
Mỗi key chỉ thuộc về một cloud PostHog. Nếu gửi sang region còn lại, key sẽ bị từ chối với lỗi key không hợp lệ. Mỗi kết nối làm việc với một project đang hoạt động; để bao phủ project thứ hai, hãy thêm kết nối PostHog thứ hai với key riêng.
Quyền yêu cầu
Personal API key mang các scope theo từng tài nguyên, chẳng hạninsight:read. CloudThinker không thể truy cập bất cứ thứ gì nằm ngoài các scope.
Khả năng của agent
Ví dụ prompt
Quyền ghi
PostHog cung cấp toàn bộ công cụ thông qua một công cụ lệnh duy nhất, và công cụ đó có thể thực hiện mọi thay đổi mà PostHog cho phép. Vì vậy CloudThinker coi mọi lệnh gọi PostHog là thao tác ghi, kể cả lệnh chỉ đọc. Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi. Chọn Manual để có người phê duyệt mọi lệnh gọi PostHog, dù đọc hay ghi. Vì PostHog chỉ có một công cụ lệnh, không Rule nào có thể phân biệt lệnh đọc với lệnh ghi của PostHog — nên khi CloudThinker bật Rule enforcement cho workspace của bạn, một Rule Allow cho các lệnh gọi PostHog cũng sẽ cho phép cả thay đổi feature flag.Khắc phục sự cố
Mọi lệnh gọi đều thất bại với lỗi key không hợp lệ
Mọi lệnh gọi đều thất bại với lỗi key không hợp lệ
Key đến từ cloud PostHog còn lại, hoặc đã bị thu hồi. Đặt POSTHOG_REGION khớp với host bạn đăng nhập. Nếu đã đúng, hãy tạo key mới và cập nhật kết nối.
CloudThinker báo một khả năng không khả dụng, hoặc project có vẻ trống
CloudThinker báo một khả năng không khả dụng, hoặc project có vẻ trống
Key thiếu scope đó. PostHog ẩn các công cụ mà key không truy cập được, nên trông có thể giống một project không có flag hoặc lỗi nào. Mở key trong PostHog, thêm scope hoặc tạo key mới với preset MCP Server, rồi cập nhật kết nối.
CloudThinker đọc sai project
CloudThinker đọc sai project
Mỗi kết nối chỉ có một project đang hoạt động. Hỏi
Which PostHog project is active? để kiểm tra. Để thay đổi, hãy yêu cầu CloudThinker chuyển project: thao tác chuyển sẽ hiển thị thành lời nhắc phê duyệt. Hoặc thêm kết nối PostHog thứ hai với key cho project kia.Lệnh đọc dừng lại chờ phê duyệt
Lệnh đọc dừng lại chờ phê duyệt
Đây là hành vi mong đợi. CloudThinker coi mọi lệnh gọi PostHog là thao tác ghi, nên lệnh đọc cũng có thể dừng lại. Xem Quyền ghi để biết mỗi chế độ Approval xử lý lệnh gọi PostHog thế nào.
Lệnh gọi thất bại với 429 sau khi dùng nhiều
Lệnh gọi thất bại với 429 sau khi dùng nhiều
PostHog trả về lỗi giới hạn tốc độ 429. Giới hạn tốc độ của PostHog được chia sẻ giữa mọi người dùng và key trong tổ chức của bạn. Chờ giới hạn được đặt lại, rồi hỏi một câu hẹp hơn để CloudThinker đọc ít hơn.
Tôi đã làm mất giá trị key
Tôi đã làm mất giá trị key
PostHog chỉ hiển thị personal API key một lần. Tạo key mới và cập nhật kết nối.
Bảo mật
- Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
- Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
- Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
- Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
- Bảo vệ key như mật khẩu: personal API key có thể hành động như người dùng PostHog của bạn trong phạm vi các scope của key. Dùng preset MCP Server và chỉ dùng key cho CloudThinker, để bạn có thể thu hồi riêng key đó.
- Project token không xuất hiện trong chat: CloudThinker đọc chi tiết project qua một đường đi loại bỏ ingestion token của project, nên token không bao giờ xuất hiện trong cuộc hội thoại.
Liên quan
Kết nối Sentry
Điều tra lỗi và hiệu năng ứng dụng trong Sentry
Approvals
Quyết định những thao tác ghi nào của kết nối được chạy mà không cần hỏi bạn