dosyaのMCP接続の問題を解決する
MCPの通信方式、OAuth、スコープ、ワークスペースの表示、回数制限、ファイル変換の問題を切り分け、読み取り専用ツールの呼び出しで確認します。
最終確認日
スクリーンショットは英語版の画面です。
正確なエラー内容と、最初に問題が発生した段階を確認してください。サーバーを検出できない場合は通信方式の問題です。ツールを一覧表示できても呼び出せない場合は、認可、スコープ、ワークスペース、表示、使用量、変換の問題です。すべてのエラーで再接続すると役立つ状態が失われることがあり、一時的なサービスの問題も解決しません。
手順
サーバーURLはhttps://mcp.dosya.dev/mcpです。リモートHTTPSのStreamable HTTPとブラウザベースのOAuthを使用します。/sse、ローカルのstdioコマンド、dos_… APIキー、モバイルトークン、dosyaのパスワードを設定しないでください。
クライアントはOAuthディスカバリー、PKCEを使った認可コード、動的クライアント登録、リモート通信方式に対応している必要があります。設定でローカル実行コマンドまたは固定のBearerヘッダーしか受け付けない場合、そのクライアントのモードではdosyaの認可を完了できません。クライアントのプランまたは組織の管理者がリモートコネクターを許可していることを確認してください。
同意画面が開いたら、アカウント、コールバック先、読み取り可能なワークスペースを確認してください。ファイルとフォルダーの読み取り（files.read）は必須です。プランとストレージの表示（account.read）は任意で、get_account_infoにのみ必要です。同意の処理は10分後に期限切れになります。ブラウザのページをそれ以上開いたままにした場合は、クライアントからやり直してください。
返されたメッセージから対処方法を選ぶ
| メッセージまたは症状 | 意味と次の操作 |
|---|---|
| ブラウザの同意画面が開かない | 正確なサーバーURL、リモートHTTP/OAuthへの対応、mcp.dosya.devとapi.dosya.devの両方へのネットワークアクセスを再確認してください。APIキーは代替の通信方式にはなりません。 |
| このアプリが読み取れるワークスペースがありません。エンドツーエンド暗号化されたスペースは連携できません。 | 読み取り可能な通常のワークスペースに参加するか選択してください。Vaultと暗号化されたスペースはこのコネクターの対象外です。 |
| 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. | 認可を維持し、サービスの復旧後に再試行してください。再認可では依存先の問題は解決しません。 |
ツールは表示されるがget_account_infoが拒否される | プランやストレージ情報が必要な場合のみ、account.readを付けて再認可してください。ファイルツールは引き続きfiles.readを使用します。 |
| Not visible to this connection. | dosyaで選択したワークスペース、現在のメンバー資格、フォルダーの制限、ロール、非表示やロックの状態、現在のファイルIDを確認してください。ツールの引数に別のワークスペースIDを指定しても認可は拡大しません。 |
| dosya is rate limiting this connection right now. Wait a minute, then try again. | 並行呼び出しを停止し、少なくとも指定された時間を待ってから再試行してください。再接続しても枠は増えません。 |
| 今日の読み取り・画像変換枠を使い切った | Freeの接続ではUTCの日単位でファイル読み取り100回と画像変換25回が可能です。00:00 UTCまで待つか、該当する有料プランを利用してください。メタデータと一覧取得の呼び出しは別です。 |
| 継続カーソルが無効または古い | カーソルを指定せずにread_fileを再開し、現在のファイルバージョンを使用してください。異なるバージョンの範囲は結合できません。 |
期待される結果
クライアントに{}を指定してlist_workspacesを実行するよう依頼してください。正常な応答では、同意時に固定したワークスペースだけが示されます。別のワークスペースが表示されたら、dosyaの設定 → 連携済みのAIアプリを開き、該当するクライアントとワークスペースの行を切断して、目的の選択で再認可してください。
次に、{"page":1,"per_page":5}を指定し、フォルダーIDを指定せずにlist_folderを実行してください。標準の1ページあたりの件数は25件、許容範囲は1〜100件です。アクセスが制限されたメンバーの場合は許可された起点から始まります。機密ファイルを読むようモデルに依頼する代わりに、返された名前を同じアカウントのdosyaのファイル画面と比較してください。
現在dosyaは9つの読み取り専用ツールを提供しています。MCPにはアップロード、編集、共有、削除のツールはありません。OAuthが成功した後にツールが表示されない場合は、コネクターの定義を外して追加し直すか、ツールの検出を更新してください。ファイル権限を広げても存在しない書き込みツールは表示されません。
ファイル読み取りとダウンロードリンクの問題を調べる
read_fileは標準で最大100,000文字のテキスト範囲を返します。通常、変換は最大26,214,400バイト（25 MiB）の対応ファイルを受け付け、変換期限は45秒です。デプロイ設定によりこれらの値が小さくなる場合があります。非対応または容量超過の種類については、アクセスが許可されていればメタデータまたはget_download_linkを使用してください。
生成されたオリジナルファイルのURLは300秒間有効です。URLを持つ人は誰でも期限までダウンロードできるため、公開ログやサポートへのメッセージに貼り付けないでください。コネクターは保存済みファイルを変更できませんが、リンクの発行やコンテンツの変換はアクセスや使用量として記録されることがあります。
OAuthアクセストークンの有効期間は1時間で、クライアントが更新します。接続を30日間使用しなかった場合、または接続から180日が経過した場合は再認可が必要です。呼び出し時にメンバー資格の喪失、アカウント状態、プランの変更が再確認されます。検証キャッシュで既に受け入れられたトークンに切断が反映されるまで最大60秒かかる場合があります。外部アプリが既に受け取ったコンテンツ、会話履歴、ダウンロードURLは回収できません。
安全な情報を添えて問い合わせる
それでもlist_workspacesが動作しない場合は、クライアント名とバージョン、サーバーURL、おおよその日時とタイムゾーン、到達した段階、秘密情報を含まない正確なメッセージ、連携済みのAIアプリに同意が表示されるかどうかを記録してください。Bearerトークン、認可コード、署名付きダウンロードURL、ファイルの内容は問い合わせに含めないでください。
関連ガイド
この記事は役に立ちましたか？
評価の結果を読み込んでいます…
投票すると、回答を変更できるように、必要な投票用Cookieが最長180日間保存されます。
質問と回答
このガイドの手順について質問できます。質問は確認後に公開されます。
公開の質問には、アカウントの詳細、認証情報、非公開ファイルを含めないでください。これらについては 非公開サポート をご利用ください。
質問を読み込んでいます…
dosyaアカウントにサインインすると、質問を投稿できます。