# 透過 MCP 在其他 App 中使用 Dvina

> 將 Claude Code、ChatGPT 或 Cursor 等 MCP 用戶端連接到 Dvina，登入後，便可在你核准的情況下讀取你的 Dvina 內容並新增內容。

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

## 開始之前

你需要伺服器位址：

```text
https://api.dvina.ai/mcp
```

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

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

## 連接用戶端

::: tabs

=== Claude Code

1. 在終端機中執行：

    ```sh
    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 提供的變更摘要，讓你核准或拒絕。若你拒絕，就不會進行任何變更。

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

## 你的存取權與公司規則

用戶端以你的身分運作，只能查看你在 Dvina 中能看到的內容，並執行你能做的操作：

- 只有在你仍是工作區成員時才能運作，而且只能執行你的角色允許的操作。
- 如果管理員關閉某項功能（例如檔案上傳），用戶端也無法使用該功能。
- 用戶端新增或變更的內容會經過公司的資料保護規則檢查，與應用程式中的操作相同。
- 用戶端新增或變更的內容會記錄在你的[稽核記錄](/docs/teams/audit-log)中，標示為助理代表你進行的操作，並註明操作來自哪個用戶端。
- 用戶端的操作會計入你的用量，並受你平常的用量限制約束。

## 使用 API 金鑰取代 OAuth 連線

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

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

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

- **唯讀：**用戶端只能看到用於讀取的工具。它可以搜尋和讀取你在 Dvina 中的內容，但無法新增或變更任何內容。
- **讀取與寫入：**用戶端可以看到所有工具，但變更仍需經過你的核准，與使用 OAuth 時相同。

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

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

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

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

如需進一步了解權杖，請參閱 [API 存取](/docs/dvina-mcp/api-access)。

## 相關內容

- [自訂應用程式與 MCP 伺服器](/docs/connectors/custom-apps)
- [API 存取](/docs/dvina-mcp/api-access)
- [使用 dvina 指令](/docs/dvina-mcp/cli)
- [團隊概覽](/docs/teams/overview)