stripe/ai 是什麼、怎麼安裝：Stripe 官方 Agent Skills 與 MCP（讓 Claude Code / Codex 按最新實踐接入支付）

本文根據 stripe/ai 倉庫 README 與 skills.sh 榜單整理，資料核對於 2026-10-11。

是什麼

stripe/ai 是 Stripe 把「AI 與支付」相關工具放在一起的官方倉庫，README 自稱是在 Stripe 之上構建 AI 產品和業務的一站式入口。它包含三類東西：

• Agent Skills：給智能體的說明，幫助它在集成 Stripe 時使用最新的最佳實踐，而不是憑舊記憶寫已經不推薦的接口；
• MCP 伺服器：Stripe 託管的遠程 MCP 服務，地址是 https://mcp.stripe.com，客戶端通過 OAuth 安全接入；
• 計費 SDK：@stripe/ai-sdk（配合 Vercel 的 AI SDK）和 @stripe/token-meter（配合 OpenAI、Anthropic、Google Gemini 的原生 SDK），用來把大模型的 token 用量接到 Stripe 的計費體系裏。

截至 2026-10-11，GitHub 顯示該倉庫約 1865 Star、353 Fork，最近一次推送在 2026-10-10。

包含哪些 Skill

README 沒有逐個列出技能，只說明提供「一組幫助智能體使用最新最佳實踐的技能」。從 skills.sh 當日榜單能看到該倉庫下的三個：stripe-best-practices（集成最佳實踐）、upgrade-stripe（升級 Stripe 版本）、stripe-projects。README 提到，官方插件除技能外還帶有額外的智能體工具，並且會自動更新。

怎麼安裝

README 建議常見工具直接裝官方插件：

bash
claude plugin install stripe@claude-plugins-official

Codex 用 codex plugin add stripe@openai-curated；Cursor 在對話裏輸入 /add-plugin stripe；Grok Build 也有對應方式。

手動安裝（其他智能體）：

bash
npx skills add https://docs.stripe.com

README 提醒手動安裝的技能不會自動更新，需要時運行 npx skills update -y。

怎麼用

• 「給這個 SaaS 項目接入訂閱付費，用 Stripe 當前推薦的方式」；
• 「把我們的 Stripe API 版本升級到最新，列出需要改的地方」；
• 「按 token 用量給用戶計費，接到 Stripe 上」。

適合誰 / 不適合誰

適合： 面向海外用戶、用 Stripe 收款的獨立開發者和 SaaS 團隊；做 AI 產品並想按用量計費的開發者。

不適合： 無法開通 Stripe 帳戶的主體（Stripe 對註冊主體所在地區有要求，以其官網為準）；只做國內收款的項目。

注意事項

• 許可證：MIT。
• 密鑰安全：Stripe 的密鑰等同於資金操作權限。開發時只用測試模式的密鑰，放在環境變量裏；不要把正式環境的密鑰交給智能體或貼進對話。MCP 的 OAuth 授權也要注意授予的範圍。
• 支付邏輯要人審：智能體寫的扣款、退款、Webhook 驗籤代碼上線前必須人工審查並在測試模式下完整走通。
• 費用：技能和 SDK 免費，Stripe 的手續費以其官網為準，本文不列數字。
• 遠程 MCP 伺服器能讀寫你的 Stripe 帳戶數據，接入前確認用途。