MCPサーバー

Perchは、Model Context Protocol（MCP）を通じて外部のシステムに接続できます。これにより、ディスク上のファイルではないデータやツールにもPerchの手が届くようになります。法律データベース、ブラウザ自動化、社内APIなど、MCPに対応しているものなら何でもです。接続したサーバーのツールはPerchの組み込みツールと並んで表示され、モデルはそれらを直接呼び出せます。

デフォルトで付属するもの

Perch Terminal Desktopを初めて起動すると、~/.perch/mcp.jsonに設定ファイルが作成され、二つのサーバーがあらかじめ設定されています：

• CourtListener。判例の検索、出典の照会、判決文の取得、関連する事件の検索、訴訟記録の項目の取得ができる法律リサーチサーバーです。連邦裁判所と州裁判所をカバーするCourtListenerのデータベースに接続します。APIトークンが同梱されているため、初回起動時から設定なしで使えます。
• Playwright。テスト済みのバージョンの@playwright/mcpに固定された、ブラウザ自動化サーバーです。ページの移動、要素のクリック、入力欄への入力、画面に表示されている内容の読み取りといった、Perchのブラウザ操作を支えています。

どちらもインストールや設定は不要です。Perchの起動時に自動で接続されます。

ツールがモデルに提示される仕組み

MCPサーバーが接続すると、Perchはそのツール一覧を読み込み、各ツールをモデル向けの定義に変換します。命名規則はmcp__<serverName>__<toolName>です。たとえばCourtListenerの判例検索はmcp__courtlistener__search_casesとなり、readLocalFileやwebSearchといった組み込みツールと並んで表示されます。

モデルは、これらのツールを組み込みツールと同等に扱います。ほかのツールと同じループの中で呼び出すことができ、結果は、Perchが引用したり、それに基づいて動いたりできる構造化されたコンテンツとして返ってきます。

グローバル設定とフォルダ単位の設定

MCPサーバーは、二つのレベルで設定できます：

• グローバル。~/.perch/mcp.jsonのファイルは、あなたのマシン上のすべてのPerchセッションに適用されます。デフォルトのサーバーは、ここで設定されています。
• フォルダ単位。ワークスペースフォルダ内の.perch/mcp.jsonファイルは、そのフォルダで作業しているときだけ適用されます。フォルダの設定はサーバー名ごとにグローバル設定を上書きするため、特定のプロジェクトでは、グローバルなサーバーを別のものに置き換えられます。

環境変数の展開に対応しています。サーバーにAPIキーが必要な場合は、設定内で${YOUR_API_KEY}のように参照すれば、Perchがあなたの環境変数から展開します。

独自のサーバーを追加する

MCPサーバーを追加するには、~/.perch/mcp.json（グローバル用）またはワークスペースフォルダ内の.perch/mcp.json（特定のプロジェクト用）を編集します。構造は次のとおりです：

{
  "servers": {
    "my-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@some-org/some-mcp-server"],
      "env": {
        "API_KEY": "${MY_API_KEY}"
      }
    }
  }
}

三種類のトランスポートに対応しています：

• stdio。ローカルプロセスを実行します。commandが必須で、argsとenvは任意です。
• http。リモートのHTTPエンドポイントに接続します。urlが必須で、headersは任意です。
• sse。リモートのSSEエンドポイントに接続します。urlが必須で、headersは任意です。

設定を編集したら、Perchを再起動するか、再接続コマンドを実行してください。新しいサーバーは次回の起動時に接続されます。

MCPの位置づけ

MCPは、フォルダ内のファイルとして表現できない、稼働中のシステムのためのものです。データがスプレッドシート、PDF、CSVとしてすでにディスク上にあるなら、Perchはフォルダブリッジを通じてそれを直接読み込みます。MCPはそれ以外のすべて、つまり実行中のプロセスや認証を必要とする外部データベース、API、サービスのためのものです。

オペレーターとエージェント→

Perchがチャットを超えて、ファイルを読み、分析を実行し、ワーカーを連携させる仕組み。

セキュリティとデータ→

Perchがあなたのファイルとデータをどう扱い、何がデバイスの外で処理されるか。