メインコンテンツへスキップ

arc serve

arc serve は HTTP または MCP 経由で AFS サーバーを起動し、他のプロセス（ブラウザ、エージェント、MCP クライアント）が CLI の代わりにネットワーク経由で AFS インスタンスと対話できるようにします。

arc serve は HTTP または MCP 経由で AFS サーバーを起動し、CLI 自身以外のもの（ブラウザ、エージェント、MCP クライアント）がネットワーク経由で AFS インスタンスと対話できるようにします。

使用法

bash
arc serve [options]

グローバルフラグ（概要 を参照）：--json、--view、--instance / -i（どのローカル ARC インスタンスか；省略すると default）、および --home（インスタンスのルート；どのインスタンスにするかを選ぶには --instance を使う）。

  • --host <host>：バインドするホスト（デフォルト localhost）
  • --port <port>：listen するポート（デフォルト 3000）
  • --path <path>：API のベースパス（デフォルト /afs）
  • --readonly：読み取り専用モード
  • --cors：CORS を有効にする；値を渡さないと off、* で任意のオリジン、またはカンマ区切りの許可リストを渡せる
  • --transport <http|mcp-stdio|mcp-http>：トランスポートモード（デフォルト http）。mcp-http は設計上ローカル開発専用で、Bearer token のサポートがない
  • --token <token>：すべてのリクエストで Bearer token を必須にする；config の serve.token を上書きする
  • --insecure-no-auth：非 loopback ホストにバインドする際、明示的に auth token なしで提供する。危険：バインドされたアドレスに到達できる人は誰でも AFS への完全なアクセスを得る

これは、名前付きの長時間稼働するバックグラウンドインスタンスを管理する arc service とは異なります。arc serve は単一セッション用のフォアグラウンドプロセスです。arc service を参照してください。

例

bash
$ arc serve --port 4000 --cors '*'
AFS HTTP Server starting...
Mounted providers:
  ...

Listening on: http://localhost:4000/afs
Press Ctrl+C to stop