跳至主要內容
SPREVA

AI 代理程式

Claude Code

Anthropic 的程式設計代理程式，可在終端機、你的編輯器和 Claude 桌面應用程式中使用。

連結方式
登入 API 金鑰 CLI Skill
連接器
SPREVA
方案
任何包含 Claude Code 的 Claude 方案，或一組 Anthropic API 金鑰。

開始之前

  • 已安裝並登入 Claude Code。

設定步驟

  1. 1

    把 SPREVA 新增為遠端伺服器。--scope user 讓它在每個專案中都能使用：

    終端機
    claude mcp add --transport http --scope user \
  spreva https://dev-app.spreva.ai/api/mcp
  2. 2

    啟動 Claude Code，執行 /mcp，選擇 spreva 並登入。你的瀏覽器會開啟 SPREVA。

  3. 3

    登入、選擇工作空間，然後點選允許。回到 Claude Code 後，spreva 會顯示為已連結。

其他連結方式

  • 放在標頭中的 API 金鑰

    以 Bearer 權杖傳送 SPREVA API 金鑰，適合不需要有人在場的自動化流程。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
claude mcp add --transport http --scope user \
  spreva https://dev-app.spreva.ai/api/mcp \
  --header "Authorization: Bearer $SPREVA_API_KEY"
  • CLI 和 Agent Skill

    安裝 spreva 命令列工具和它的 Agent Skill，適合在終端機中工作的代理程式。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
npx -y @spreva/cli skill install --target claude
  • CLI 的 stdio 橋接

    把 spreva mcp 當成本機 MCP 伺服器執行，適合只會在你的電腦上啟動伺服器的應用程式。

    終端機
    export SPREVA_API_KEY=spreva_sk_...
claude mcp add --transport stdio --scope user \
  --env SPREVA_API_KEY=$SPREVA_API_KEY \
  spreva -- npx -y @spreva/cli mcp

確認是否正常運作

開始新的對話，然後問：

詢問你的代理程式
這週 SPREVA 上有哪些內容要發布？

Claude Code 會呼叫 SPREVA 的 overview 工具，並回覆工作空間的時區、接下來要發布的內容，以及需要處理的事項。第一次使用時，Claude Code 可能會請你允許這個工具。

注意事項

  • 如果在標頭中使用 API 金鑰，金鑰遭拒時會直接回報失敗：Claude Code 不會改用登入方式。
  • 如果用 Claude 訂閱登入，你在 claude.ai 新增的連接器會自動出現在 Claude Code 中。

疑難排解

在另一個專案中找不到 SPREVA

新增時沒有加上 --scope user，所以只有一個專案有它。用 claude mcp remove spreva 移除，再加上這個範圍重新新增。

/mcp 顯示 spreva 失敗

用 claude mcp get spreva 檢查網址。如果網址正確，從 /mcp 重新登入：登入狀態可能已過期。

遇到其他問題？疑難排解涵蓋了反覆要求登入、方案、上限和時區等狀況。

官方說明文件