deep-research MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

One-shot deep research tool — no manual step orchestration
Bring-your-own-model: works with Gemini, OpenAI, Anthropic, Deepseek, xAI, Mistral, Azure, OpenRouter, Ollama, Pollinations
Pluggable search backend: Tavily, Firecrawl, Exa, Bocha, Brave, or model-native search
Streamable HTTP and SSE MCP transports
Optional ACCESS_PASSWORD header for shared deployments

Живое демо

Как выглядит на практике

deep-research.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "deep-research": {
      "command": "npx",
      "args": [
        "-y",
        "deep-research"
      ],
      "_inferred": true
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "deep-research": {
      "command": "npx",
      "args": [
        "-y",
        "deep-research"
      ],
      "_inferred": true
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "deep-research": {
      "command": "npx",
      "args": [
        "-y",
        "deep-research"
      ],
      "_inferred": true
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "deep-research": {
      "command": "npx",
      "args": [
        "-y",
        "deep-research"
      ],
      "_inferred": true
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "deep-research",
      "command": "npx",
      "args": [
        "-y",
        "deep-research"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "deep-research": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "deep-research"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add deep-research -- npx -y deep-research

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: deep-research

How to produce a competitor market scan in 2 minutes

👤 Founders, PMs, strategy analysts ⏱ ~10 min beginner

Когда использовать: You need a sourced landscape of a space (say, 'open-source vector DBs') and a blank doc is staring at you.

Предварительные требования

An LLM API key (MCP_AI_PROVIDER + provider key) — Get a Gemini key at aistudio.google.com or an OpenAI key at platform.openai.com
Optional search key (Tavily or Firecrawl) — tavily.com or firecrawl.dev — free tier is enough for a few reports

Поток

Call the research tool with a focused topic

Run deep research on 'managed vector databases for RAG: pricing, ingestion scale, and hybrid search support as of 2026'. Target 1500 words, include citations.✓ Скопировано

→ Long-running call returns a structured report with links
Ask for a comparison table

From the report, produce a markdown table: provider | free tier | max vectors | hybrid search | notes.✓ Скопировано

→ Clean table you can paste anywhere
Drill into one competitor

Run a second deep research pass focused only on Qdrant's pricing changes since 2024.✓ Скопировано

→ Tighter, more specific report

Итог: A 1-2k word cited briefing you can send to leadership same-day.

Подводные камни

Default 2-minute timeout on some MCP clients kills the call — Raise client timeout to 600s — this is a long-running tool
Citations can hallucinate if search provider returns nothing — Use Tavily or Firecrawl rather than model-native search for higher grounding

Сочетать с: firecrawl · notion

How to produce a technical decision memo with sources

👤 Staff engineers, architects ⏱ ~15 min intermediate

Когда использовать: You have to pick between two technologies and need a defensible write-up.

Поток

Frame the question sharply

Deep research: 'Should a Rails 7 monolith migrate to sidekiq-pro or to a dedicated Go worker service in 2026?' — weigh ops cost, failure modes, community support. Return 1200 words with citations.✓ Скопировано

→ Sourced memo with pros/cons per option
Ask for the contrarian take

Now rebut the memo — what would a skeptic say?✓ Скопировано

→ Counter-arguments grounded in the sources

Итог: A decision memo + counter-memo, ready for an architecture review.

Подводные камни

Report goes stale fast — 2024 info can contradict 2026 reality — Pin queries with 'as of 2026' and re-run before publishing

Сочетать с: notion · github

How to draft a literature review section for a paper

👤 Researchers, grad students ⏱ ~20 min intermediate

Когда использовать: You know the field but want a structured overview + citations to check against.

Поток

Define scope and timespan

Deep research on 'mechanistic interpretability of transformer attention heads 2022-2026'. Organize by theme (circuits, superposition, SAE). Cite arXiv.✓ Скопировано

→ Themed review with arXiv links
Cross-check with paper-search

Use paper-search MCP to find any major papers missing from the report.✓ Скопировано

→ Gap list

Итог: A draft section with sources you still need to verify by reading directly.

Подводные камни

Do not cite what Claude produced without reading the source — Treat output as a starting bibliography — read every paper you cite

Сочетать с: paper-search

Комбинации

Сочетайте с другими MCP — эффект x10

deep-research + firecrawl

Use firecrawl for higher-quality web retrieval before synthesizing

Using firecrawl as the search backend, deep research 'AI coding agents benchmarks Q1 2026'.✓ Скопировано

deep-research + notion

Drop the finished report into a Notion database for team review

After deep research finishes, create a Notion page titled with today's date under 'Research' and paste the full markdown.✓ Скопировано

deep-research + paper-search

Combine web research with arXiv coverage for academic topics

Do a deep research report on constitutional AI, then use paper-search to add any 2025-2026 arXiv papers missing from the sources.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать	Стоимость
deep_research	topic: str, depth?: 'shallow'\|'standard'\|'deep', length_words?: int, language?: str	When you want a sourced report, not a chat reply	Many LLM + search calls — plan for $0.05-$0.50 per report depending on model

Стоимость и лимиты

Во что обходится

Квота API: Bounded by your chosen LLM + search provider quotas
Токенов на вызов: A single report consumes 50k-300k tokens on the thinking model across planning + synthesis
Деньги: Bring-your-own keys — $0.05-$0.50 per report on Gemini Flash; $1-$5 on Claude Opus
Совет: Use a cheap planner + expensive writer split: MCP_TASK_MODEL=gemini-flash, MCP_THINKING_MODEL=claude-sonnet. 3-5x cost savings.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: API keys for the providers you enable

Хранение учётных данных: Env vars (MCP_AI_PROVIDER, provider API keys, search keys, optional ACCESS_PASSWORD)

Исходящий трафик: Your prompts go to whichever LLM provider + search provider you configure; the MCP server itself does not phone home

Никогда не давайте: Production billing keys — use a scoped key with a monthly cap

If you host the server publicly, set ACCESS_PASSWORD — otherwise anyone can burn your API keys.

Устранение неполадок

Частые ошибки и исправления

Client times out at 2 minutes

Raise the MCP client timeout to 600s. This tool is long-running by design.

Missing MCP_AI_PROVIDER

Set MCP_AI_PROVIDER env var to one of: google, openai, anthropic, deepseek, xai, mistral, azure, openrouter, ollama.

Проверить: env | grep MCP_AI_PROVIDER

Search returns nothing / report is hollow

Switch MCP_SEARCH_PROVIDER from 'model' to 'tavily' or 'firecrawl' and supply the key.

401 from ACCESS_PASSWORD-protected server

Add the password to client config as a header: 'Authorization: Bearer <password>'.

Альтернативы

deep-research в сравнении

Альтернатива	Когда использовать	Компромисс
OpenAI Deep Research	You pay for ChatGPT Pro and want zero config	No MCP, no BYO-model, locked to OpenAI
Gemini Deep Research	You use Gemini Advanced already	Same locked-vendor tradeoff
firecrawl MCP	You want raw scraped pages and will synthesize yourself	No autonomous planner; you orchestrate steps

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills