# 透過 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)