Documentation
ドキュメントの検索
karat

+

K

APIリファレンス ↗
Developer toolchainPalantir MCPツール検索

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

ツール検索

Palantir MCP は、ツール検索によるオンデマンドのツール検出をサポートしています。ツール検索が有効な場合、サーバーは起動時にツールカタログ全体ではなく、search_tools という単一のツールを公開します。エージェントは追加のツールを検索したときにのみ有効化するため、コンテキストに読み込まれるツール定義が少なくなり、トークン使用量を削減できます。

ツール検索の仕組み

デフォルトでは、すべてのツールが起動時に読み込まれ、セッション全体を通じて利用可能です。ツール検索が有効な場合、Palantir MCP は search_tools ツールのみを公開して起動します。その後は、次のように動作します。

  1. エージェントに指示を与えると、エージェントはタスクの簡潔な説明を指定して search_tools を呼び出します。
  2. search_tools は、ツール名、カテゴリー、および厳選されたキーワードに基づいて、カタログをローカルで順位付けします。追加のモデル呼び出しやネットワークの往復通信は行いません。その後、最も一致するツールを有効化し、その説明を返します。
  3. エージェントは、有効化されたツールを直接呼び出します。

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

有効化されたツールは、セッションの残りの期間を通じてツールリストとコンテキストに保持されます。サーバーに再接続すると、ツールリストは search_tools のみの状態にリセットされます。

クライアント要件：ツール検索では、新しいツールが有効化されたときに、MCP クライアントが tools/list_changed 通知を使用してツールリストを更新する必要があります。動的に更新しないクライアントでは、新たに有効化されたツールを認識できません。このため、Continue はツール検索を使用しません。

ツール検索を有効にする

ツール検索はオプトイン方式です。デフォルトでは、すべてのツールが起動時に読み込まれます。ツール検索を有効にするには、次のいずれかを行います。

  • サーバーに --tool-search 引数を渡します。または、
  • 環境変数 PALANTIR_MCP_TOOL_SEARCH=true を設定します。

この2つのオプションは同等です。設定に合った方を使用します。

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

Claude Code

claude mcp add で Palantir MCP を追加するときに、--tool-search 引数を渡します。この引数は、claude mcp add ではなく palantir-mcp の引数として、-- 区切り文字の後に指定する必要があります。

Copied!
1
2
3
4
claude mcp add palantir-mcp \
    --scope project \
    -e FOUNDRY_TOKEN=<token> \
    -- npx "-y" "palantir-mcp" "--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=true \
    -- npx "-y" "palantir-mcp" "--foundry-api-url" "https://<your-foundry-hostname>"

エージェント

プロコードのエージェントでは、サーバー設定に --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", "--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!,
  },
};

または、--tool-search 引数を渡す代わりに、env ブロックに PALANTIR_MCP_TOOL_SEARCH: "true" を追加します。