Echolotエディション
直接ダウンロード版とMac App Store版の比較、選び方、エディション間の移行方法。
Echolotには、同じコードから作られた2つのエディションがあります。echolot.devから入手する直接ダウンロード版と、Mac App Store版です。 App Store版はAppleのApp Sandboxの中で動作します。サンドボックス内のアプリは、ネットワークの利用、ユーザが選んだファイルの読み書き、アプリ自身のデータの保持ができます。 一方で、Macで他のプログラムを起動したり、他のアプリのファイルを読み書きしたりすることはできません。以下の違いのほとんどは、この制限によるものです。
App Store版はまだApp Storeで公開されていません。このページでは、そのしくみを説明しています。
各エディションの機能
| 直接ダウンロード版 | Mac App Store | |
|---|---|---|
| すべてのプロトコル：HTTP/1.1、HTTP/2、HTTP/3、GraphQL、gRPC、WebSocket、SSE、Socket.IO、MQTT | ✓ | ✓ |
| ファイルとしてのワークスペース、Git、環境、キーチェーンのシークレット | ✓ | ✓ |
| スクリプト、テスト、ランナー、データ駆動の実行 | ✓ | ✓ |
| 履歴、保存済みのレスポンス、保存時の暗号化 | ✓ | ✓ |
| 仕様、モック、スケジュールとWebhookを使うフロー | ✓ | ✓ |
| 読み込みと書き出し | ✓ | ✓ |
| クイック送信、そのグローバルショートカット、ショートカットのアクション、クイックルック | ✓ | ✓ |
| HTTP経由のMCPサーバ | ✓ | ✓ |
ローカルプログラムとして動くMCPサーバ（stdio：npx、uvx など） | ✓ | ワークスペースには残りますが、起動はしません。コマンドラインツールか直接ダウンロード版を使ってください。 |
| APIキー、Ollamaなどの互換サーバ、Appleのオンデバイスモデルを使うアシスタント | ✓ | ✓ |
| コマンドラインのエージェント（Claude Code、Codex、Gemini CLI）を使うアシスタント | ✓ | ✗ |
| Echoとそのコメント機能（AI） | ✓ | ✓ |
| 外部エージェント向けのEcholotのMCPサーバ | ✓ | ✓（別途インストールするコマンドラインツール経由） |
| 他のアプリの設定からのMCPサーバの読み込み | 自動で検出 | 設定ファイルを自分で選びます。パネルは適切なフォルダで開きます |
| Claude Code、Cursor、VS Code、Codexの接続 | ✓ | ✓（別途インストールするコマンドラインツール経由） |
Claude Desktop拡張機能（.mcpb）、Claudeに追加 | ✓ | ✗ |
| コマンドラインツール | アプリに内蔵。Echolot › コマンドラインツールをインストール… | 単体でインストール（リリースページのzip） |
| アップデート | アプリ内で、Echolot › アップデートを確認… | App Store |
| ベータ版の有効期限 | あり（リリースから30日） | なし（ベータ版はTestFlightで配布） |
ワークスペース外のファイルの扱いも異なります。App Store版のEcholotは、「開く」パネルでユーザが選んだファイルしか読み取れません。
ワークスペースを開いたとき、およびリクエストに使うファイル（ファイルからストリーミングするボディ、フォームの部分、クライアント証明書）を選んだときは、そのつど記憶します。
記憶は再起動後も、ファイルを移動した後も有効です。
リクエストファイルにパスを手で書いた場合など、Echolotに渡されていないファイルが必要な送信は、Echolot is not allowed to read “…”というエラーで失敗します。
失敗したレスポンスでアクセスを許可…を選び、そのファイルを選んでください。
トラブルシューティングも参照してください。
どちらを選ぶか
次のような場合は直接ダウンロード版を選びます。
- ローカルプログラムとして動くMCPサーバを使う（
npx、uvx、docker、バイナリで起動するサーバのほとんど）。 - アシスタントにClaude Code、Codex、Gemini CLIを操作させたい。
- コマンドラインツールをアプリと一緒にインストール・更新したい。または、ワンクリックのClaude Desktop拡張機能を使いたい。
次のような場合はApp Store版を選びます。
- App Storeのアプリを好み、そのアップデートとアプリを囲むサンドボックスを使いたい。
- MCPサーバにHTTPで接続できる。
どちらも同じワークスペースを開けるので、後から変更できます。
エディション間の移行
macOSから見ると、2つのエディションは同じアプリです。そのため、同時にインストールできるのは一方だけです。 使わなくなる方を終了して削除し（アンインストール）、もう一方をインストールします。
- ワークスペースは通常のフォルダなので、どちらのエディションでも開けます。App Store版では、それぞれ1回、ファイル › ワークスペースを開く…またはFinderから開いてください。 これでサンドボックスがEcholotに読み取りを許可します。以降はファイル › 最近使った項目を開くに残ります。
- シークレットはログインキーチェーンに残り、共有されます。もう一方のエディションが、作成していないシークレットを初めて読み取るとき、macOSが項目ごとに1回確認します。 常に許可を選んでください。コマンドラインツールも同じように確認します。
- アシスタントのモデルキーも、もう一方のエディションで1回確認されます。設定 › アシスタントでもう一度追加することもできます。
- 履歴と保存済みのレスポンスは、記録したエディションに残ります。エディションごとに保存先のフォルダが異なります。失われるのは過去のレスポンスだけで、リクエストは失われません。
各エディションのデータの保存先
ワークスペースは、どちらのエディションでも保存した場所にあります。Echolot自身のデータ（保存済みのレスポンスボディ、履歴、クラッシュレポート、アシスタントの会話、サンプルワークスペース）は次の場所にあります。
| エディション | フォルダ |
|---|---|
| 直接ダウンロード版 | ~/Library/Application Support/Echolot |
| Mac App Store | ~/Library/Containers/com.staticdreams.Echolot/Data/Library/Application Support/Echolot |
設定 › 情報 › レスポンスと履歴 › Finderに表示で、該当するフォルダが開きます。このフォルダを削除すると、履歴と保存済みのレスポンスは失われますが、リクエストは失われません。
App Store版のコマンドラインツール
App Storeではアプリの外にコードをインストールできないため、App Store版にはコマンドラインツールが含まれません。ツールは単体でインストールしてください。
リリースページからecholot-<version>-macos.zipをダウンロードします。ツールに有効期限はありません。
コマンドラインツールを参照してください。
次のような場合に必要です。
- ターミナルやCIでワークスペースを実行する。
- ローカルプログラムとして起動するMCPサーバを実行する（
echolot mcp check、echolot mcp serve）。 - Claude Code、Cursor、VS Code、Codexなどの外部エージェントを接続する。これらの設定にはツールの名前が書かれます。ワークスペースがアプリで開いている間、その呼び出しはアプリ内で実行され、そこで承認します。 エージェントを参照してください。