開始使用

連結方式

四種連結方式，從貼上網址到執行命令列都有。四種方式都能使用相同的工具，權限也相同。

該用哪一種

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

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

網址

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

1
把網址貼到應用程式新增連接器或 MCP 伺服器的地方。
2
你的應用程式會開啟 SPREVA。登入、選擇工作空間，然後點選允許。
3
代理程式可以自行執行哪些動作，由你在 SPREVA 的代理程式串接中決定，你也可以在那裡中斷每個應用程式的連結。

建議使用。適用於 Claude、ChatGPT、Cursor、Claude Code、Codex、Gemini CLI、Kimi CLI，以及大多數能用網址新增 MCP 伺服器的應用程式。

2. 放在標頭中的 API 金鑰

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

標頭

Authorization: Bearer spreva_sk_...

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

JSON

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

一組金鑰屬於一個工作空間，任何持有它的人都能在那裡執行動作。不要把它放在共用檔案和儲存庫中，不再需要時就撤銷。

3. CLI 的 stdio 橋接

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

JSON

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

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

4. CLI 和 Agent Skill

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

1
安裝 CLI：
終端機
```
npm i -g @spreva/cli
```
2
提供你的 API 金鑰：
終端機
```
export SPREVA_API_KEY=spreva_sk_...
```
3
為你的代理程式安裝 Skill。可用的目標有 claude、codex、openclaw、hermes 和 agents（適用於任何其他支援 Skill 的代理程式）：
終端機
```
spreva skill install --target claude
```
4
確認一切都已就緒：
終端機
```
spreva doctor
```

詳情請參閱 CLI 和 Agent Skill。

該用哪一種

1. 連接器網址和登入

2. 放在標頭中的 API 金鑰

3. CLI 的 stdio 橋接

4. CLI 和 Agent Skill