跳至主要內容

AI 代理程式

Cursor

AI 程式碼編輯器,它的代理程式可以使用 MCP 工具。

連結方式
登入 API 金鑰 Skill
連接器
SPREVA

開始之前

  • 一個 SPREVA 帳號,且能存取你想連結的工作空間。
  • 能用網址新增連接器或 MCP 伺服器的 Cursor 版本。

設定步驟

  1. 1

    開啟 ~/.cursor/mcp.json 可在每個專案中使用 SPREVA,開啟專案內的 .cursor/mcp.json 則只用於該專案。

  2. 2

    在檔案中新增 SPREVA:

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "spreva": {
          "url": "https://app.spreva.ai/api/mcp"
        }
      }
    }
  3. 3

    在 Cursor 中開啟 Customize,再開啟 MCPs,然後依照 spreva 旁邊的登入提示操作。SPREVA 會開啟:登入、選擇工作空間,然後點選允許。

  4. 4

    請 Agent 在 SPREVA 中幫你做點事。

其他連結方式

  • 放在標頭中的 API 金鑰

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

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "spreva": {
          "url": "https://app.spreva.ai/api/mcp",
          "headers": {
            "Authorization": "Bearer ${env:SPREVA_API_KEY}"
          }
        }
      }
    }
  • CLI 和 Agent Skill

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

    終端機
    export SPREVA_API_KEY=spreva_sk_...
    npx -y @spreva/cli skill install --target agents

確認是否正常運作

開始新的對話,然後問:

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

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

疑難排解

對話沒有使用 SPREVA

Cursor 的 Agent 會在 MCP 工具符合要求時使用它們。確認對話面板上方的工具清單中已開啟 SPREVA 的工具,或在要求中直接提到 SPREVA。

SPREVA 只能在一個專案中使用

它位於該專案的 .cursor/mcp.json 中。把它移到 ~/.cursor/mcp.json,就能在所有地方使用。

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