連結方式

• 你的應用程式能新增連接器或遠端 MCP 伺服器：使用網址並登入。大多數應用程式都可以。
• 沒有人在場點選「允許」，例如指令碼、伺服器或排程工作：使用 API 金鑰。
• 你的應用程式只會在你的電腦上啟動 MCP 伺服器：執行 CLI 的 stdio 橋接。
• 你的代理程式在終端機中工作並使用 Skill：安裝 CLI 和 Agent Skill。

你的應用程式透過 MCP 的 Streamable HTTP 與 SPREVA 溝通，並用 OAuth 讓你登入。不需要複製或保管任何金鑰：你在 SPREVA 自己的頁面上選擇工作空間，而且隨時可以中斷應用程式的連結。

https://dev-app.spreva.ai/api/mcp

1. 1

   把網址貼到應用程式新增連接器或 MCP 伺服器的地方。

2. 2

   你的應用程式會開啟 SPREVA。登入、選擇工作空間，然後點選允許。

3. 3

   代理程式可以自行執行哪些動作，由你在 SPREVA 的代理程式串接中決定，你也可以在那裡中斷每個應用程式的連結。

適合不需要有人在場的自動化流程，以及無法用 OAuth 登入的應用程式。在 SPREVA 的開發人員中，於 API 金鑰建立一組金鑰，並以 Bearer 權杖傳送：

Authorization: Bearer spreva_sk_...

大多數應用程式都在 JSON 設定中填入金鑰。一組金鑰兩個連接器都能使用。

{
  "mcpServers": {
    "spreva": {
      "type": "http",
      "url": "https://dev-app.spreva.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer spreva_sk_..."
      }
    }
  }
}

有些應用程式只會透過 stdio 在你自己的電腦上啟動 MCP 伺服器。spreva mcp 就是這樣的伺服器：它在本機執行，從 SPREVA_API_KEY 讀取你的 API 金鑰，並把每個呼叫轉送給 SPREVA。

{
  "mcpServers": {
    "spreva": {
      "command": "npx",
      "args": [
        "-y",
        "@spreva/cli",
        "mcp"
      ],
      "env": {
        "SPREVA_API_KEY": "spreva_sk_...",
        "SPREVA_URL": "https://dev-app.spreva.ai"
      }
    }
  }
}

它需要 Node.js 20 或更新版本。工具、回覆和權限都和透過網址連結時相同。

在終端機中工作的代理程式，例如 OpenClaw、Hermes Agent、Claude Code 和 Codex，可以把 SPREVA 當成命令列工具使用。Agent Skill 會告訴它們何時以及如何使用。

1. 1

   安裝 CLI：

   npm i -g @spreva/cli

2. 2

   提供你的 API 金鑰：

   export SPREVA_API_KEY=spreva_sk_...
   export SPREVA_URL=https://dev-app.spreva.ai

3. 3

   為你的代理程式安裝 Skill。可用的目標有 claude、codex、openclaw、hermes 和 agents（適用於任何其他支援 Skill 的代理程式）：

   spreva skill install --target claude

4. 4

   確認一切都已就緒：

   spreva doctor

詳情請參閱 CLI 和 Agent Skill。