跳至主要內容
SPREVA

AI 代理程式

Gemini

Google 的助理，可在 Gemini 應用程式、Gemini CLI 和 Antigravity 中使用。

適用於
Gemini、Gemini CLI和Antigravity
連結方式
登入 API 金鑰 Skill
連接器
SPREVA
方案
Gemini 應用程式：自訂應用程式僅限美國的個人 Google 帳號，且須使用英文介面。Gemini CLI：付費的 Gemini API 金鑰、Vertex AI 或 Gemini Code Assist。其他所有人：Antigravity。

Gemini

在 gemini.google.com 上。新增之後，行動應用程式也能使用 SPREVA。

開始之前

  • 一個位於美國、年滿 18 歲的個人 Google 帳號，已開啟 Keep Activity，且 Gemini 應用程式使用英文介面。公司和學校帳號無法新增自訂應用程式。

設定步驟

  1. 1

    在 gemini.google.com 上開啟 Settings，再開啟 Connected Apps。在 Custom apps 下方選擇 Add a custom app。

  2. 2

    貼上 SPREVA 連接器網址，然後點選 Next：

    網址
    https://app.spreva.ai/api/mcp
  3. 3

    登入 SPREVA、選擇工作空間，然後點選允許。

Gemini CLI

在終端機中使用，適用於擁有付費 Gemini API 金鑰、Vertex AI 或 Gemini Code Assist 的帳號。

開始之前

  • 已安裝 Gemini CLI，並用付費的 Gemini API 金鑰、Vertex AI，或 Gemini Code Assist Standard 或 Enterprise 登入。

設定步驟

  1. 1

    新增 SPREVA：

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

    啟動 Gemini CLI 並執行 /mcp auth spreva。你的瀏覽器會開啟 SPREVA：選擇工作空間，然後點選允許。

其他連結方式

  • 放在標頭中的 API 金鑰

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

    終端機
    export SPREVA_API_KEY=spreva_sk_...
gemini mcp add --transport http --scope user \
  spreva https://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 agents

Antigravity

Google 的程式設計代理程式，適用於免費、Google AI Pro 和 Ultra 方案。以下步驟適用於 Antigravity 編輯器。

開始之前

  • 一個 SPREVA 帳號，且能存取你想連結的工作空間。
  • 一組 API 金鑰，在 SPREVA 的開發人員中，於 API 金鑰建立。

設定步驟

  1. 1

    在 SPREVA 的開發人員中，於 API 金鑰建立一組 API 金鑰，然後複製。

  2. 2

    在 Antigravity 中開啟代理程式面板的選單，依序開啟 MCP Servers、Manage MCP Servers 和 View raw config。

  3. 3

    把 SPREVA 和你的金鑰加到設定中：

    ~/.gemini/config/mcp_config.json
    {
  "mcpServers": {
    "spreva": {
      "serverUrl": "https://app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer spreva_sk_..."
      }
    }
  }
}
  4. 4

    儲存檔案，然後重新啟動 Antigravity 或重新載入它的 MCP 伺服器。

其他連結方式

  • 連接器網址和登入

    把連接器網址貼到應用程式中，登入 SPREVA 並點選「允許」。不需要保管任何金鑰。

    ~/.gemini/config/mcp_config.json
    {
  "mcpServers": {
    "spreva": {
      "serverUrl": "https://app.spreva.ai/api/mcp"
    }
  }
}

確認是否正常運作

開始新的對話，然後問：

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

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

疑難排解

Gemini 應用程式中沒有「Custom apps」區段

自訂應用程式需要位於美國的個人 Google 帳號，已開啟 Keep Activity，且 Gemini 應用程式使用英文介面。否則，請使用 Gemini CLI 或 Antigravity。

Gemini CLI 無法再連上 SPREVA

登入狀態已過期。再執行一次 /mcp auth spreva。

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

官方說明文件