Perplexity Tools

ユーザーが「検索」「見つける」「探す」「質問」「調査」「最新情報」などのキーワードを使用した一般的なクエリの場合のみ使用。ライブラリ/フレームワークドキュメント（Context7を使用）、gt CLI（Graphite MCPを使用）、またはワークスペース質問（Nx MCPを使用）には使用しない。

クイックリファレンス

どのPerplexityツールを使う?

• 検索結果/URLが必要? → Perplexity Search
• 会話形式の回答が必要? → Perplexity Ask
• 深い調査が必要? → Researcher agent (/research <topic>)

Perplexityを使わない - 代わりにこれらを使用:

• ライブラリ/フレームワークドキュメント → Context7 MCP
• Graphite gt CLI → Graphite MCP
• このワークスペース → Nx MCP
• 特定のURL → URL Crawler

Perplexity Search

いつ使う:

• 一般的な検索、リソース探索
• 現在のベストプラクティス、最新情報
• チュートリアル/ブログ記事の発見
• ユーザーが「検索してください」「見つけてください」「探してください」と言う場合

デフォルトパラメータ (必ず使用):

mcp__perplexity__perplexity_search({
  query: "your search query",
  max_results: 3,           // デフォルトは10 - 多すぎます!
  max_tokens_per_page: 512  // 結果ごとのコンテンツを削減
})

制限を増やす場合: 以下の場合のみ:

• ユーザーが明示的に包括的な結果が必要
• 最初の検索で有用な結果が見つからない
• 複雑なトピックは複数のソースが必要

// 制限の増加 (ほどほどに使用)
mcp__perplexity__perplexity_search({
  query: "complex topic",
  max_results: 5,
  max_tokens_per_page: 1024
})

Perplexity Ask

いつ使う:

• 検索結果ではなく会話形式の説明が必要
• ウェブから情報を統合
• 現在のコンテキストで概念を説明

使用方法:

mcp__perplexity__perplexity_ask({
  messages: [
    {
      role: "user",
      content: "Explain how postgres advisory locks work"
    }
  ]
})

以下には使わない:

• ライブラリドキュメント (Context7を使用)
• 深い複数ソースの調査 (researcher agentを使用)

禁止されたツール

絶対に使わない: mcp__perplexity__perplexity_research

代わりに使用: Researcher agent (/research <topic>)

• トークンコスト: 30-50kトークン
• 引用付きの複数ソース統合を提供
• 複雑な質問にのみ慎重に使用

ツール選択フロー

優先順位:

1. Context7 MCP - ライブラリ/フレームワークドキュメント
2. Graphite MCP - gt CLIが言及されている場合
3. Nx MCP - このワークスペースの質問
4. Perplexity Search - 一般的な検索
5. Perplexity Ask - 会話形式の回答
6. Researcher agent - 深い複数ソース調査
7. WebSearch - 最終手段 (Perplexityが完了後)

例

✅ 正しい - Perplexity Searchを使用:

• 「Postgresマイグレーションのベストプラクティスを見つけてください」
• 「Reactテスティングチュートリアルを検索してください」
• 「マイクロサービスの最新トレンドを調べてください」

✅ 正しい - Perplexity Askを使用:

• 「Postgresアドバイザリロックの仕組みを説明してください」
• 「マイクロサービスのトレードオフは何ですか?」

❌ 誤り - Context7を代わりに使用:

• 「Reactフックドキュメントを検索してください」 → Context7 MCP
• 「Next.jsルーティングドキュメントを見つけてください」 → Context7 MCP
• 「Temporal Workflow APIを調べてください」 → Context7 MCP

❌ 誤り - Graphite MCPを代わりに使用:

• 「gt stackコマンドを検索してください」 → Graphite MCP
• 「gt branchワークフローを見つけてください」 → Graphite MCP

❌ 誤り - Nx MCPを代わりに使用:

• 「ビルド設定を検索してください」 (このワークスペース内) → Nx MCP
• 「プロジェクト依存関係を見つけてください」 (このワークスペース内) → Nx MCP

重要なポイント

• デフォルトは結果を制限 - コンテキストオーバーフローを避ける
• ライブラリドキュメント = Context7 - 常にContext7を最初に試す
• "gt" = Graphite MCP - "gt"の言及は常にGraphite MCPを使用
• 深い調査 = /research - perplexity_researchツールではない
• フォールバックチェーン - Search → Ask → WebSearch (最終手段)