setting-up-a-data-warehouse-source
Setting up a data warehouse source
Use this skill when the user wants to connect an external data source to PostHog's data warehouse for the first time.
Use AmazonS3 for Amazon S3, GoogleCloudStorage for Google Cloud Storage, AzureBlob for Azure Blob, and
CloudflareR2 for Cloudflare R2. For a local file, direct the user to upload it in the PostHog app. That flow
creates a FileUpload source. No MCP tool uploads files.
Bucket sources use full_refresh by default.
Default to the one-step flow: data-warehouse-source-setup validates credentials, discovers every table, enables
them with sensible sync defaults (incremental where possible), and creates the source in a single call — no
schemas array to assemble. For credentials, hand the user a secure browser link with data-warehouse-source-connect-link
instead of collecting secrets in chat. Only drop to the manual wizard → db-schema → create flow when the user wants to
hand-pick which tables sync or set non-default sync types per table.