サーバー

dropstone serve コマンドは、Dropstone クライアントが使用できる OpenAPI エンドポイントを公開するヘッドレス HTTP サーバーを実行します。

使用方法

dropstone serve [--port <number>] [--hostname <string>] [--cors <origin>]

オプション

--cors は複数回渡すことができます:

dropstone serve --cors http://localhost:5173 --cors https://app.example.com

認証

DROPSTONE_SERVER_PASSWORD を設定して、HTTP ベーシック認証でサーバーを保護します。ユーザー名はデフォルトで dropstone ですが、DROPSTONE_SERVER_USERNAME を設定して上書きできます。これは dropstone serve と dropstone web の両方に適用されます。

DROPSTONE_SERVER_PASSWORD=your-password dropstone serve

エージェントの認証情報

DROPSTONE_SERVER_PASSWORD はサーバー自体を保護します。これはエージェントに Dropstone への到達方法を指示するものではありません。無人マシンでは、引き継ぐためのサインイン済みアカウントがないため、プロバイダー設定を通じて API キーを渡します:

{
  "provider": {
    "dropstone": {
      "options": {
        "apiKey": "dsk_live_...",
        "baseURL": "https://api.dropstone.io/api/v1"
      }
    }
  }
}

baseURL は重要です。API キーは /v1 ではなく /api/v1 で受け付けられ、/v1 に送信されたキーは 403 Invalid token format. Please log in again. で拒否されます。DROPSTONE_BASE_URL ではなく、ここで設定してください。DROPSTONE_BASE_URL はアカウント、使用量、メモリのエンドポイントの構築にも使用され、バージョン付きパスを指定するとそれらが壊れます。

キーは dropstone.io/dashboard/settings で生成します。

プロンプトの送信

POST /session/:id/message には agent と model の両方が必要です。model を省略するとデフォルトは解決されず、ターンは空のボディで 200 を返し、何も実行されません。

curl -X POST "http://127.0.0.1:4096/session/$SID/message?directory=$PWD" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "build",
    "model": { "providerID": "dropstone", "modelID": "dropstone-pro" },
    "parts": [{ "type": "text", "text": "Add error handling to src/index.ts" }]
  }'

失敗したターンでも 200 が返されます。理由はトランスポートレベルではなく data.info.error にあるため、ステータスコードに頼るのではなく、そのフィールドを確認してください。

仕組み

dropstone serve は、Dropstone の機能を OpenAPI 3.1 HTTP エンドポイント経由で公開します。同じエンドポイントが SDK の生成にも使用されます。

スクリプト、CI パイプライン、または独自の統合から Dropstone をプログラムで操作したい場合は、サーバーを使用してください。インタラクティブセッションとサーバーは独立しています。dropstone serve を実行すると、インタラクティブセッションが開いているかどうかに関係なく、新しいスタンドアロンサーバーが起動します。

バインドアドレスは --hostname と --port フラグ で上書きできます。

スペック

サーバーは、次の場所で表示できる OpenAPI 3.1 スペックを公開します:

http://<hostname>:<port>/doc

例: http://localhost:4096/doc。スペックを使用してクライアントを生成したり、リクエストとレスポンスの型を検査したりできます。または Swagger エクスプローラーで表示することもできます。

API

dropstone サーバーは以下の API を公開します。

グローバル

プロジェクト

パスと VCS

設定

セッション

メッセージ

コマンド

ファイル

/find/file クエリパラメータ

• query (必須): 検索文字列 (ファジーマッチ)
• type (オプション): 結果を "file" または "directory" に制限
• directory (オプション): 検索のプロジェクトルートを上書き
• limit (オプション): 最大結果数 (1–200)
• dirs (オプション): レガシーフラグ ("false" はファイルのみを返します)

LSP、フォーマッター、MCP

エージェント

ロギング

認証

イベント

ドキュメント