# MCPでほかのアプリからDvinaを使う

> Claude Code、ChatGPT、CursorなどのMCPクライアントをDvinaに接続してサインインすると、あなたの承認のもとで、クライアントがDvinaの内容を読み取ったり、追加したりできるようになります。

Dvinaには専用のMCPサーバーがあります。Claude Code、ChatGPT、CursorなどのMCPクライアントを接続すると、そのアプリがあなたに代わって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. Open the place where ChatGPT lets you add an MCP server.
2. Enter `https://api.dvina.ai/mcp` as the server's address, and choose OAuth if it asks how to sign in.
3. Sign in to Dvina when ChatGPT asks.

=== 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. 複数のワークスペースに所属している場合は、**ワークスペースを選択**で1つ選び、**続ける**を選びます。クライアントはそのワークスペース内でのみ動作します。
3. **アクセスを許可**でアプリ名を確認し、**アクセスを許可する**を選びます。見覚えのないアプリの場合は、**拒否**を選んでください。

クライアントは接続されたままになるため、毎回サインインする必要はありません。

## クライアントでできること

クライアントはDvinaのツールを認識し、あなたのリクエストに応じて必要なツールを使います。

| 項目                   | クライアントでできること                                                                                                                       |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| **検索**             | チャット、ドキュメント、メモリ、ワールドをまとめて検索できます。                                                                                      |
| **メモリ**             | メモリファイルの一覧表示、読み取り、新規追加、変更ができます。                                                                               |
| **ワールド**              | トピックの一覧表示、トピックやその他の事柄についてDvinaが把握している内容の表示、フィードの一覧表示ができます。                                                  |
| **ドキュメント**          | ライブラリの一覧表示、読み取り、検索、ノートやフォルダの作成、ファイルのアップロード、ドキュメントの置き換え、移動、名前の変更、ゴミ箱への移動ができます。 |
| **キャンバス**             | キャンバスの一覧表示、読み取り、作成、ページの書き換えができます。                                                                             |
| **タスクと目標**    | タスクの一覧表示と実行内容の確認、タスクや目標に向けて作業するタスクの開始、タスクへの追加作業の依頼、タスクの停止ができます。                |
| **予約メッセージ** | 予約メッセージの一覧表示、メッセージやリマインダーの単発または繰り返しの予約、予約の取り消しができます。                                                                 |
| **エージェントとスキル**  | エージェントとスキルの一覧表示、読み取り、エージェントの作成、スキルの追加、エージェントやスキルの変更ができます。                                                        |
| **プロジェクト**           | プロジェクトの一覧表示と、プロジェクトのフォルダや最近のタスクの表示ができます。                                                                             |
| **共有**            | アイテムにアクセスできるユーザーや、他のユーザーがあなたと共有したものの確認、アクセス権の付与や削除ができます。                                           |
| **設定**           | 環境設定の表示や、メモリのオン／オフの切り替えができます。                                                                                             |

クライアントでは、完全な削除、公開リンクを開く操作、アプリの接続や接続解除、管理者設定や請求設定の変更はできません。

## 変更を承認する

クライアントの操作には、Dvinaの他の場所と同じルールが適用されます。

- 読み取りは、確認なしで実行されます。
- ノート、メモリファイル、タスクなどの新規追加は、確認なしで実行されます。既存の内容が変更されることはありません。
- ドキュメントをゴミ箱に移動する、キャンバスのページを書き換える、タスクを停止する、アイテムを共有するなど、変更や削除を伴う操作では、最初に確認が求められます。クライアントにDvinaが作成した変更内容の概要が表示され、承認するか拒否するかを選べます。拒否した場合、何も変更されません。

> [!NOTE]
> クライアントが確認を求める機能に対応していない場合、Dvinaはそのクライアントからの変更を実行しません。代わりにDvinaアプリで変更するか、確認を求める機能に対応したクライアントを使ってください。

## あなたのアクセス権と会社のルール

クライアントはあなたとして動作し、Dvinaであなたが閲覧・操作できる範囲で機能します。

- ワークスペースのメンバーである間のみ、あなたのロールで許可された範囲で動作します。
- 管理者がファイルのアップロードなどの機能をオフにすると、クライアントでもその機能を使えなくなります。
- クライアントによる追加や変更には、アプリと同じように、会社のデータ保護ルールが適用されます。
- 追加や変更は、あなたのためにアシスタントが行った操作として、操作元のクライアントとともに[監査ログ](/docs/teams/audit-log)に記録されます。
- クライアントの操作はあなたの使用量にカウントされ、通常と同じ上限が適用されます。

## OAuthの代わりにAPIキーで接続する

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)