cx-viewer 1.0.0

package/concepts/ru/Tool-TaskStop.md

@@ -0,0 +1,32 @@
+# TaskStop
+
+## Определение
+
+Останавливает работающую фоновую задачу.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `task_id` | string | Нет | ID фоновой задачи для остановки |
+| `shell_id` | string | Нет | Устарел, используйте `task_id` вместо этого |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Завершение долго работающей задачи, которая больше не нужна
+- Отмена ошибочно запущенной фоновой задачи
+
+## Примечания
+
+- Возвращает статус успеха или неудачи
+- Параметр `shell_id` устарел, следует использовать `task_id`
+
+## Оригинальный текст
+
+<textarea readonly>
+- Stops a running background task by its ID
+- Takes a task_id parameter identifying the task to stop
+- Returns a success or failure status
+- Use this tool when you need to terminate a long-running task
+</textarea>

package/concepts/ru/Tool-TaskUpdate.md

@@ -0,0 +1,123 @@
+# TaskUpdate
+
+## Определение
+
+Обновляет статус, содержимое или зависимости задачи в списке задач.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `taskId` | string | Да | ID задачи для обновления |
+| `status` | enum | Нет | Новый статус: `pending` / `in_progress` / `completed` / `deleted` |
+| `subject` | string | Нет | Новый заголовок |
+| `description` | string | Нет | Новое описание |
+| `activeForm` | string | Нет | Текст в настоящем продолженном времени, отображаемый во время выполнения |
+| `owner` | string | Нет | Новый ответственный за задачу (имя агента) |
+| `metadata` | object | Нет | Метаданные для слияния (установка в null удаляет ключ) |
+| `addBlocks` | string[] | Нет | Список ID задач, заблокированных этой задачей |
+| `addBlockedBy` | string[] | Нет | Список ID предшествующих задач, блокирующих эту задачу |
+
+## Переход статусов
+
+```
+pending → in_progress → completed
+```
+
+`deleted` может быть установлен из любого статуса, безвозвратно удаляет задачу.
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Пометка задачи как `in_progress` при начале работы
+- Пометка задачи как `completed` после завершения работы
+- Установка зависимостей между задачами
+- Обновление содержимого задачи при изменении требований
+
+**Важные правила:**
+- Помечайте как `completed` только при полном завершении задачи
+- При ошибках или блокировках сохраняйте статус `in_progress`
+- Не помечайте как `completed`, когда тесты не проходят, реализация неполная или возникли неразрешённые ошибки
+
+## Примечания
+
+- Перед обновлением следует получить актуальное состояние задачи через TaskGet, чтобы избежать устаревших данных
+- После завершения задачи вызовите TaskList для поиска следующей доступной задачи
+
+## Оригинальный текст
+
+<textarea readonly>Use this tool to update a task in the task list.
+
+## When to Use This Tool
+
+**Mark tasks as resolved:**
+- When you have completed the work described in a task
+- When a task is no longer needed or has been superseded
+- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
+- After resolving, call TaskList to find your next task
+
+- ONLY mark a task as completed when you have FULLY accomplished it
+- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
+- When blocked, create a new task describing what needs to be resolved
+- Never mark a task as completed if:
+  - Tests are failing
+  - Implementation is partial
+  - You encountered unresolved errors
+  - You couldn't find necessary files or dependencies
+
+**Delete tasks:**
+- When a task is no longer relevant or was created in error
+- Setting status to `deleted` permanently removes the task
+
+**Update task details:**
+- When requirements change or become clearer
+- When establishing dependencies between tasks
+
+## Fields You Can Update
+
+- **status**: The task status (see Status Workflow below)
+- **subject**: Change the task title (imperative form, e.g., "Run tests")
+- **description**: Change the task description
+- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
+- **owner**: Change the task owner (agent name)
+- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
+- **addBlocks**: Mark tasks that cannot start until this one completes
+- **addBlockedBy**: Mark tasks that must complete before this one can start
+
+## Status Workflow
+
+Status progresses: `pending` → `in_progress` → `completed`
+
+Use `deleted` to permanently remove a task.
+
+## Staleness
+
+Make sure to read a task's latest state using `TaskGet` before updating it.
+
+## Examples
+
+Mark task as in progress when starting work:
+```json
+{"taskId": "1", "status": "in_progress"}
+```
+
+Mark task as completed after finishing work:
+```json
+{"taskId": "1", "status": "completed"}
+```
+
+Delete a task:
+```json
+{"taskId": "1", "status": "deleted"}
+```
+
+Claim a task by setting owner:
+```json
+{"taskId": "1", "owner": "my-name"}
+```
+
+Set up task dependencies:
+```json
+{"taskId": "2", "addBlockedBy": ["1"]}
+```
+</textarea>

package/concepts/ru/Tool-TeamCreate.md

@@ -0,0 +1,38 @@
+# TeamCreate
+
+## Определение
+
+Создаёт новую команду для координации нескольких агентов, работающих над проектом. Команды обеспечивают параллельное выполнение задач через общий список задач и межагентный обмен сообщениями.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|----------|-----|--------------|----------|
+| `team_name` | string | Да | Название новой команды |
+| `description` | string | Нет | Описание / назначение команды |
+| `agent_type` | string | Нет | Тип / роль руководителя команды |
+
+## Что создаётся
+
+- **Файл конфигурации команды**: `~/.claude/teams/{team-name}/config.json` — хранит список участников и метаданные
+- **Каталог списка задач**: `~/.claude/tasks/{team-name}/` — общий список задач для всех участников команды
+
+Команды имеют соответствие 1:1 со списками задач.
+
+## Рабочий процесс команды
+
+1. **TeamCreate** — создать команду и её список задач
+2. **TaskCreate** — определить задачи для команды
+3. **Agent** (с `team_name` + `name`) — запустить участников, вступающих в команду
+4. **TaskUpdate** — назначить задачи участникам через `owner`
+5. Участники работают над задачами и общаются через **SendMessage**
+6. Завершить работу участников, затем **TeamDelete** для очистки
+
+## Связанные инструменты
+
+| Инструмент | Назначение |
+|------------|------------|
+| `TeamDelete` | Удалить команду и каталоги задач |
+| `SendMessage` | Межагентное взаимодействие внутри команды |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
+| `Agent` | Запустить участников, вступающих в команду |

package/concepts/ru/Tool-TeamDelete.md

@@ -0,0 +1,30 @@
+# TeamDelete
+
+## Определение
+
+Удаляет команду и связанные каталоги задач после завершения работы в рамках многоагентного взаимодействия. Является операцией очистки, обратной по отношению к TeamCreate.
+
+## Поведение
+
+- Удаляет каталог команды: `~/.claude/teams/{team-name}/`
+- Удаляет каталог списка задач: `~/.claude/tasks/{team-name}/`
+- Очищает контекст команды из текущей сессии
+
+**Важно**: TeamDelete завершится ошибкой, если в команде ещё есть активные участники. Сначала необходимо корректно завершить работу всех участников через запросы shutdown в SendMessage.
+
+## Типичное использование
+
+TeamDelete вызывается в конце рабочего процесса команды:
+
+1. Все задачи выполнены
+2. Участники завершают работу через `SendMessage` с `shutdown_request`
+3. **TeamDelete** удаляет каталоги команды и задач
+
+## Связанные инструменты
+
+| Инструмент | Назначение |
+|------------|------------|
+| `TeamCreate` | Создать новую команду и её список задач |
+| `SendMessage` | Взаимодействие с участниками команды / отправка запросов shutdown |
+| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Управление общим списком задач |
+| `Agent` | Запустить участников, вступающих в команду |

package/concepts/ru/Tool-WebFetch.md

@@ -0,0 +1,55 @@
+# WebFetch
+
+## Определение
+
+Получает содержимое веб-страницы по указанному URL, конвертирует HTML в markdown и обрабатывает содержимое с помощью AI-модели согласно prompt.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `url` | string (URI) | Да | Полный URL для получения |
+| `prompt` | string | Да | Описание информации для извлечения со страницы |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Получение содержимого публичных веб-страниц
+- Просмотр онлайн-документации
+- Извлечение определённой информации с веб-страниц
+
+**Неподходящее применение:**
+- URL, требующие аутентификации (Google Docs, Confluence, Jira, GitHub и т.д.) — сначала поищите специализированный инструмент MCP
+- URL GitHub — предпочитайте использование `gh` CLI
+
+## Примечания
+
+- URL должен быть полным, валидным URL
+- HTTP автоматически обновляется до HTTPS
+- Слишком большое содержимое может быть сокращено
+- Включает 15-минутный самоочищающийся кеш
+- Когда URL перенаправляет на другой хост, инструмент возвращает URL перенаправления — необходимо повторить запрос с новым URL
+- Если доступен инструмент web fetch, предоставляемый MCP, предпочитайте его использование
+
+## Оригинальный текст
+
+<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
+
+- Fetches content from a specified URL and processes it using an AI model
+- Takes a URL and a prompt as input
+- Fetches the URL content, converts HTML to markdown
+- Processes the content with the prompt using a small, fast model
+- Returns the model's response about the content
+- Use this tool when you need to retrieve and analyze web content
+
+Usage notes:
+  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
+  - The URL must be a fully-formed valid URL
+  - HTTP URLs will be automatically upgraded to HTTPS
+  - The prompt should describe what information you want to extract from the page
+  - This tool is read-only and does not modify any files
+  - Results may be summarized if the content is very large
+  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
+  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
+  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
+</textarea>

package/concepts/ru/Tool-WebSearch.md

@@ -0,0 +1,58 @@
+# WebSearch
+
+## Определение
+
+Выполняет запрос к поисковой системе, возвращая результаты поиска для получения актуальной информации.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `query` | string | Да | Поисковый запрос (минимум 2 символа) |
+| `allowed_domains` | string[] | Нет | Включать только результаты с этих доменов |
+| `blocked_domains` | string[] | Нет | Исключать результаты с этих доменов |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Получение актуальной информации за пределами даты отсечки знаний модели
+- Поиск текущих событий и последних данных
+- Поиск новейшей технической документации
+
+## Примечания
+
+- Результаты поиска возвращаются в формате гиперссылок markdown
+- После использования необходимо добавить раздел "Sources:" в конце ответа со списком соответствующих URL
+- Поддерживает фильтрацию доменов (включение/исключение)
+- В поисковых запросах следует использовать текущий год
+- Доступно только в США
+
+## Оригинальный текст
+
+<textarea readonly>
+- Allows Claude to search the web and use the results to inform responses
+- Provides up-to-date information for current events and recent data
+- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
+- Use this tool for accessing information beyond Claude's knowledge cutoff
+- Searches are performed automatically within a single API call
+
+CRITICAL REQUIREMENT - You MUST follow this:
+  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
+  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
+  - This is MANDATORY - never skip including sources in your response
+  - Example format:
+
+    [Your answer here]
+
+    Sources:
+    - [Source Title 1](https://example.com/1)
+    - [Source Title 2](https://example.com/2)
+
+Usage notes:
+  - Domain filtering is supported to include or block specific websites
+  - Web search is only available in the US
+
+IMPORTANT - Use the correct year in search queries:
+  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
+  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
+</textarea>

package/concepts/ru/Tool-Write.md

@@ -0,0 +1,39 @@
+# Write
+
+## Определение
+
+Записывает содержимое в локальную файловую систему. Если файл уже существует, перезаписывает его.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `file_path` | string | Да | Абсолютный путь к файлу (должен быть абсолютным) |
+| `content` | string | Да | Содержимое для записи |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Создание новых файлов
+- Когда требуется полная перезапись содержимого файла
+
+**Неподходящее применение:**
+- Модификация локального содержимого файла — следует использовать Edit
+- Не следует проактивно создавать файлы документации (*.md) или README, если пользователь явно не просит
+
+## Примечания
+
+- Если целевой файл уже существует, его необходимо сначала прочитать через Read, иначе операция завершится ошибкой
+- Перезаписывает всё содержимое существующего файла
+- Предпочитайте Edit для редактирования существующих файлов, Write предназначен только для создания новых файлов или полной перезаписи
+
+## Оригинальный текст
+
+<textarea readonly>Writes a file to the local filesystem.
+
+Usage:
+- This tool will overwrite the existing file if there is one at the provided path.
+- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
+- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
+- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
+- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>

package/concepts/ru/Tool-executeCode.md

@@ -0,0 +1,41 @@
+# executeCode (mcp__ide__executeCode)
+
+## Определение
+
+Выполняет код Python в ядре Jupyter текущего файла notebook.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `code` | string | Да | Код Python для выполнения |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Выполнение кода в среде Jupyter notebook
+- Тестирование фрагментов кода
+- Анализ данных и вычисления
+
+**Неподходящее применение:**
+- Выполнение кода вне среды Jupyter — следует использовать Bash
+- Модификация файлов — следует использовать Edit или Write
+
+## Примечания
+
+- Это инструмент MCP (Model Context Protocol), предоставляемый интеграцией с IDE
+- Код выполняется в текущем ядре Jupyter, состояние сохраняется между вызовами
+- Если пользователь явно не просит, следует избегать объявления переменных или изменения состояния ядра
+- После перезапуска ядра состояние теряется
+
+## Оригинальный текст
+
+<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
+    
+    All code will be executed in the current Jupyter kernel.
+    
+    Avoid declaring variables or modifying the state of the kernel unless the user
+    explicitly asks for it.
+    
+    Any code executed will persist across calls to this tool, unless the kernel
+    has been restarted.</textarea>

package/concepts/ru/Tool-getDiagnostics.md

@@ -0,0 +1,32 @@
+# getDiagnostics (mcp__ide__getDiagnostics)
+
+## Определение
+
+Получает диагностическую информацию языка из VS Code, включая синтаксические ошибки, ошибки типов, предупреждения lint и т.д.
+
+## Параметры
+
+| Параметр | Тип | Обязательный | Описание |
+|------|------|------|------|
+| `uri` | string | Нет | URI файла. Если не указан, получает диагностику всех файлов |
+
+## Сценарии использования
+
+**Подходящее применение:**
+- Проверка семантических проблем кода: синтаксис, типы, lint и т.д.
+- Верификация после редактирования кода на предмет новых ошибок
+- Замена команд Bash для проверки качества кода
+
+**Неподходящее применение:**
+- Запуск тестов — следует использовать Bash
+- Проверка ошибок времени выполнения — следует использовать Bash для выполнения кода
+
+## Примечания
+
+- Это инструмент MCP (Model Context Protocol), предоставляемый интеграцией с IDE
+- Доступен только в среде VS Code / IDE
+- Предпочитайте использование этого инструмента вместо команд Bash для проверки проблем с кодом
+
+## Оригинальный текст
+
+<textarea readonly>Get language diagnostics from VS Code</textarea>

package/concepts/ru/Tools.md

@@ -0,0 +1,67 @@
+# Обзор инструментов Claude Code
+
+Claude Code предоставляет модели набор встроенных инструментов через механизм tool_use API Anthropic. Массив `tools` в каждом запросе MainAgent содержит полные определения JSON Schema этих инструментов, а модель вызывает их в ответе через блоки content `tool_use`.
+
+Ниже приведён категоризированный индекс всех инструментов.
+
+## Система агентов
+
+| Инструмент | Назначение |
+|------|------|
+| [Task](Tool-Task.md) | Запуск суб-агента (SubAgent) для обработки сложных многоэтапных задач |
+| [TaskOutput](Tool-TaskOutput.md) | Получение результата фоновой задачи |
+| [TaskStop](Tool-TaskStop.md) | Остановка работающей фоновой задачи |
+| [TaskCreate](Tool-TaskCreate.md) | Создание записи в структурированном списке задач |
+| [TaskGet](Tool-TaskGet.md) | Получение деталей задачи |
+| [TaskUpdate](Tool-TaskUpdate.md) | Обновление статуса задачи, зависимостей и т.д. |
+| [TaskList](Tool-TaskList.md) | Отображение списка всех задач |
+
+## Операции с файлами
+
+| Инструмент | Назначение |
+|------|------|
+| [Read](Tool-Read.md) | Чтение содержимого файла (поддержка текста, изображений, PDF, Jupyter notebook) |
+| [Edit](Tool-Edit.md) | Редактирование файла через точную замену строк |
+| [Write](Tool-Write.md) | Запись или перезапись файла |
+| [NotebookEdit](Tool-NotebookEdit.md) | Редактирование ячеек Jupyter notebook |
+
+## Поиск
+
+| Инструмент | Назначение |
+|------|------|
+| [Glob](Tool-Glob.md) | Поиск файлов по шаблону имени |
+| [Grep](Tool-Grep.md) | Поиск по содержимому файлов на основе ripgrep |
+
+## Терминал
+
+| Инструмент | Назначение |
+|------|------|
+| [Bash](Tool-Bash.md) | Выполнение команд shell |
+
+## Web
+
+| Инструмент | Назначение |
+|------|------|
+| [WebFetch](Tool-WebFetch.md) | Получение содержимого веб-страниц и обработка с помощью AI |
+| [WebSearch](Tool-WebSearch.md) | Запросы к поисковой системе |
+
+## Планирование и взаимодействие
+
+| Инструмент | Назначение |
+|------|------|
+| [EnterPlanMode](Tool-EnterPlanMode.md) | Вход в режим планирования, проектирование плана реализации |
+| [ExitPlanMode](Tool-ExitPlanMode.md) | Выход из режима планирования и отправка плана на утверждение пользователю |
+| [AskUserQuestion](Tool-AskUserQuestion.md) | Задать вопрос пользователю для уточнения или принятия решения |
+
+## Расширения
+
+| Инструмент | Назначение |
+|------|------|
+| [Skill](Tool-Skill.md) | Выполнение навыка (slash command) |
+
+## Интеграция с IDE
+
+| Инструмент | Назначение |
+|------|------|
+| [getDiagnostics](Tool-getDiagnostics.md) | Получение диагностической информации языка из VS Code |
+| [executeCode](Tool-executeCode.md) | Выполнение кода в ядре Jupyter |

package/concepts/ru/ToolsFirst.md

@@ -0,0 +1,77 @@
+# Почему Tools перечислены первыми?
+
+В панели Context в cc-viewer **Tools отображаются раньше System Prompt и Messages**. Этот порядок точно отражает **последовательность префикса KV-Cache API Anthropic**.
+
+## Последовательность префикса KV-Cache
+
+Когда API Anthropic формирует KV-Cache, он объединяет контекст в префикс в следующем **фиксированном порядке**:
+
+```
+┌─────────────────────────────────────────────────┐
+│ 1. Tools (JSON Schema definitions)               │  ← Start of cache prefix
+│ 2. System Prompt                                 │
+│ 3. Messages (conversation history + current turn)│  ← End of cache prefix
+└─────────────────────────────────────────────────┘
+```
+
+Это означает, что **Tools находятся перед System Prompt, в самом начале префикса кэша**.
+
+## Почему Tools имеют больший вес в кэше, чем System?
+
+При сопоставлении префиксов KV-Cache **более ранний контент является более критичным** — любое изменение делает недействительным всё, что следует после:
+
+1. **Сопоставление префикса начинается с самого начала**: KV-Cache сравнивает текущий запрос с кэшированным префиксом token за token с начала. Как только обнаруживается несоответствие, весь последующий контент становится недействительным.
+
+2. **Изменение Tools = весь кэш недействителен**: Поскольку Tools стоят первыми, любое изменение определений tool (даже добавление или удаление одного MCP tool) **нарушает префикс с самого начала**, делая недействительными все кэшированные System Prompt и Messages.
+
+3. **Изменение System = кэш Messages недействителен**: System Prompt находится посередине, поэтому его изменения делают недействительной только следующую за ним часть Messages.
+
+4. **Изменение Messages = затронут только хвост**: Messages находятся в конце, поэтому добавление новых messages делает недействительным лишь небольшой хвостовой сегмент — кэши Tools и System остаются нетронутыми.
+
+## Практическое влияние
+
+| Тип изменения | Влияние на кэш | Типичный сценарий |
+|-------------|-------------|-----------------|
+| Tool добавлен/удалён | **Полная инвалидация** | Подключение/отключение сервера MCP, включение/выключение плагина IDE |
+| Изменение System Prompt | Кэш Messages утерян | Редактирование CLAUDE.md, внедрение system reminder |
+| Добавлено новое message | Только хвостовой инкремент | Обычный ход разговора (самый частый, самый дешёвый) |
+
+Вот почему `tools_change` в [CacheRebuild](CacheRebuild.md) как правило является наиболее дорогостоящей причиной перестройки — она нарушает цепочку префикса с самого начала.
+
+## Почему определения инструментов размещаются перед «мозгом»?
+
+С точки зрения кэширования, размещение Tools на первом месте — это технический факт. Но с точки зрения когнитивного дизайна этот порядок также логичен — **Tools — это руки и ноги, System Prompt — это мозг**.
+
+Перед тем как действовать, человеку нужно осознать, какие конечности и инструменты ему доступны. Младенец не сначала понимает правила мира (System), а потом учится хватать — он сначала ощущает, что у него есть руки и ноги, а затем постепенно понимает правила через взаимодействие с окружающей средой. Аналогично, LLM должна знать, какие инструменты она может вызвать (чтение файлов, написание кода, поиск, выполнение команд) до получения инструкций (System Prompt), чтобы точно оценить «что я могу сделать» и «как мне это сделать» при обработке инструкций.
+
+Если бы порядок был обратным — сначала сказать модели «твоя задача — рефакторить этот модуль», потом «у тебя есть инструменты Read, Edit, Bash» — модели не хватало бы критической информации о границах своих возможностей при понимании задачи, что могло бы привести к нереалистичным планам или упущению доступных подходов.
+
+**Узнай, какие карты на руках, прежде чем решать, как играть.** Это когнитивная логика размещения Tools перед System.
+
+## Почему инструменты MCP тоже находятся на этой позиции?
+
+Инструменты MCP (Model Context Protocol), как и встроенные инструменты, размещаются в самом начале области Tools. Понимание позиции MCP в контексте помогает оценить его реальные преимущества и издержки.
+
+### Преимущества MCP
+
+- **Расширение возможностей**: MCP позволяет моделям обращаться к внешним сервисам (запросы к базам данных, API-вызовы, операции IDE, управление браузером и т.д.), выходя за границы встроенных инструментов
+- **Открытая экосистема**: Любой может реализовать MCP-сервер; модель получает новые возможности без переобучения
+- **Загрузка по требованию**: MCP-серверы можно подключать/отключать выборочно в зависимости от задачи, гибко составляя наборы инструментов
+
+### Издержки MCP
+
+- **Убийца кэша**: JSON Schema каждого MCP-инструмента конкатенируется в самое начало префикса KV-Cache. Добавление или удаление одного MCP-инструмента = **весь кэш инвалидируется с самого начала**. Частое подключение/отключение MCP-серверов резко снижает процент попаданий в кэш
+- **Раздувание префикса**: Schemas MCP-инструментов обычно больше встроенных (подробные описания параметров, перечисления и т.д.). Большое количество MCP-инструментов значительно увеличивает количество токенов в области Tools, сокращая пространство контекста для Messages
+- **Накладные расходы на задержку**: Вызовы MCP-инструментов требуют межпроцессного взаимодействия (JSON-RPC через stdio/SSE), на порядок медленнее вызовов встроенных функций
+- **Риск стабильности**: MCP-серверы — это внешние процессы, которые могут аварийно завершиться, вызвать таймаут или вернуть неожиданный формат, требуя дополнительной обработки ошибок
+
+### Практические рекомендации
+
+| Сценарий | Рекомендация |
+|----------|-------------|
+| Длинные разговоры, частое взаимодействие | Минимизировать количество MCP-инструментов для защиты стабильности префикса кэша |
+| Короткие задачи, разовые операции | Свободно использовать MCP-инструменты; влияние на кэш ограничено |
+| Частое добавление/удаление MCP-серверов | Каждое изменение вызывает полную перестройку кэша; рассмотреть фиксацию набора инструментов |
+| Слишком большие Tool Schemas | Сократить описания и enum для уменьшения расхода токенов префикса |
+
+В панели Context cc-viewer инструменты MCP отображаются рядом со встроенными инструментами в области Tools, давая наглядное представление о размере Schema каждого инструмента и его вкладе в префикс кэша.