Stripe Tax MCP Server

🚀 Stripe 稅務指南

Stripe 稅務模塊（Tax Module）為商家提供了在交易中自動計算和處理稅費的功能，極大地簡化了稅務流程，同時確保商家的稅務操作符合相關法規要求。

🚀 快速開始

📦 安裝指南

安裝 Stripe CLI

curl -L --proto '=https' --tlsv1.2 -o /usr/local/bin/stripe https://github.com/stripe/stripe-cli/releases/download/vlatest/stripe-linux-amd64.gz
chmod +x /usr/local/bin/stripe

配置

stripe tax settings --api-key=your_api_key

💻 使用示例

基礎用法

創建稅務計算

stripe tax calculation create \\
  --amount=100 \\
  --currency=usd \\
  --taxable-amount-type=gross \\
  --country-code=US \\
  --region-code=CA \\
  --shipping-address=addr1=line1&city=San%20Francisco&state=CA&postal_code=94103

更新產品稅碼

stripe tax product update \
  --product-id=prod_XYZ \
  --tax-code=TAXRATE_SALES

📚 詳細文檔

文檔

• Stripe 稅務文檔
• Stripe 開票文檔

工具

• Stripe CLI：用於與 Stripe API 交互的命令行工具。
• Stripe Dashboard：管理稅務設置和監控稅務數據的 web 控制檯。

🔧 技術細節

常見問題排查

身份驗證問題

錯誤：出現 "身份驗證失敗" 錯誤。 解決方法：

• 確保 API 密鑰有效且格式正確。
• 檢查密鑰是否具有必要的權限。
• 對於受限密鑰，確保其對稅務端點有訪問權限。

速率限制

錯誤：API 請求被拒絕，提示達到速率限制。 解決方法：

• 實現指數退避重試邏輯。
• 減少 API 調用頻率。
• 考慮升級 Stripe 帳戶以提高限額。

數據驗證錯誤

錯誤：服務器拒絕稅務設置更新。 解決方法：

• 確保所有必填字段格式正確。
• 檢查國家代碼是否為有效 ISO 代碼（如 "US"、"CA"、"GB"）。
• 驗證稅號類型與預期格式匹配。

API 密鑰問題

錯誤：出現 "未提供 API 密鑰" 錯誤信息。 解決方法：

• 確保已創建 .env 文件並設置 STRIPE_API_KEY。
• 或者在調用方法時直接提供 API 密鑰。
• 驗證密鑰是否具有處理 Stripe 稅務操作的權限。

連接問題

錯誤：無法連接到 MCP 服務器。 解決方法：

• 檢查服務器是否運行（查看控制檯輸出）。
• 確保客戶端正確實現 MCP 協議。
• 使用 MCP 檢查工具進行調試。
• 確認 claude_desktop_config.json 中的路徑是否正確。

安全注意事項

⚠️ 重要提示

絕不要在代碼中硬編碼 Stripe API 密鑰。

💡 使用建議

• 使用 .env 文件通過環境變量存儲密鑰。
• 在生產環境中，使用受限 API 密鑰，僅授予所需的權限。
• 考慮實施 API 密鑰輪換以增強安全性。
• 將 .env 添加到 .gitignore 文件中，防止意外提交密鑰。