AI エージェント(MCP) PRO PREVIEW
PREVIEW 注意: MCP サーバーは社内テスト中で、まだリリースされていません。このページはテスト中のビルドを説明するもので、キー、ルート、ツール名、各アプリの画面はリリースまでに変わる可能性があります。
[General]
external-mcp-server = 127.0.0.1:6180
Chute Mac、Chute iOS、Chute tvOS のエンジンは、専用の MCP(Model Context Protocol)サーバーを内蔵しています。AI エージェント — Claude Code、Codex、そのほか MCP に対応したクライアント — はここに接続し、エンジンが何をしているか(状態、ポリシー、ルール、接続、DNS、ログ、設定)を読み取り、変更できます。ポリシーを選ぶ、ルールを試す、設定のセクションを書き換える、グループのメンバーを計測する、といったことです。
HTTPコントロールAPI のルートの上に作られ、認証も同じシークレットを使いますが、リスナーは独立しており、専用ポートの /mcp で待ち受けます。external-http-controller も Webコンソールも必要ありません。既定ではオフです。
PRO 注意: MCP サーバーは Chute Pro の機能です。ライセンスが無いと、エンジンはこれを起動しません。
external-mcp-serverを書いてもポートは開かず、設定は引き続き編集できます。ライセンスが有効になると Chute を再起動しなくてもサーバーが起動し、ライセンスが無くなると停止します。Chute Mac の無料トライアル中もライセンスがあるものとして扱われます。HTTPコントロールAPI そのものには影響しません。その間にアプリが何を表示するかは Chute Pro が無いときを、あわせてライセンスと有効化も参照してください。
何に使うか
読み解くのはエージェントの仕事なので、自分の言葉で尋ねれば十分です。たとえば:
- 「なぜ
api.example.comが HK-01 経由になるの?」 — エージェントはmatch_ruleでマッチしたルールとポリシーを確かめ、edit_user_rulesで修正を試し、うまくいったらreplace_profile_sectionで[Rule]に書き込みます。 - 「Auto の中でまだ使えるノードは?」 — グループに対する
test_policyが全メンバーを順に計測し、終わったものから報告します。 - 「今朝からこのアプリがサーバーにつながらない。」 —
failedフィルター付きのlist_connections、キーワード付きのget_logs、ネットワークそのものにはrun_diagnostics。 - 「このサイトの広告を消して。」 — まず
add_rewriteとadd_mitm_hostで実行中のエンジンで試し、残す行を設定に書きます。
有効にする
external-mcp-server(既定: 無効)
external-mcp-server = 127.0.0.1:6180
MCP サーバーのアドレスとポートです。これは Chute 独自のキーで、Surge にも Clash にも相当するものは無く、それらの設定をインポートしてもこの行は作られません。アドレスの書き方は external-http-controller と同じです。127.0.0.1:6180 はこのデバイス専用、0.0.0.0:6180 または *:6180 はすべてのインターフェース、IPv6 は [::]:6180。127.0.0.0/8 全体と ::1、localhost がループバックとみなされます。解析できないアドレスは設定エラーになります。アプリがこれをオンにするときはポート 6180 を使います。
認証。 エージェントは Authorization: Bearer <token> を送ります。トークンは HTTPコントロールAPI のものです:
- 設定に
external-http-secretがあればそれ; - 無ければ、Chute が生成して共有フォルダーの
control-tokenファイルに保存するトークン —external-http-controllerがオフでも生成され、各アプリに表示されます; external-http-secret = noneは認証なしを意味し、ループバックのアドレスでのみ受け付けられます。
ループバック以外では、MCP サーバーには明示的な external-http-secret が必要です。生成されたトークンも none も不十分です。無ければ起動せず、アプリがその理由を表示します。
エンジンと一緒に動きます。 Chute の起動とともに起動し、停止とともに停止するので、エージェントは Chute を起動・停止することも、アプリに別の設定へ切り替えさせることもできません。再読み込みでリスナーが再起動するのはアドレスかシークレットが変わったときだけで、それも送信中の応答をすべて書き終えてからです — MCP サーバー自身のアドレスを変えたエージェントも、その応答は受け取れます。
external-mcp-mask-secrets(既定: true)
external-mcp-mask-secrets = false
パスワード、鍵、トークンをハンドルとしてエージェントに渡すかどうか — シークレットのマスクを参照。これも Chute 独自のキーで、false のときだけ設定に書き出されます。
アプリでの設定
- Chute iOS: 設定エディターの 外部コントローラー → MCPサーバー: スイッチ、ポート、Wi-Fiからのアクセスを許可(
0.0.0.0で待ち受けます。そのとき必要な シークレット の行は HTTPコントロールAPI のものです)、シークレットをマスク。コントロールパネルの Webコンソールの下にある AIエージェント(MCP) の行は 実行中、未起動、未設定 のいずれかを示し、タップすると、待ち受けていない理由、このデバイス 用のアドレスと(ループバック以外なら)他のデバイス 用のアドレス、トークン(トークンを表示 を押すまで隠れています。行をタップするとコピー)、そのまま使えるclaude mcp addコマンドと JSON の クライアント設定、クイック操作 のページが開きます。MCP サーバーは VPN の中で動くため、VPN がオフのときは現在の設定でどうなるかを表示します。 - Chute Mac: メインウィンドウの 設定 タブ → 一般 → MCPサーバー: MCPサーバーを有効にする、アドレスとポート、HTTPコントロールAPI と共用のシークレット、シークレットを隠す、状態とクライアント設定…。Chute の実行中は、メニューバーのメニュー(およびメニューバーパネルの … メニュー)の AI エージェント(MCP)… でウィンドウが開きます。状態、アドレス、トークン(表示、コピー)、シークレットがマスクされているか、そして エージェントを接続: HTTP 経由の Claude Code 用、
chuteコマンド経由の Claude Code 用、ほかのクライアント用 JSON の設定です。 - Chute tvOS: 設定の編集 → 一般 → MCP サーバー: オン・オフ、待ち受けアドレス(
127.0.0.1または0.0.0.0)、ポート、シークレットをマスク。同じページでシークレットも設定できます。これは HTTPコントロールAPI のexternal-http-secretそのものです。値は伏せて表示され、選べば原文を表示できます。空にすると Chute が生成するトークンを使い、noneにすると認証をしません(危険であることを示す警告が出ます)。スペースや改行は含められません。変更すると、Webコンソールとchuteコマンドの認証も変わります。0.0.0.0でシークレットが無いときは、サーバーが起動しないことを示し、その場で設定できるようにします。コントロールパネルの AI エージェント(MCP) の行には、状態、アドレス、LAN アドレス、トークン(選択するまで隠れています)が表示されます。テレビではコピーはできません。
クイックスイッチ — iOS の クイック操作、Mac のウィンドウの MCP をオンにする / MCP をオフにする と シークレットを隠す、テレビのページの MCP サーバー と シークレットをマスク — は、現在の設定ファイルのこの 2 つのキーを書き換えて、すぐに適用します。ここからオンにすると 127.0.0.1:6180 で待ち受けます。iOS では、サブスクリプションの設定ではこれらは無効です。次の更新で変更が消えてしまうからです。
Chute Pro が無いとき
ライセンスが無いとき、アプリはサーバーを「待ち受けていない」と報告するのではなく、Chute Pro が必要だと表示します:
- Chute Mac: メニューバーのメニューとメニューバーパネルの … メニューにある AI エージェント(MCP)…、そして 一般 ページの MCPサーバーを有効にする に PRO カプセルが付きます。AI エージェント(MCP) ウィンドウは先頭に Chute Pro の案内と Chute Proを入手 ボタンを表示し、状態は Chute Proが必要 となって、アドレスもトークンも表示しません。MCP をオンにする はサーバーをオンにする代わりに Chute Pro ウィンドウを開きます。オフにする操作と シークレットを隠す はいつもどおり使えます。Chute Pro ウィンドウの機能一覧には AI エージェント(MCP) が加わります。
- Chute iOS と Chute tvOS: コントロールパネルの AI エージェント(MCP) の行と、設定エディターの MCP スイッチに PRO カプセルが付きます。状態のページは Chute Proが必要 と表示し、アドレスとトークンの代わりに Chute Pro への入り口を示します。そのページのクイックスイッチでサーバーをオンにしようとすると、アプリのほかの Chute Pro スイッチと同じく、まず Chute Pro を求めます。
- 3 つのアプリとも、設定エディターの項目は引き続き編集でき、「今回の実行で動かなかった Chute Pro の機能」を知らせる案内には MCP サーバーが挙がります。
エージェントを接続する
HTTP で接続
Streamable HTTP に対応したクライアントは直接接続できます:
- アドレス:
http://<host>:<port>/mcp— 同じデバイス上のエージェントならhttp://127.0.0.1:6180/mcp - ヘッダー:
Authorization: Bearer <token>。トークンはアプリに表示されるもの
Claude Code の場合:
claude mcp add --transport http chute http://127.0.0.1:6180/mcp --header "Authorization: Bearer <token>"
JSON で設定するクライアントの場合:
{"mcpServers": {"chute": {"type": "http", "url": "http://127.0.0.1:6180/mcp", "headers": {"Authorization": "Bearer <token>"}}}}
Chute iOS と Chute Mac は、この 2 つをアドレスとトークンを埋めた状態でコピーします。iPhone では、同じ iPhone 上のエージェントアプリも 127.0.0.1 で接続できます。
サーバーは MCP 2026-07-28 を実装し、2025-11-25、2025-06-18、2025-03-26 のクライアントも受け付けます。セッションは保持しません。JSON-RPC メッセージ 1 つが /mcp への POST 1 回で、応答は JSON — 時間のかかるツールではイベントストリーム — で、応答の後で接続は閉じます。GET、DELETE、OPTIONS には 405 を返し、バッチ(JSON 配列)は拒否し、リクエストボディは 1 MB まで、同時に処理する接続は 8 つまでです。
chute mcp で接続
MCP サーバーを自分で起動するプログラムとしてしか扱えないクライアントや、設定ファイルにトークンを書きたくないクライアントは、chute コマンドラインツールを中継に使います。chute mcp は読み取った行を 1 行ずつ MCP サーバーに渡し、応答を 1 行ずつ書き戻します。
claude mcp add chute -- chute mcp
{"mcpServers": {"chute": {"command": "chute", "args": ["mcp"]}}}
Chute が動いている Mac ではこれだけで十分です。chute mcp はメッセージごとにエンドポイントファイルからアドレスとトークンを読むので、クライアントより後に起動した Chute も見つけられます。トークンは次の順で最初に見つかったものを使います:
--token-file <path>- 環境変数
CHUTE_MCP_TOKEN - この Mac 上のサーバーに限り、エンドポイントファイル、次に共有フォルダーの
control-token
--url http://<host>:<port>/mcp で別のデバイスを指せます。CHUTE_MCP_ENDPOINT は代わりに読むエンドポイントファイルを指定します。--token と --token-stdin は拒否されます。標準入力そのものが MCP の通信路であり、コマンドラインに書いたトークンはクライアントの設定やプロセス一覧に残るからです。サーバーに届かないときは、エージェントが理由つきのエラーを受け取ります — ポートが閉じていれば external-mcp-server を、401 ならトークンを確かめるよう示します。
コンピューターから iPhone や Apple TV に接続
デバイスでネットワーク上の待ち受けとシークレットを設定します:
[General] external-mcp-server = 0.0.0.0:6180 external-http-secret = a-long-random-secretiOS では Wi-Fiからのアクセスを許可 と シークレット の行、tvOS では同じページで 待ち受けアドレス を
0.0.0.0にし、シークレットを設定します。- VPN を接続し、他のデバイス(iOS)または LAN アドレス(tvOS)のアドレスを確認します — たとえば
http://192.168.1.20:6180/mcp。 同じネットワーク上のコンピューターで:
claude mcp add --transport http chute-phone http://192.168.1.20:6180/mcp --header "Authorization: Bearer a-long-random-secret"またはシークレットをファイルに置いて:
chute mcp --url http://192.168.1.20:6180/mcp --token-file ~/.config/chute/phone.token
このアドレスはネットワーク上のデバイスのアドレスなので、ネットワークがデバイスに別のアドレスを割り当てると変わります。
エンドポイントファイル
MCP サーバーが待ち受けている間、エンジンは共有フォルダーに mcp-endpoint を所有者のみ読み取り可能な権限で書き、サーバーが止まると削除します。中身は値がすべて文字列の JSON オブジェクトで、running、configured、url、lan_url(ループバック以外のとき)、bind、port、loopback、token、anonymous、mask_secrets — アプリが表示する内容と同じです。Mac では ~/Library/Application Support/com.R3Studio.Chute-Mac/Share/mcp-endpoint(ファイルの場所を参照)にあり、このおかげでローカルのクライアントはポートもトークンも知らずに済みます。iPhone と Apple TV ではアプリのコンテナの中にあるので、アドレスはアプリで確認してください。
シークレットのマスク
エージェントが読んだものは、エージェントのモデル提供元に送られます。そのため既定では、設定のシークレットはエージェントに渡りません。シークレットは、設定の中でも、ログを含むほかのどの結果の中でも、現れる場所すべてで <secret:password:3f9c0a1b2e> のようなハンドル — 種類と識別子 — に置き換えられます。サーバーのアドレスはそのまま見えるので、エージェントはノードやダウンロードがどのサーバーを指しているかを把握できます。
[Proxy]
HK-01 = trojan, hk.example.com, 443, password=<secret:password:3f9c0a1b2e>, sni=hk.example.com
[Proxy Group]
Sub = select, policy-path=https://sub.example.com<secret:url_secret:8d2e4f6a1c>
マスクされるもの: プロキシのパスワード、UUID、事前共有鍵、秘密鍵、obfs と shadow-tls のパスワード、MASQUE の token のようなトークン — WireGuard と AmneziaWG のセクションや、プロキシプロバイダーのノードのものも含みます。http-auth の各パスワード、external-http-secret、external-controller-access のパスワード。ca-p12 と ca-passphrase。Tailscale の auth key。スクリプトの argument=。サブスクリプション、policy-path、ルールセット、モジュール、#!MANAGED-CONFIG の URL のパス、クエリ、ユーザー情報の部分(スキーム、ホスト、ポートは残ります)。そして [Header Rewrite] で Authorization、Proxy-Authorization、または名前に token、key、secret、auth、password、cookie を含むヘッダーの値。8 文字未満のシークレットは、フィールドの値として現れる場所では置き換えられますが、ログ行のような自由なテキストの中では置き換えられません。そこでは普通の単語と見分けがつかないからです。
書き戻し。 エージェントが設定のテキストを書き戻すとき、そのまま残したハンドルは元の値に戻ります。そのためエージェントは、パスワードを知らなくてもノードのポートや名前を変えたり、セクションを並べ替えたりできます。ハンドルは移動やコピーもできますが、制限が 2 つあります:
- 同じ種類のフィールドにしか戻せません — パスワードのハンドルはパスワードのフィールドへ;
- その行が、シークレットの出どころと同じサーバーにつながっている必要があります: プロキシのサーバー、URL のホスト、または同じ
[General]のキー。
それ以外の場所のハンドル — 別のサーバーへの行、ルールの中、でっち上げたもの、期限切れのもの(後述) — は行番号と理由つきで拒否され、何も適用されません。その値はあなた自身が入力するものです。エージェントが新しいシークレットを全文で書いた場合はそのまま受け付けますが、もちろんその時点でエージェントのコンテキストに入っています。
同じ値には常に同じハンドルが付くので、エージェントは 2 つのノードが同じパスワードを共有していることがわかります。ハンドルが有効なのは、それを発行したプロセスが続いている間だけです — Chute Mac が終了するまで、または Chute iOS や Chute tvOS の VPN が切断されるまで。その後は拒否されるので、エージェントに設定を読み直させてください。
マスクの対象は設定のシークレットです。あなた自身のトラフィックに含まれる認証情報 — Web サイトの Cookie、アプリが送った Authorization ヘッダー — は設定のシークレットではなく、マスクされません。それも、これらが明示的に求められたときにしか渡されない理由の 1 つです(後述)。
オフにする。 external-mcp-mask-secrets = false — またはアプリの シークレットをマスク スイッチ — にすると、すべてのシークレットがそのままエージェントに渡され、エージェントにもそう伝えられます。それらの認証情報がエージェントのモデル提供元のコンテキストに入ることを受け入れる場合にだけ、そうしてください。
サードパーティのコンテンツ
リクエストとレスポンスのヘッダーや本文、ログ行、スクリプトの出力、URL からダウンロードしたモジュールのテキストは、他人が書いたものです — Web サイト、アプリ、サーバーの運営者。Web ページには、エージェントへの指示に見せかけた文章を仕込むことができます。そのため:
- 既定では、ツールはメタデータだけを返します: ホスト、URL、ポート、ポリシー、ルール、プロセス名、バイト数、時間、状態;
- 内容はエージェントが明示的に求めたときだけ —
include付きのget_connection、get_logs、run_script、get_module—untrustedキーの下に入れて返し、エージェントにはそれを指示ではなくデータとして読むよう伝えます。
これはエージェントのコンテキストをきれいに保ち、トークンを節約するためのもので、アクセス制御ではありません。トークンを持つエージェントは HTTPコントロールAPI を直接呼び出して何でも読めます。
ツール
各ツールは 4 つの種類のどれかとして示され、クライアントはそれを見て、呼び出す前にあなたに確認するかどうかを決めます。
読み取り専用
| ツール | 内容 |
|---|---|
get_status |
エンジンが動いているか、どう動いているか: アウトバウンドモード、各スイッチ、TUN、リスナー、メモリ、接続数、前回の終了の仕方 |
get_network_summary |
デバイスがいるネットワーク — 種類、Wi-Fi 名、ルーター — そこで SSID 設定が Chute を一時停止させているか、デバイスのアドレス |
get_traffic |
上り・下りのバイト数と現在の速度 |
list_policies |
グループと現在の選択、最終的に行き着くノードとそのレイテンシ。group で 1 つのグループの全体、detail で全メンバー |
get_policy |
1 つのポリシーの設定行と、エンジンが今把握していること: サーバー、ポート、UDP、レイテンシ、行き先 |
list_rules |
マッチ順のルールとそれぞれの出どころ。filter で絞り込み |
match_rule |
リクエストがどのルールとポリシーに当たるか、名前解決の前後それぞれで。実際には送りません |
list_user_rules |
エンジン実行中に追加されたルール |
list_connections |
開いている接続または記録された接続、メタデータのみ。ホスト、プロセス、ポリシー、失敗したかで絞り込み |
get_connection |
1 つの接続。ヘッダーと本文は include で指定したときだけ |
get_logs |
エンジンのログの行。最低レベルとキーワードで絞り込み |
get_events |
この実行での主な出来事。after で新しいものだけ |
list_dns_cache |
DNS レコードと、それぞれに応答したサーバー |
query_dns |
エンジン自身のリゾルバーで名前を解決し、どれが応答したかを示します |
geoip_lookup |
アドレスまたは名前の国と ASN |
get_profile |
実行中の設定を 1 ページずつ、revision 付きで |
list_profile_sections |
設定のセクション。それぞれの revision と書き込めるかどうか |
get_profile_section |
1 つのセクションのテキストと revision |
validate_profile |
再読み込みと同じように設定を解析しますが、適用はしません |
get_log_level |
ログレベルと記録中のセクション |
list_scripts |
run_script で実行できる generic スクリプト |
list_rewrites |
有効な書き換えルールとモックレスポンスのルール、MitM ホストの一覧 |
list_mitm_hosts |
復号中のホスト |
list_modules |
読み込まれたモジュール、その id、オンかどうか |
get_module |
1 つのモジュールのテキスト |
list_external_resources |
外部から取得するルールセット、ルールプロバイダー、プロキシプロバイダー、モジュール: それぞれの更新時刻、項目数、最後のエラー |
get_tailscale |
Tailscale ノード: ID、出口ノード、DERP、detail でピア |
watch_events |
1〜60 秒の間エンジンのイベントを見守り、すべて返します |
テスト
これらは自分でトラフィックを送ります。
| ツール | 内容 |
|---|---|
test_policy |
ポリシー経由で HTTPS リクエストを 1 つ送り、ステータスコードと時間を返します。グループなら全メンバーを、1 つずつ報告 |
test_policies |
複数のポリシー、またはすべてのポリシーを、1 つずつ報告 |
ping |
デバイスから直接 ICMP、または TCP 接続を開くまでの時間 |
egress_probe |
物理ネットワーク上でのこのデバイス自身のアドレス |
internet_test |
プロキシを通さずに internet-test-url へ 1 回リクエスト: そもそもインターネットにつながるか |
run_diagnostics |
エンジンの健全性、インターネットテスト、出口アドレス、DNS 問い合わせを 1 段ずつ行い、最後にレポート |
test_policy がグループのメンバーについて報告する時間は HTTPS の往復時間です。グループ自身のテストは通常プレーン HTTP の URL を取得するので数値が異なり、グループはこの数値で選ぶわけではありません。グループ自身のテストはその後に実行され、いつもどおりに選びます。
設定の変更
| ツール | 内容 |
|---|---|
set_outbound_mode |
ルール、グローバル、ダイレクト |
select_policy |
select グループのメンバー、またはグローバルの選択(GLOBAL)。自動グループは自分で選ぶので拒否します |
set_feature |
MitM またはトラフィック記録のオン・オフ |
set_log_level |
ログレベルと記録するセクション。再読み込みは不要 |
edit_user_rules |
実行時ルールの置き換え、追加、消去。ルールでない行が 1 つでもあれば変更全体を拒否 |
add_mitm_host、remove_mitm_host |
MitM ホストの一覧 |
add_rewrite、remove_rewrite |
URL・ヘッダー・本文の書き換えルール、またはモックレスポンスのルール。設定の行の書き方で |
set_modules_enabled |
モジュールのオン・オフ |
update_external_resource |
ルールセット、ルールプロバイダー、プロキシプロバイダーを今すぐ取得 |
replace_profile_section |
設定の 1 つのセクションを置き換え(または追加し)、再読み込み |
replace_profile |
設定全体を置き換えて再読み込み |
破壊的
| ツール | 内容 |
|---|---|
reload_profile |
実行時の変更を取り消します: 書き換え、MitM ホスト、モジュールのスイッチが設定どおりに戻ります |
kill_connection |
開いている接続を 1 つ閉じます。相手側のアプリからは切断に見えます |
flush_dns |
DNS キャッシュ、または 1 つの名前のレコードを消去 |
run_script |
設定の generic スクリプトを 1 つ実行し、その出力を返します |
ツールの応答
- 既定は要約。 一覧系のツールは各項目の主なフィールドだけを返します。
detail: trueで全フィールド。そのぶんトークンを使います。 - ページ。 長い一覧やテキストは
offsetとlimitを受け付け、続きがあるあいだnext_offsetを返します。 - 最大 256 KB。 それより大きい結果は項目単位か行単位で切られ、途中で切れることはなく、
truncated: trueと続きのnext_offsetが付きます — 届くのは常に正しい JSON です。 - エラーは文章で。 失敗したツールは、ステータスコードだけでなく、エージェントが対処できる文で理由を説明します。
変更がどこまで残るか
Chute iOS と Chute tvOS では、どの変更も実行中のエンジンの中だけで行われます。設定ファイルにもアプリ自身の設定にも何も書かれないので、再起動するとそれらの内容に戻ります。これは Webコンソールと同じです。
Chute Mac では、次の変更をアプリが保持します。アプリ自身のメニューで同じ変更をしたときと同じように保持されるので、再起動後も残ります。エージェントが行っても、Webコンソール、chute コマンド、HTTPコントロールAPI で行っても同じです:
- アウトバウンドモードとポリシーの選択(グローバルの選択を含む。
set_outbound_mode、select_policy): アプリが記憶します。 - MitM とトラフィック記録(
set_feature): 現在の設定ファイルに書き込みます。 - 設定そのもの(
replace_profile、replace_profile_section): 現在の設定ファイルに書き込み、アプリの 保存して適用 と同じ方法で適用します。
これらの結果には persisted: true が付き、エージェントが読むツールの説明にもあらかじめそう書かれています。次の場合、設定の書き込みは拒否され、何も書き込まれません:
| 状況 | コード | すること |
|---|---|---|
| メインウィンドウに未保存の変更がある | user_editing |
先にアプリで保存するか破棄する |
| 設定ファイルが Chute の外で変更された | file_changed |
先に Chute で読み込み直す |
| 現在の設定がローカルファイルではない | profile_missing |
— |
| アプリがダイアログを表示している | needs_user_action |
ダイアログに答えてから再試行する |
エンジンが拒否した設定もファイルには書き込まれません。アプリが 10 秒以内に終えないとき、エージェントは host_busy を受け取ります。変更はまだ反映される可能性があるので、エージェントは状態を読み直してから再試行するかどうかを決めます。知っておきたい点が一つあります: set_feature は MitM やトラフィック記録をすぐに切り替え、スイッチをファイルに書き込みますが、設定を再読み込みしません。そのため直後に get_profile が返す設定の本文と revision は、次の再読み込みまで古いままです。
どのプラットフォームでも、ログレベル、書き換え、MitM ホスト、モジュールのスイッチ、実行時ルールは今回の実行の間だけ有効で、アプリから設定を再読み込みすると、書き換え、MitM ホスト、モジュールのスイッチは元に戻ります。reload_profile は再読み込みせずに書き換え、MitM ホスト、モジュールのスイッチを元に戻し、ログレベル、アプリの LAN 接続スイッチ、アウトバウンドモード、ポリシーの選択はそのままです。edit_user_rules の実行時ルールは再読み込み後も残り、エンジンの停止で消えます。
設定を編集する
設定はセクションごとに変えるようエージェントに頼んでください。get_profile_section でセクションとその revision を読み、replace_profile_section でその revision を付けて書き戻します。その間にセクションが変わっていれば書き込みは拒否され、エージェントには読み直すよう伝えられます。別のセクションの変更は邪魔にならないので、2 つのエージェントが別々のセクションを編集できます。ファイル全体を扱う get_profile と replace_profile も、設定全体の revision で同じように動きますが、大きな設定は 1 回の応答に収まらず、replace_profile は 1 MB までです。
#!includeの行を含むセクション、その後のすべてのセクション、#!MANAGED-CONFIGを含むセクションには、この方法では書き込めません。- 書き込んだセクションは再読み込み後の設定から読み戻されます。
[General]と[MITM]の値は Chute の書き方で書き直され、[WireGuard …]のキーは並べ替えられるので、送ったテキストと異なることがあります。応答には次に使う新しい revision が入っています。 - Chute が拒否した設定は適用されず、エージェントは理由を受け取ります。マネージド設定では、次のマネージド更新で変更が上書きされます。
時間のかかるツールの進捗
グループに対する test_policy、test_policies、run_diagnostics、watch_events は進めながら報告します。進捗を求め(progressToken)、イベントストリームを受け付けるクライアントは、メンバー、ポリシー、ステップ、イベントごとに notifications/progress を 1 つずつ受け取り、その後に結果を受け取ってストリームが閉じます。ほかのクライアントは、ツールが終わったときに結果だけを受け取ります。時間のかかるツールは最長 60 秒で、その時点までの結果を返します。同時にストリームできるのは 4 つまでです。クライアントがストリームを閉じると呼び出しは取り消されますが、送信済みの計測はそのまま完了し、グループも更新されます。
セキュリティ
- トークンは全権です。 持っている人は、あなたの設定、接続履歴、ログを読み、ルーティングを変え、スクリプトを実行できます — しかも HTTPコントロールAPI のトークンでもあります。共有ファイルやスクリーンショットに載せないでください。変えるには
external-http-secretに新しい値を設定します。 - ネットワークで待ち受けると、そのネットワーク上のすべてのデバイスが試せるようになります。通信はプレーンな HTTP なのでトークンは暗号化されずにネットワークを通り、失敗した試行もブロックされません。長いランダムな
external-http-secretを使い、信頼できるネットワークでだけ使い、終わったら127.0.0.1に戻してください。 run_scriptはコードを実行します。 実行できるのは設定に定義された generic スクリプトだけですが、スクリプトがすること — リクエスト、保存、通知 — はすべて、エージェントが求めたときに起こります。設定の書き込みを許されたエージェントは、スクリプトを追加してから実行することもできます。何を変えたかを確認してください。- Web ページは締め出されます。 サーバー自身以外の Web ページの
Originが付いたリクエストは403で拒否され、クロスオリジンのヘッダーも送られないので、あなたが訪れたサイトがブラウザー経由でサーバーに届くことはありません。
本ページは英語版からの翻訳です。内容に相違がある場合は、英語版が優先されます。