Dvina MCP

透過 MCP 在其他 App 中使用 Dvina

將 Claude Code、ChatGPT 或 Cursor 等 MCP 用戶端連接至 Dvina，登入後，讓它在你批准下讀取 Dvina 內容及新增內容。

Dvina 有自己的 MCP 伺服器。連接 Claude Code、ChatGPT 或 Cursor 等 MCP 用戶端後，該 App 就能以你的身分搜尋你的 Dvina、讀取你的文件和記憶，以及新增筆記、任務和提醒。

開始之前

你需要伺服器的地址：

https://api.dvina.ai/mcp

如果你的公司在自己的伺服器上運行 Dvina，請使用公司的 Dvina API 地址，並在末尾加上 /mcp。請向管理員索取地址。

伺服器使用 Streamable HTTP。如果用戶端要求你選擇傳輸方式，請選擇 HTTP。

連接用戶端

Claude Code

  1. 在終端機中執行：

    claude mcp add --transport http dvina https://api.dvina.ai/mcp

  2. 啟動 Claude Code，執行 /mcp，選擇 dvina，然後登入 Dvina。

ChatGPT

  1. 開啟 ChatGPT 中可新增 MCP 伺服器的位置。
  2. 輸入 https://api.dvina.ai/mcp 作為伺服器地址；如果系統詢問登入方式，請選擇 OAuth。
  3. 當 ChatGPT 提示時，登入 Dvina。

Cursor

  1. Open the place where Cursor lets you add an MCP server.
  2. Add a server named dvina with the address https://api.dvina.ai/mcp.
  3. Sign in to Dvina when Cursor asks.

你不需要用戶端 ID 或密鑰。用戶端首次連接時，會自動向 Dvina 註冊。

登入

Dvina 的 MCP 伺服器會透過 OAuth，讓你在瀏覽器中登入：

  1. 按平常的方式登入 Dvina。
  2. 如果你屬於多個工作空間，請在 選擇工作空間 下選擇一個，然後選擇 繼續。用戶端只會在該工作空間中運作。
  3. 在 授權存取 下確認 App 名稱，然後選擇 允許存取。如果你不認得該 App，請選擇 拒絕。

用戶端會保持連接，因此你不需要每次都登入。

用戶端可以做甚麼

用戶端可以看到 Dvina 的工具，並在你的要求需要用到這些工具時使用它們：

範疇 用戶端可以做甚麼
搜尋 同時搜尋你的聊天、文件、記憶和世界。
記憶 列出和讀取你的記憶檔案、新增記憶檔案，或修改現有檔案。
世界 列出你的主題、顯示 Dvina 對某個主題或其他任何事物的了解，以及列出你的動態。
文件 列出、讀取和搜尋你的資料庫、建立筆記和資料夾、上載檔案，以及取代、移動或重新命名文件，或將文件移至垃圾桶。
畫布 列出和讀取你的畫布、建立畫布，或重寫頁面。
任務和目標 列出你的任務並讀取它們已完成的工作、啟動任務或以達成目標為目的的任務、向任務提供更多工作，或停止任務。
排程訊息 列出排程訊息、排程單次或重複的訊息或提醒，或取消排程訊息。
代理和技能 列出和讀取你的代理和技能、建立代理、新增技能，或修改代理或技能。
專案 列出你的專案，並顯示專案的資料夾和最近的任務。
分享 查看誰有權存取項目，以及其他人與你分享了甚麼，或授予或移除某人的存取權限。
設定 顯示你的偏好設定，或開啟或關閉記憶。

用戶端無法永久刪除任何內容、開啟公開連結、連接或中斷連接應用程式，或更改管理員或帳單設定。

核准變更

用戶端的操作遵循 Dvina 各處相同的規則：

  • 讀取內容時，不會先詢問你。
  • 新增內容（例如筆記、記憶檔案或任務）時，不會先詢問你。這類操作絕不會更改現有內容。
  • 更改或移除內容（例如將文件移至垃圾桶、重寫畫布頁面、停止任務或分享項目）前，會先詢問你。用戶端會顯示 Dvina 提供的變更摘要，讓你核准或拒絕。你拒絕後，不會有任何變更。

備註

如果用戶端無法要求你確認，Dvina 就不會執行該用戶端提出的變更。請改在 Dvina 應用程式中進行變更，或使用能要求你確認的用戶端。

你的存取權限和公司的規則

用戶端以你的身分操作，只能存取你在 Dvina 中可見的內容，並執行你有權進行的操作：

  • 只有當你仍是工作區成員時，用戶端才能運作，而且只能執行你的角色允許的操作。
  • 如果管理員關閉某項功能（例如檔案上載），用戶端也無法使用該功能。
  • 用戶端新增或更改的內容，與應用程式中的內容一樣，都受你公司的資料保護規則約束。
  • 用戶端新增或更改的內容會記錄在你的稽核記錄中，標示為助理代你執行的操作，並註明來自哪個用戶端。
  • 用戶端的操作會計入你的用量，並受你平常的用量限制約束。

使用 API 金鑰而非 OAuth 連接

使用 Enterprise 方案時，用戶端可以透過個人存取權杖連接，而毋須登入。你可為無法使用 OAuth 登入的用戶端或指令碼使用這種方式。

  1. 開啟設定，然後選擇 API 存取。
  2. 在個人存取權杖下，選擇建立權杖。
  3. 輸入名稱，選擇存取權限和到期時間，然後選擇建立權杖。
  4. 在複製你的權杖下，複製權杖。權杖只會在此時顯示一次。

選擇用戶端所需的存取權限：

  • **唯讀：**用戶端只會看到用於讀取的工具。它可以搜尋和讀取你在 Dvina 中的內容，但無法新增或更改任何內容。
  • **讀寫：**用戶端會看到所有工具，但與使用 OAuth 時一樣，變更仍須經你核准。

在 Authorization 標頭中，將權杖放在 Bearer 後傳送。例如，在 Claude Code 中：

claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"

如果使用其他用戶端，請在可設定 MCP 伺服器標頭的位置加入相同的標頭。

權杖會在你建立它的工作區中，以你的身分及你目前在該工作區的角色運作。如要更換權杖，請在個人存取權杖下開啟它，然後選擇輪替…：新權杖會取代舊權杖，舊權杖會立即失效。如要停用權杖，請選擇撤銷…：所有使用該權杖的連接或操作都會立即失效。

如要進一步了解權杖，請參閱 API 存取。