APIキーと連携
ツールに必要なアクセス権を持つ認証情報を作成します。
- dosya MCPのツールとリソースを一覧表示する dosyaの9つの読み取り専用MCPツール、スキーマ、必要なスコープを確認します。サーバーが現在MCPリソースを公開していない理由も説明します。
- dosya MCPの読み取り専用操作をテストする 固定されたワークスペースに対してlist_workspacesとlist_folderを実行し、構造化されたページングフィールドを確認します。保存済みコンテンツが変更されないことも確認します。
- クラウドストレージREST APIクイックスタート 読み取り専用RESTキーを作成し、curlでワークスペースとファイルを一覧表示して、保存データを変更せずに認証、アクセス、再試行のレスポンスを調べます。
- APIキーの無効化と交換 名前とプレフィックスでAPIキーを特定し、状況に応じた安全な順序で交換してから無効化し、古いシークレットが拒否されることを確認します。
- S3認証情報を制限してアクセスを確認する S3認証情報を権限、プロトコル、ワークスペース、フォルダー、アドレス、時間帯、使用量で制限し、許可される操作と拒否されるオブジェクト操作を確認します。
- Webhookの配信に速やかに応答する 生の本文でdosyaのWebhook署名を検証し、イベントを永続的に保存して、10秒の配信タイムアウト前に2xxレスポンスを返します。
- Webhookエンドポイントを作成する アプリまたはRESTでワークスペースのWebhookを登録し、署名付きイベントを検証して配信をテストします。再試行、エンドポイントの上限、シークレットのローテーション、削除にも対応します。
- Webhook配信の重複を排除する dosyaのイベントIDをトランザクションの冪等性キーとして使用し、自動再試行や手動再配信による後続処理の重複を防ぎます。
- 使用していないWebhookエンドポイントを削除する 必要な配信の証拠を記録してから選択したWebhookエンドポイントを削除します。履歴と保留中の再試行も完全に削除されます。
- Webhookの配信を確認して再配信する Webhookの配信ステータス、レスポンスの詳細、再試行の時刻、識別子を確認し、受信サービスを修正してから安全に再配信します。