ツール検索

Palantir MCP では、ツール検索がデフォルトで有効になっています。サーバーは最初、エージェントのツールリストに search_tools ツールのみを表示します。エージェントは必要に応じて追加のツールを見つけるため、コンテキストに読み込まれるツール定義が少なくなり、トークン使用量が削減されます。

ツール検索の仕組み

search_tools の説明には、セッションで利用可能なツールの機能カテゴリーと例が含まれています。その後は、次のように動作します。

1. エージェントにプロンプトを入力すると、エージェントは view an action type や run a SQL query など、必要な機能の短く具体的な説明を指定して search_tools を呼び出します。
2. search_tools は、ツール名、カテゴリー、厳選されたキーワードに基づいて、セッションのカタログをローカルで順位付けします。順位付けに追加のモデル呼び出しやネットワークリクエストは必要ありません。
3. 検索では、一致するツールの名前、カテゴリー、完全な説明、入力スキーマ、およびその他の利用可能なツールメタデータが返されます。結果を返す前に、一致するツールがエージェントのツールリストに追加され、リストが変更された場合は tools/list_changed 通知が送信されます。
4. エージェントは、返されたスキーマを使用して、一致するツールを呼び出します。

これにより、コンテキストを小さく保てます。エージェントは、数十個のツール定義をあらかじめ読み込む代わりに、タスクに関連するツールのみを読み込みます。

見つかったツールは、セッションが終了するまでツールリストに残ります。新しいセッションを初期化すると、表示されるツールリストは search_tools のみにリセットされます。

ツール検索が制御するのは表示であり、ツールの実行権限ではありません。環境と設定で許可されているすべてのツールは、検索で見つかる前やツールリストが更新される前でも、サーバー上で呼び出すことができます。環境とデータアクセスの制限、明示的に無効化されたツール、入力検証、および権限チェックは引き続き適用されます。

ツール検索の設定

ツール検索を有効にするための追加設定は必要ありません。--tool-search を渡す設定や PALANTIR_MCP_TOOL_SEARCH=true を設定する既存の設定は、引き続きサポートされます。コマンドラインフラグは環境変数よりも優先されます。

ツール検索を無効にする

起動時に許可されたツールカタログ全体を読み込むには、次のいずれかの方法を使用します。

• サーバーに --no-tool-search 引数を渡します。
• 環境変数 PALANTIR_MCP_TOOL_SEARCH=false を設定します。

--disable-tools search_tools で search_tools を明示的に無効にした場合も、起動時に許可されたカタログ全体が読み込まれます。ツール検索を無効にしても、環境、データアクセス、権限の制限は変更されません。

以下の例では、<your-foundry-hostname> をお使いの Foundry ホスト名（例：mycompany.palantirfoundry.com）に置き換えます。

Claude Code

claude mcp add で Palantir MCP を追加するときにツール検索を無効にするには、--no-tool-search 引数を渡します。この引数は、palantir-mcp への引数として、-- 区切り文字の後に指定する必要があります。

Copied!
1
2
3
4
claude mcp add palantir-mcp \
    --scope project \
    -e FOUNDRY_TOKEN=<token> \
    -- npx "-y" "palantir-mcp" "--no-tool-search" "--foundry-api-url" "https://<your-foundry-hostname>"

または、環境変数を設定します。

Copied!
1
2
3
4
5
claude mcp add palantir-mcp \
    --scope project \
    -e FOUNDRY_TOKEN=<token> \
    -e PALANTIR_MCP_TOOL_SEARCH=false \
    -- npx "-y" "palantir-mcp" "--foundry-api-url" "https://<your-foundry-hostname>"

Agents

プロコードエージェントの Palantir MCP サーバーでは、ツール検索がデフォルトで有効になっています。カスタムサーバー設定で無効にするには、--no-tool-search 引数を追加します。

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
14
export const PALANTIR_MCP_CONFIGURATION: McpStdioServerConfig = {
  type: "stdio",
  command: "palantir-mcp",
  args: ["start", "--no-tool-search", "code-workspaces"],
  env: {
    FOUNDRY_PROXY_URL: `https://${process.env.FOUNDRY_PROXY_URL!}/`,
    FOUNDRY_SERVICE_DISCOVERY_V2: process.env.FOUNDRY_SERVICE_DISCOVERY_V2!,
    FOUNDRY_EXTERNAL_HOST: "https://<your-foundry-hostname>",
    FOUNDRY_PROXY_TOKEN: process.env.FOUNDRY_PROXY_TOKEN!,
    FOUNDRY_SCOPED_TOKEN: process.env.FOUNDRY_SCOPED_TOKEN!,
    MAESTRO_REPO_RID: process.env.MAESTRO_REPO_RID!,
    NODE_EXTRA_CA_CERTS: process.env.NODE_EXTRA_CA_CERTS!,
  },
};

または、--no-tool-search 引数を渡す代わりに、env ブロックに PALANTIR_MCP_TOOL_SEARCH: "false" を追加します。リポジトリのアップグレード時に競合を避けるには、エージェントテンプレートのガイダンスに従って、カスタム MCP 設定を専用のファイルに追加します。