MCP サーバー

MCP  は、AI アシスタントが外部ツールを呼び出すために使用するオープン標準です。Streamable HTTP トランスポートに対応した MCP クライアントであれば、どれでも接続できます。アシスタントは、開いているアプリケーションの中で作業します。アシスタントが編集したプロジェクトや開始した実行はキャンバスに表示され、ウィンドウで行った変更はアシスタントからも見えます。

依頼の例をいくつか示します。

~/Projects/Acme/Acme.babel を開き、Acme.exe の動的プロキシとマップファイルの生成を有効にして、難読化を実行し、警告があれば教えてください。

Acme.Core.dll をプロジェクトに追加して Acme.exe にマージし、次の実行のリネームの統計を見せてください。

crash.txt のスタックトレースを Acme.exe.map.xml でデコードし、私のメソッドのうちどれが例外をスローしたのか教えてください。

今後 30 日以内に期限が切れるライセンスと、そのライセンスを持つ顧客を表示してください。

インターフェイスを Copper Night テーマに切り替えて、ダッシュボードのスクリーンショットを撮ってください。

動的プロキシとは何をするものですか。Acme.exe に適している場合は、有効にして理由を説明してください。

サーバーの有効化

サーバーは既定ではオフで、有効にするまで接続を待ち受けません。

変更はすぐに適用されます。「オートメーション サーバーを有効にする」のチェックを外すと、サーバーは停止します。ポートまたはトークンを変更すると、サーバーが再起動し、接続中のクライアントは切断されます。コマンドパレットからは、「MCP: ローカル サーバーを起動（プロジェクトの読み取り/書き込み）」、「MCP: ローカル サーバーを停止」、「MCP: 状態を表示」、「MCP: クライアント構成ファイルを表示」も実行できます。

クライアントの接続

MCP 設定の「クライアント構成」セクションでは、現在のポートとトークンに合わせた構成が生成されます。「構成をコピー」をクリックし、お使いのクライアントの MCP 構成に貼り付けます。

{
  "mcpServers": {
    "babel-obfuscator": {
      "type": "http",
      "url": "http://127.0.0.1:8765/mcp",
      "headers": {
        "X-Babel-Token": "paste-the-token-from-settings-mcp"
      }
    }
  }
}

トークンを必須にしていない場合、headers ブロックは省略されます。「ファイルを表示…」は、実行中のサーバー用に Babel Desktop が書き出した構成ファイルの場所を表示します。

Claude Code の場合は、「Claude Code コマンドをコピー」をクリックし、コピーされたコマンドをターミナルで実行します。

claude mcp add --transport http babel-obfuscator http://127.0.0.1:8765/mcp \
  --header "X-Babel-Token: paste-the-token-from-settings-mcp"

先に Babel Desktop を起動し、次にアシスタントを起動します。接続を確認するには、Babel Desktop のウィンドウのスクリーンショットを撮るようアシスタントに依頼してください。

アシスタントにできること

サーバーは、アプリケーションの機能を MCP ツールとして提供します。ツールは次のように分類されています。

設定名は、プロパティパネルに表示される Babel Obfuscator のオプション名と同じなので、アシスタントは Babel タスクリファレンスを参考にして値を選択できます。ツールの名前を指定する必要はありません。望む結果を伝えれば、アシスタントがツールを選びます。

確認付きの変更

作業内容が失われたり、ファイルが上書きされたりする可能性のある操作は、2 段階で行われます。アシスタントはまず操作を準備し、何が起こるかを説明する提案を受け取ります。たとえば、実行によってどの出力ファイルが置き換えられるか、削除によってどのレコードが消えるかといった内容です。アシスタントは、操作を確定する前に、その提案をユーザーに示して承認を得なければなりません。提案は 2 分で期限切れになり、1 回しか使用できません。提案の作成後にプロジェクト、ファイル、レコードが変更されていた場合、提案は拒否されます。

2 段階の確認の対象となる操作は次のとおりです。

• 新しいプロジェクトの作成、入力の置き換え、ターゲットの削除、グラフと依存関係の編集、実行の開始（obfuscate_start は提案を返します）
• セットアップコマンド：メインアセンブリへのマージ、パブリック難読化、ターゲットの保護レベル
• 拡張機能のインストールとアンインストール、ライセンス管理の接続プロファイルの削除
• ライセンス管理のレコードの作成、編集、失効、削除（licensing_prepare と licensing_confirm）

設定や XML ルールを変更するには、プロジェクトの現在のリビジョンが必要です。これにより、アシスタントが自分の見ていない変更を上書きすることを防ぎます。

難読化の実行

アシスタントが開始した実行は、ウィンドウで開始した実行と何も変わりません。出力は同じ場所に書き出され、進行状況は「アクティビティ」パネルに表示され、どちらの側からでもキャンセルできます。アシスタントは実行が完了するまで obfuscate_status をポーリングし、その後 results_read と results_table で統計を読み取ります。実行中は、プロジェクトを変更できません。

ライセンス管理

ライセンス管理のツールは、ライセンス管理の接続プロファイルに対して、そのプロファイルの API キーのロールと権限で動作します。レコードを作成、編集、削除できるのは、アクセスモードが「ローカル管理」の「ローカル テスト」プロファイルを使用した場合だけです。リモートのプロファイルと読み取り専用のプロファイルは、すべての変更を拒否します。応答からは、ライセンスキー、API キー、トークン、IP アドレスなどのシークレットが除かれます。ダッシュボードのツールは、集計データだけを返します。

ウィンドウに残される操作

次の操作はアシスタントにはできません。ウィンドウでご自身が行う必要があります。

• 資格情報の入力：API キーによるサインインと MCP トークンの生成
• 実行中のパスワード入力の要求への応答と、パスワードで保護されたマップファイルを使ったスタックトレースのデコード
• MCP サーバー自体の起動と停止

Babel ドキュメントツール

サーバーは、いまお読みのこのドキュメントもアシスタントに提供します。仕組みや操作方法を尋ねると、アシスタントは設定を変更する前に、ドキュメントを検索して該当するセクションを読み、参照したページへのリンクを添えて回答します。サーバーが接続中のクライアントにこのように動作するよう指示するため、ツールの名前を指定する必要はありません。

ドキュメントツールは読み取りだけを行い、接続先は https://docs.babelfor.net だけです。検索はお使いのコンピューター上で実行され、質問がドキュメントサイトに送信されることはありません。ツールは検索インデックスと読み取るページをダウンロードします。これらは AI でドキュメントを利用するで説明している公開ファイルと同じものです。

依頼の例をいくつか示します。

XML ルールを使って、ある型をリネームの対象から除外するにはどうすればよいですか。その方法に従って、このプロジェクトのルールを変更してください。

アプリケーションの終了時にフローティングライセンスを解放する方法を、Babel Licensing のドキュメントで検索してください。

スタックデコーダーのページを読んで、リリースビルドにはどのマップファイルが必要かを説明してください。

オフラインでの使用と更新

Babel Desktop は、ダウンロードしたインデックスとページを、ユーザープロファイル内の docs-cache フォルダーに保持します。

• インデックスの変更の確認は、多くても 24 時間に 1 回です。ページは、サイト上で変更された場合にだけ再ダウンロードされます。
• それより早く最新版を取得するには、ドキュメントを更新するようアシスタントに依頼します。ツールはそのために refresh: true を受け付けます。
• ネットワークに接続していない場合、ツールはキャッシュされたコピーから回答し、結果には古い可能性があることを示す印とコピーの日付が付きます。
• 接続に失敗した後や、サイトからエラーが返された後は、ツールは 10 分間キャッシュを使用し、その後でサイトへの接続を再び試みます。

セキュリティ

• サーバーは既定ではオフで、有効にして初めて接続を待ち受けます。
• サーバーは 127.0.0.1 にバインドされるため、ほかのコンピューターからは到達できません。
• 「アクセス トークンを必須にする」がオンの場合、正しい X-Babel-Token ヘッダーのないリクエストはすべて拒否されます。
• リクエストのサイズ、セッション、接続、タイムアウトには制限があり、各リクエストのホストとオリジンが検証されます。
• 任意のコマンド、SQL、URL を実行するツールはありません。
• ドキュメントツールは https://docs.babelfor.net にだけ接続し、リダイレクトには従わず、読み取りだけを行います。

アシスタントは、ユーザーが Babel Desktop で持っているのと同じアクセス権を、プロジェクトとファイルに対して持ちます。プロジェクトの設定を変更し、難読化を実行し、確認を経たうえで出力ファイルを置き換えることができます。アシスタントに自由に試させる場合は、プロジェクトのコピーを渡し、使用しないときはサーバーをオフにしてください。

トラブルシューティング

Babel Licensing Service には専用の MCP サーバーがあり、こちらはサービスの API を使ってリモートで動作します。両者の比較については、AI 連携を参照してください。