Dvinaには専用のMCPサーバーがあります。Claude Code、ChatGPT、CursorなどのMCPクライアントを接続すると、そのアプリがあなたに代わってDvinaを検索し、ドキュメントやメモリを読み取り、ノート、タスク、リマインダーを追加できるようになります。
始める前に
サーバーのアドレスが必要です。
https://api.dvina.ai/mcp
会社が自社のサーバーでDvinaを運用している場合は、会社のDvina APIアドレスの末尾に/mcpを付けて使ってください。アドレスは管理者に確認してください。
サーバーはStreamable HTTPを使用します。クライアントでトランスポートの選択を求められたら、HTTPを選んでください。
クライアントを接続する
Claude Code
ターミナルで次のコマンドを実行します。
claude mcp add --transport http dvina https://api.dvina.ai/mcpClaude Codeを起動し、
/mcpを実行して、dvinaを選び、Dvinaにサインインします。
ChatGPT
- Open the place where ChatGPT lets you add an MCP server.
- Enter
https://api.dvina.ai/mcpas the server's address, and choose OAuth if it asks how to sign in. - Sign in to Dvina when ChatGPT asks.
Cursor
- Open the place where Cursor lets you add an MCP server.
- Add a server named
dvinawith the addresshttps://api.dvina.ai/mcp. - Sign in to Dvina when Cursor asks.
クライアントIDやシークレットは不要です。クライアントは初回接続時にDvinaに自動で登録されます。
サインインする
DvinaのMCPサーバーには、ブラウザでOAuthを使ってサインインします。
- いつもどおりDvinaにサインインします。
- 複数のワークスペースに所属している場合は、ワークスペースを選択で1つ選び、続けるを選びます。クライアントはそのワークスペース内でのみ動作します。
- アクセスを許可でアプリ名を確認し、アクセスを許可するを選びます。見覚えのないアプリの場合は、拒否を選んでください。
クライアントは接続されたままになるため、毎回サインインする必要はありません。
クライアントでできること
クライアントはDvinaのツールを認識し、あなたのリクエストに応じて必要なツールを使います。
| 項目 | クライアントでできること |
|---|---|
| 検索 | チャット、ドキュメント、メモリ、ワールドをまとめて検索できます。 |
| メモリ | メモリファイルの一覧表示、読み取り、新規追加、変更ができます。 |
| ワールド | トピックの一覧表示、トピックやその他の事柄についてDvinaが把握している内容の表示、フィードの一覧表示ができます。 |
| ドキュメント | ライブラリの一覧表示、読み取り、検索、ノートやフォルダの作成、ファイルのアップロード、ドキュメントの置き換え、移動、名前の変更、ゴミ箱への移動ができます。 |
| キャンバス | キャンバスの一覧表示、読み取り、作成、ページの書き換えができます。 |
| タスクと目標 | タスクの一覧表示と実行内容の確認、タスクや目標に向けて作業するタスクの開始、タスクへの追加作業の依頼、タスクの停止ができます。 |
| 予約メッセージ | 予約メッセージの一覧表示、メッセージやリマインダーの単発または繰り返しの予約、予約の取り消しができます。 |
| エージェントとスキル | エージェントとスキルの一覧表示、読み取り、エージェントの作成、スキルの追加、エージェントやスキルの変更ができます。 |
| プロジェクト | プロジェクトの一覧表示と、プロジェクトのフォルダや最近のタスクの表示ができます。 |
| 共有 | アイテムにアクセスできるユーザーや、他のユーザーがあなたと共有したものの確認、アクセス権の付与や削除ができます。 |
| 設定 | 環境設定の表示や、メモリのオン／オフの切り替えができます。 |
クライアントでは、完全な削除、公開リンクを開く操作、アプリの接続や接続解除、管理者設定や請求設定の変更はできません。
変更を承認する
クライアントの操作には、Dvinaの他の場所と同じルールが適用されます。
- 読み取りは、確認なしで実行されます。
- ノート、メモリファイル、タスクなどの新規追加は、確認なしで実行されます。既存の内容が変更されることはありません。
- ドキュメントをゴミ箱に移動する、キャンバスのページを書き換える、タスクを停止する、アイテムを共有するなど、変更や削除を伴う操作では、最初に確認が求められます。クライアントにDvinaが作成した変更内容の概要が表示され、承認するか拒否するかを選べます。拒否した場合、何も変更されません。
補足
クライアントが確認を求める機能に対応していない場合、Dvinaはそのクライアントからの変更を実行しません。代わりにDvinaアプリで変更するか、確認を求める機能に対応したクライアントを使ってください。
あなたのアクセス権と会社のルール
クライアントはあなたとして動作し、Dvinaであなたが閲覧・操作できる範囲で機能します。
- ワークスペースのメンバーである間のみ、あなたのロールで許可された範囲で動作します。
- 管理者がファイルのアップロードなどの機能をオフにすると、クライアントでもその機能を使えなくなります。
- クライアントによる追加や変更には、アプリと同じように、会社のデータ保護ルールが適用されます。
- 追加や変更は、あなたのためにアシスタントが行った操作として、操作元のクライアントとともに監査ログに記録されます。
- クライアントの操作はあなたの使用量にカウントされ、通常と同じ上限が適用されます。
OAuthの代わりにAPIキーで接続する
Enterpriseプランでは、サインインする代わりに、個人アクセストークンでクライアントを接続できます。OAuthでサインインできないクライアントや、スクリプトで使ってください。
- 設定を開き、APIアクセスを選びます。
- 個人アクセストークンで、トークンを作成を選びます。
- 名前を入力し、アクセス権と有効期限を選んでから、トークンを作成を選びます。
- トークンをコピーで、トークンをコピーします。トークンが表示されるのはこのときだけです。
クライアントに必要なアクセス権を選んでください。
- **読み取り専用：**クライアントには、読み取り用のツールだけが表示されます。Dvina内のデータを検索・読み取りできますが、追加や変更はできません。
- **読み取りと書き込み：**クライアントにはすべてのツールが表示されます。OAuthの場合と同じように、変更には引き続きあなたの承認が必要です。
Authorizationヘッダーで、Bearerの後にトークンを指定して送信します。たとえば、Claude Codeでは次のように指定します。
claude mcp add --transport http dvina https://api.dvina.ai/mcp --header "Authorization: Bearer <your token>"
他のクライアントでは、MCPサーバーのヘッダーを設定できる場所に同じヘッダーを追加してください。
トークンは、作成したワークスペース内で、そこでのあなたの現在のロールに基づき、あなたとして動作します。トークンを置き換えるには、個人アクセストークンで対象のトークンを開き、**ローテーション…**を選びます。新しいトークンに置き換わり、古いトークンはすぐに使えなくなります。トークンを無効にするには、**取り消し…**を選びます。そのトークンを使っているものは、すべてすぐに動作しなくなります。
トークンについて詳しくは、APIアクセスをご覧ください。