AIアプリをdosyaに接続する
AIクライアントを読み取り可能なワークスペース1つに接続し、確認済みの接続先と権限を調べてから、非公開ファイルを使用する前に保存された許可を確認します。
最終確認日
スクリーンショットは英語版の画面です。
AIクライアントはhttps://mcp.dosya.dev/mcpのOAuthを使ってdosyaに接続します。承認により1つのワークスペースへの読み取りアクセスが付与されます。アプリにパスワードやAPIキーは渡されません。
接続する前に
- 使用するクライアントから開始し、dosya MCPサーバーURLを入力してください。ブラウザでURLを開くだけでは接続リクエストになりません。
- 対象ワークスペースに所属するdosyaアカウントにサインインしてください。同意の取引は10分有効です。期限切れの場合はAIクライアントからやり直してください。
- 発行されるアクセストークンの有効期間は1時間です。リフレッシュによって接続を維持できるのは30日に少なくとも1回使用する間だけで、すべての許可には絶対的な180日の再接続上限があります。
- 最初の読み取りには無害なファイルを使用してください。外部アプリが内容を読んだ後は、接続を解除してもそのアプリが保持するコピーを削除できません。
- メンバーである通常のワークスペースを選べます。サーバーがファイルを読み取れないエンドツーエンド暗号化スペースは除外されます。承認に有料プランの要件はなく、ワークスペースのメンバーシップも回避できません。
- 製品カタログではFreeプランの各接続にUTC日ごとにテキストファイルの読み取り100回と画像変換25回が付与されます。現在の有料プランの既定値ではこの2つは無制限で、プラン変更は次の呼び出しで反映されます。
手順
- Claude、ChatGPT、その他のMCPクライアントでサーバーとして
https://mcp.dosya.dev/mcpを追加し、接続手順を開始してください。 - 求められたらdosyaにサインインしてください。ページにそのリンクは無効ですと表示された場合はクライアントに戻ってやり直してください。URLを再利用したり編集したりしないでください。
- IDのバッジを確認してください。ClaudeとChatGPTは認可コードが認識されたClaudeまたはChatGPTのホスト名に返る場合にのみ確認済みと表示されます。別のリモートクライアントには未確認 · _host_に送信、ループバックのコールバックには**パソコン上のアプリにアクセス権を付与します。そのアプリから連携を開始した場合のみ続行してください。**という警告が表示されます。
- 読み取り可能なワークスペースで目的のワークスペースを選択してください。対象が1つならdosyaが自動選択し、複数ある場合は選ぶまで許可が無効です。対象がない場合は**このアプリが読み取れるワークスペースがありません。エンドツーエンド暗号化されたスペースは連携できません。**と表示されます。
- 権限の一覧を確認してください。_workspace_のファイルを検索して読み取るは必須で選択を解除できません。クライアントが
account.readを要求した場合は任意のプランとストレージの表示が選択済みで表示され、解除できます。 - 画面に表示された除外事項を確認してください。この許可では変更、共有、削除はできず、他のワークスペースやVaultも開けません。
- アクセスを許可（app name）を選択してください。許可を作らず中止するには代わりに拒否を選択してください。その後dosyaは画面に表示されたコールバックホストに認可結果を返します。
期待される結果
認可後にクライアントが再開し、選択したワークスペース内のファイルだけを探して読み取れます。アカウントメニューを開いてプロフィール、続いて連携済みのAIアプリを選択してください。行にはクライアント名、ワークスペース、接続時刻、ファイルの読み取りや許可した場合のプランとストレージなどの権限が表示されます。
機密でない項目の読み取りを1回試してください。他のワークスペース、E2EEスペース、Vaultのファイルは利用できず、コネクターに書き込み、共有、削除の権限もありません。
接続に失敗した場合
- **このリクエストの有効期限が切れています。AIアプリに戻り、もう一度連携してください。**は10分間の同意ハンドルが使えなくなったことを示します。
- **アプリを連携できませんでした。もう一度お試しください。**は予期しないクライアントまたはネットワークの失敗を示します。再試行で同じリクエストに戻れない場合はクライアントからやり直してください。
- サーバーから予期しない移動先が返されましたは返されたホストが承認前に表示されたホストと異なったことを示します。中止して新しい接続を開始し、別のアドレスに手動で進まないでください。
- 手順中の
401ではdosyaのサインインに進みます。承認は同意リクエストを開いたユーザーと同じサインイン済みユーザーに属する必要があります。 - 行を確認できない場合、**連携済みアプリを読み込めませんでした。もう一度お試しください。**は一覧の取得失敗を示し、許可が存在しない証拠ではありません。
関連ガイド
この記事は役に立ちましたか？
評価の結果を読み込んでいます…
投票すると、回答を変更できるように、必要な投票用Cookieが最長180日間保存されます。
質問と回答
このガイドの手順について質問できます。質問は確認後に公開されます。
公開の質問には、アカウントの詳細、認証情報、非公開ファイルを含めないでください。これらについては 非公開サポート をご利用ください。
質問を読み込んでいます…
dosyaアカウントにサインインすると、質問を投稿できます。