有効にする
全体を止めるスイッチ、エンドポイントが待ち受けるポート、そしてそれをローカルに留める 4 つのこと。
入れたばかりのアプリは、エージェントに何も名乗りません。エージェントアクセスはスイッチ 1 つ先にあり、そのスイッチは、認証の代わりに立つ 3 つの関門の 1 つ目です。全体を止めるスイッチ、範囲ごとの切り替え、そして記録の 3 つです。
スイッチとポート
全体を止めるスイッチは、既定でオフです。エージェントのページで有効にしてください(このページを開くには、ローカルのロールにエージェントを管理する権限が要ります)。すると、エンドポイントが Streamable HTTP で http://127.0.0.1:<port>/mcp を待ち受けます。アプリが通知領域に隠れて動いている間も、エージェントは接続できます。
| 設定 | 何をするか | 受け付ける値 | 既定 |
|---|---|---|---|
| エージェントアクセスを有効にする(MCP) | エンドポイントを開始、または停止します。オフなら、エンドポイントはなく、何も名乗りません。 | オン/オフ | オフ |
| ポート | エンドポイントが待ち受けるローカルのポートです。変えるとエージェントアクセスが再起動し、ページのすべての接続の例もそれに合わせて変わります。 | 1024~65535(範囲の外の値は範囲に収められます) | 18181 |
このページのものはすべて自動で保存されます。保存のボタンはありません。エンドポイントの下の許可の状況の表示は、いくつの機能グループが開いているか、そのうちいくつが実際の設備に書き込めるかを数えるので、このステーションがどれだけ開いているかをひと目で読めます。
エンドポイントを守っているもの
- loopback だけ。ソケットは
127.0.0.1に結び付き、ネットワークのインターフェースには決して結び付きません。プラントネットワークからは届きません。 - ブラウザーからの要求は拒否されます。結び付けだけでは、悪意のある Web ページが自分のドメインを 127.0.0.1 に付け替えるのを止められないので、エンドポイントは、ブラウザーが偽れない 2 つのヘッダーも調べます。
Hostがローカルでない要求と、ローカルでないOriginを運ぶ要求は、セッションを開く前に 403 で拒否されます。この拒否はどれもイベントのエージェントの領域に記録されるので、ブラウザーのタブから探られたステーションは足あとを残します。 - エンドポイントの認証はありません。意図してそうしています。関門は、全体を止めるスイッチ、範囲ごとの切り替え、そして記録です。もしトンネル越しにエンドポイントを公開するなら、認証はそのトンネルの側になければなりません(ChatGPT とそのほかの クラウド経由のクライアントを見てください)。
- ツールの一覧は、有効な範囲そのものです。切れている範囲のツールは、まったく名乗られません。「いいえ」と答えるのではなく、そこにないのです。どれかの切り替えを変えるとエンドポイントが再起動するので、エージェントに見えるものは、いつでも許したものと一致します。