Connections

連接你的 app 所需服務

為誠實預覽而設的環境變數預設 — Supabase、Stripe 金鑰、地圖等。開啟專案 → 工具列 Connections。精選真正可上線的服務;不是百個 OAuth 的噱頭。

預覽 vs 已部署

瀏覽器金鑰(如 Supabase anon key)可在 WebContainer 即時預覽中運作。僅伺服器端密鑰(Resend、Stripe secret)在發佈後需要後端 — 每個預設都會說明。

儲存 vs 儲存並連接

儲存會將金鑰寫入專案環境變數。儲存並連接亦會預填對話,讓 agent 將 UI 連接到這些憑證。

在哪裡開啟

行銷目錄在此。產品內:開啟專案 → 工具列 Connections。GitHub 推送在 Git 面板(與環境變數金鑰分開)。

目前運作方式

每個專案貼上 API 金鑰。瀏覽器安全金鑰可在即時預覽運作;伺服器密鑰在發佈後需要後端 — 每個預設會標明。

目錄

精選預設集。MCP / agent 技能分開 — 那些為建立器而設,不是你的 app 執行時金鑰。

後端

  • Supabase

    oauth

    認證、資料庫與儲存。

    預覽: Anon key 可在預覽中用於 Auth + 帶 RLS 的客戶端查詢。

    部署: 勿將 service_role 放在 VITE_。特權寫入請用 Edge Functions。

  • Upstash

    伺服器

    Redis 與限速(伺服器端)。

    預覽: REST URL + token 僅伺服器端 — 預覽可 stub。

    部署: 在 Edge Functions 或 API routes 使用 Upstash 憑證。

付款

  • Stripe

    瀏覽器

    付款 — 瀏覽器僅用 publishable key。

    預覽: Publishable key 可在預覽中驅動 Checkout UI stub。

    部署: Secret key 與 webhooks 在部署後需要伺服器或 Edge Function。

電郵

  • Resend

    伺服器

    從後端發送交易電郵。

    預覽: API key 僅伺服器端 — 預覽可 stub UI。

    部署: 用 Edge Functions 或伺服器以 API key 發送。

App 內 AI

  • OpenAI

    伺服器

    從 app 呼叫 LLM(建議伺服器端)。

    預覽: 瀏覽器預覽可 stub 回應;真實呼叫需要 proxy。

    部署: 切勿在 VITE_ 暴露 API key。使用伺服器路由。

分析

  • PostHog

    瀏覽器

    產品分析與功能旗標。

    預覽: Project API key 可在瀏覽器發送事件。

    部署: 預覽與正式環境請用不同 project。

  • Sentry

    瀏覽器

    App 錯誤監控。

    預覽: DSN 可用於瀏覽器客戶端錯誤。

    部署: 設定 environment 標籤以區分預覽與正式。

地圖

  • Google Maps

    瀏覽器

    瀏覽器內地圖與地點。

    預覽: 瀏覽器 API key 可在 WebContainer 預覽運作。

    部署: 在 Google Cloud Console 以 HTTP referrer 限制金鑰。

  • Mapbox

    瀏覽器

    向量地圖與地理編碼。

    預覽: Public token 可用於預覽地圖瓦片。

    部署: 正式環境請為 token 設定 URL 限制。

媒體

  • Cloudinary

    瀏覽器

    圖片上傳與轉換。

    預覽: Unsigned upload preset 可在預覽運作。

    部署: 正式環境請用 signed upload 或伺服器端。