制限された認証情報でMCPを接続する

dosya MCPではAPIキーを貼り付ける代わりにOAuthを使用します。認可は読み取り可能な1つのワークスペースに固定され、ファイルの読み取り権限が必要です。保存されたコンテンツの変更、共有、削除はできません。

手順

1. MCPクライアントにサーバーURLhttps://mcp.dosya.dev/mcpを追加してください。クライアントが開くブラウザでサインインしてください。dosyaはAPIキーとモバイルトークンをMCP認証情報として受け付けないため、dos_… APIキーを作成したり貼り付けたりしないでください。
2. 同意画面で要求元のアプリと接続先を確認してください。認識済みのコールバックには確認済みが表示されます。ローカルクライアントではコンピューター上のアプリにアクセスが渡るという警告が表示され、それ以外の自己登録アプリでは未確認とリダイレクト先のホストが表示されます。
3. 読み取り可能なワークスペースで、この接続に必要なワークスペースを1つ選択してください。エンドツーエンド暗号化されたスペースは、dosyaがファイルを復号できないため対象外です。現在のリリースではフォルダー単位のMCP認可はありません。
4. 必須の_workspace_のファイルを検索して読み取る権限は選択したままにしてください。クライアントにget_account_infoが必要な場合を除き、任意のプランとストレージの表示の選択を解除してください。選択すると必須のfiles.readスコープにaccount.readが追加されます。
5. 10分の同意期限が切れる前に**アクセスを許可（app）**を選択してください。拒否を選ぶと認可は作成されず、元の画面に戻ります。期限切れのリクエストにはThis request expired. Go back to your AI app and connect again.が表示されます。
6. クライアントに戻り、list_workspacesを実行してください。構造化された結果には同意時に選択したワークスペースだけが表示されます。これにより、接続から他のワークスペースやVaultを列挙できないことを確認できます。

OAuthアクセストークンはMCPクライアントに保持されます。dosyaの同意ページに手動で保存して再利用できるシークレットは表示されません。クライアントが送信した不明なスコープは認可されず、破棄されます。

期待される結果

クライアントがfiles.readでdosya MCPリソースに接続し、選択した暗号化されていないワークスペースを1つ表示します。変更操作はできません。get_account_infoはプランとストレージの表示が認可された場合にのみ動作します。

利用できるワークスペースがない場合 同意ページにYou have no workspace this app can read. End-to-end encrypted Spaces cannot be connected.と表示されます。通常のワークスペースに参加するか作成してから、AIクライアントでやり直してください。

見覚えのないコールバックが表示される場合 拒否を選択してください。見覚えのあるクライアントとリダイレクト先からのみやり直してください。

関連ガイド

• MCPクライアントを接続する
• MCPのトラブルシューティング