dosya MCPの読み取り専用操作をテストする

最初のMCPテストには一覧取得の呼び出しを使ってください。ファイルのバイトデータをダウンロードせず、1日あたりのコンテンツ読み取り枠を消費することなく、認証、ワークスペースの制限、構造化された出力、読み取り専用の動作を確認できます。

手順

1. 接続済みのMCPクライアントで、引数を指定せずにlist_workspacesを呼び出してください。返されたworkspace_idを記録します。有効な認可では、OAuth同意画面で選択したワークスペースだけが一覧に表示されます。
2. そのworkspace_idを指定してlist_folderを呼び出し、folder_idを省略してアクセス可能なルートを取得してください。フォルダーへのアクセスが制限されたメンバーの場合、ワークスペース全体のルートではなく許可された起点になります。ページング値も省略すると、標準の1ページ目に25件が表示されます。
3. structuredContent.entriesを確認してください。フォルダーとファイルの行にはkind、id、name、folder_id、アプリのURLが含まれます。ファイルには、利用可能な場合、バイト単位の容量、MIMEタイプ、更新日時も表示されます。
4. pageとnext_pageを確認してください。next_pageが数値の場合は、そのページを指定して同じツールを呼び出します。nullになったら終了してください。クライアントは1ページあたり1〜100件を要求できます。
5. 同じアカウントでdosyaを別に開き、返された名前を選択したワークスペースのアクセス可能なルートと比較してください。フォルダーへのアクセスが制限されたメンバーの場合は、許可された起点と比較します。非表示または削除済みのコンテンツは除外されます。接続によって別のワークスペースやエンドツーエンドで暗号化されたスペースが見えてはいけません。
6. Webの一覧を更新し、ファイル、フォルダー、共有、バージョンが変更されていないことを確認してください。MCPサーバーに変更用のツールはなく、登録済みのすべての操作は読み取り専用かつ非破壊と宣言されています。

list_folderはAPIリクエストの枠を使いますが、コンテンツの読み取りには数えられません。後でread_fileをテストする場合、現在の標準値は100,000文字の範囲、変換上限25 MiB、変換期限45秒です。Freeプランの標準値はUTCの日単位でファイル読み取り100回、画像変換25回です。有料プランの標準値は無制限です。

期待される結果

list_workspacesは固定されたワークスペースを返し、list_folderはメンバーがアクセス可能なルートの構造化されたページ単位の一覧を返します。フォルダーへのアクセスが制限されたメンバーの場合は、許可された起点が対象です。dosyaで再確認すると、この操作によって何も作成、変更、共有、削除されていないことがわかります。

結果にNot visible to this connection.と表示される場合 識別子がOAuth同意時に選択したワークスペースに属し、サインイン中のメンバーが引き続きアクセスできることを確認してください。

サービスを利用できないと表示される場合 再接続せず、少し待ってから再試行してください。一時的なゲートウェイの問題では、認証情報を無効にする代わりにdosya could not be reached just nowが返されます。

関連ガイド

• MCPクライアントを接続する
• MCPの問題を解決する