MCPクライアントをdosyaに接続する

AIアプリのリモート**Model Context Protocol (MCP)**クライアントを次のURLに接続してください：https://mcp.dosya.dev/mcp. dosyaはAPIキーではなく、OAuth認可を使ったStreamable HTTPを使用します。現在のコネクターは読み取り専用です。許可されたファイルの検索と読み取り、ダウンロードリンクの提供はできますが、ファイルのアップロード、変更、共有、削除はできません。

クライアントの対応状況とアクセスを確認する

クライアントにはリモートHTTPSのStreamable HTTP、OAuthディスカバリー、認可コード/PKCEへの対応、動的クライアント登録が必要です。ローカルコマンド/stdioサーバーのみ、または固定APIキーヘッダーのみを提供するクライアントでは接続を完了できません。リモートコネクターの利用可否はクライアントのプランや管理者が制御する場合があります。アプリの最新の公式手順を確認してください。dosyaの同意画面はClaudeとChatGPTのコールバックドメインを認識しますが、すべてのクライアントバージョンを保証したり、自己申告の名前を持つクライアントを信頼済みにしたりするものではありません。

公開対象にするワークスペースのメンバーであるdosyaアカウントを使用してください。エンドツーエンドで暗号化されたSpacesとVaultは接続されません。認可は選択したワークスペース1つに固定されます。ファイルへのアクセスはツール呼び出しのたびに、メンバー資格、フォルダーの制限、非表示やロックされたコンテンツ、ロールに従います。AI接続によって、アカウントが読めないファイルが見えるようにはなりません。

手順：リモートサーバーを認可する

1. クライアントのリモートサーバー/コネクター設定で、接続にわかりやすい名前を付け、完全なURL https://mcp.dosya.dev/mcpを入力してください。通信方式を選べる場合はHTTP/Streamable HTTPを選択します。シェルコマンドを設定したり、/mcpを/sseに置き換えたりしないでください。
2. クライアントで接続または認可の操作を開始してください。MCPホストの保護対象とhttps://api.dosya.devの認可サーバーが検出されます。動的登録、トークン交換、更新はクライアントが処理します。Bearerヘッダーのフィールドにdos_… APIキー、モバイルトークン、アカウントのパスワードを貼り付けないでください。
3. ブラウザのdosya同意画面で、アカウントとコールバック先を確認してください。認識されたホスト型クライアントには確認済み：…、ローカルまたは不明なコールバックには未確認 · …に送信が表示されます。ローカルループバックのクライアントが自動的に検証済みになるわけではありません。自分でそのアプリを起動した直後の場合にのみ承認してください。登録名は自己申告にすぎません。
4. 読み取り可能なワークスペースで目的のワークスペースを選択してください。ファイルとフォルダーの読み取り（files.read）は必須です。プランとストレージの表示（account.read）は要求された場合も任意です。クライアントがアカウントの使用量を必要としない限りオフのままにしてください。同意画面には対象外の機能として、変更、共有、削除、他のワークスペースやVaultを開くことも表示されます。
5. 許可（認識されたクライアントではアクセスを許可（Claude/ChatGPT））を選び、開始元のクライアントに戻って完了を待ってください。拒否は認可を中止します。同意の処理は10分後に期限切れになります。期限切れの場合はクライアントから認可をやり直してください。

以下は接続値であり、すべてのクライアントに共通するJSONスキーマではありません。

Server URL: https://mcp.dosya.dev/mcp
Transport: Streamable HTTP
Authorization: OAuth through the browser
Required scope: files.read
Optional scope: account.read
Workspace: selected on the Dosya consent page

読み取り専用の呼び出しで結果を確認する

クライアントに空の引数オブジェクト{}でlist_workspacesを実行し、返されたワークスペースIDと名前を表示するよう依頼してください。structuredContent.workspacesには認可されたワークスペースだけが示されるはずです。ファイルの内容を読まずに接続を確認できます。別のワークスペースが返された場合は、その認可を切断して再認可してください。ツールの引数に別のワークスペースIDを追加しても認可は拡大しません。

次に、必要に応じて{"page":1,"per_page":5}を指定してlist_folderを実行してください。フォルダーを省略するとアクセス可能なルートが使われます。アクセスが制限されたメンバーの場合は許可された起点になります。返された項目名をdosyaのファイル画面と比較してください。一覧は標準で25件ずつ表示され、1ページあたり1〜100件を指定できます。サインインを証明するためだけなら、モデルに機密コンテンツの読み取りを依頼せず、ここで止めてください。

クライアントが受け取れるもの

ツール	結果と機能
list_workspaces	認可されたワークスペースの識別子と名前。
list_folder、search_files	許可されたフォルダーとファイルの項目、およびページ分割。検索は名前やクエリによるもので、全アカウントの無制限な走査ではありません。
get_file_info	内容を読まずに名前、バイト単位の容量、種類、現在のバージョン、フォルダー/ワークスペース、Web URLを取得します。
read_file	抽出されたテキストまたは画像の説明、参照元とバージョンのメタデータ、途中で切れた場合の継続カーソル。
get_download_link	オリジナルファイルのダウンロード用に300秒間有効なURLとexpires_in_seconds。URLを持つ人は誰でも期限まで使用できます。
get_account_info	アカウントのプランとストレージ使用量。任意のaccount.readスコープが必要です。
search、fetch	リサーチに対応した名前検索とドキュメントテキスト、参照元リンク。

ツールは9個あり、書き込み、アップロード、削除用のツールはありません。ダウンロードリンクの発行やテキスト変換は保存済みファイルを変更しませんが、アクセスや使用量として記録されます。クライアントは公開対象に選んだ読み取り可能なコンテンツを受け取ります。そのコンテンツはAIアプリの設定に従ってチャットや履歴に入る場合があります。後で切断しても、既に受け取ったバイトデータや会話履歴は回収できません。署名付きダウンロードURLを公開チャットやログに載せないでください。

制限、有効期間、再認可

Freeでは接続ごとにUTCの日単位でファイル読み取り100回と画像変換25回が可能です。有料プランではMCPの読み取りと画像変換に日単位の回数上限はありません。リクエスト頻度、ダウンロード転送量、その他のAPIプラン制限は引き続き適用されます。一覧取得やファイルメタデータの取得ではテキスト読み取り操作は実行されません。キャッシュされた抽出結果を含め、要求した各テキスト範囲は読み取りとして数えられる場合があります。日単位の回数は00:00 UTCにリセットされます。繰り返し再試行せず、上限に達した応答に示されるリセットを待ってください。

標準のテキスト範囲は100,000文字です。通常、変換は最大26,214,400バイト（25 MiB）の元ファイルを受け付け、変換期限は45秒です。デプロイ設定でこれらの上限を変更できます。容量超過または非対応の種類でも、許可されていればget_download_linkを使用できます。read_fileはtruncated、cursor、offset、total_chars、file_versionと参照元情報を返します。返されたカーソルで続きを取得してください。ファイルのバージョンが変わった場合はカーソルなしでやり直します。異なるバージョンの範囲を混ぜることはできません。

OAuthアクセストークンの有効期間は1時間です。クライアントが更新します。接続は30日間未使用の場合、または接続から最大180日後に期限切れとなり、再認可が必要です。OAuth認可の代わりに管理する永続的なMCPセッションはありません。呼び出し時にアカウントの停止、削除、プラン変更が確認されます。ワークスペースのメンバー資格を失うと、その後のアクセスはブロックされます。

認可とツールの問題を解決する

応答または状態	次の操作
ブラウザの同意画面が開かない	リモートHTTP/OAuth/DCRへの対応と、MCPおよびAPIホスト両方へのネットワークアクセスを確認してください。APIキーは代替手段になりません。
このアプリが読み取れるワークスペースがありません。エンドツーエンド暗号化されたスペースは連携できません。	暗号化されたスペースではなく、許可された通常のワークスペースとメンバー資格を使用してください。
This connection is not authenticated. Sign in to dosya again to reconnect.	有効期限や取り消しを確認し、クライアントの認可をやり直してください。
dosya could not be reached just now. This is temporary: try again in a moment. Do not reconnect.	待ってから再試行してください。インフラの停止は認可の取り消しとは異なります。
account.read権限がない	get_account_infoが必要な場合は、クライアントの再認可で任意のスコープを許可してください。他のファイルツールはfiles.readを使用します。
Not visible to this connection.	dosyaでワークスペース、メンバーの制限、ロール、ファイルの状態を確認してください。別のアカウントのIDを試さないでください。
dosya is rate limiting this connection right now. Wait a minute, then try again.	並行呼び出しを減らし、少なくとも指定された時間を待ってください。
変換、種類、容量による拒否	必要に応じてオリジナルのダウンロードリンクを使うか、対応するより小さいドキュメントを指定してください。
継続カーソルが無効または古い	古いカーソルを使わずにread_fileを再開し、現在のファイルバージョンを使用してください。

切断とワークスペースの変更

dosyaの設定 → 連携済みのAIアプリを開き、該当するクライアントとワークスペースの行を特定して接続を解除をクリックしてください。今後表示する必要がなければ、AIクライアントからもコネクターを外してください。認可を取り消すと新たな認可確認は通らなくなりますが、成功したトークン検証はキャッシュされるため、既に検証済みのトークンは最大60秒間動作する場合があります。以前ダウンロードされたバイトデータ、公開されたテキスト、既に発行されたダウンロードURLは切断しても消去されません。

選択したワークスペースを変更するには、古い認可を取り消し、新しい選択で再接続してください。AIアプリの許可、拒否、切断によって保存ファイルは変更されません。

期待される結果

クライアントがdosyaの読み取り専用ツールを検出し、list_workspacesが目的の認可を示し、許可された一覧がWebアプリと一致します。APIキーを管理することなく、連携済みのAIアプリで特定の接続を確認し、取り消すことができます。

関連ガイド

• AIアプリの権限を確認する
• MCPの読み取り専用操作をテストする