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 存取。