---
title: entherium_search_chat
description: Search the team's WORK-CHAT ARCHIVE for messages on a topic — this is how you gather CONTEXT for a task or defect: who asked for it, in what WORDS, when.
locale: ru
version: 0.2.0
canonical: https://enterium-developer-docs.pages.dev/developers/ru/mcp/tools/entherium_search_chat/
---

> Documentation index: https://enterium-developer-docs.pages.dev/developers/llms.txt — every page of this portal has a Markdown twin at <route>.md; the frozen API contract is at https://enterium-developer-docs.pages.dev/developers/api/openapi.json.

:::note
Сгенерировано из работающего сервера (capability-версия `2026-09-03.1`) — не редактировать руками.

Описание инструмента ниже приводится **на английском** — это дословная строка, которую сервер отдаёт MCP-клиенту; перевод был бы вторым, непроверяемым источником.
:::

Search the team's WORK-CHAT ARCHIVE for messages on a topic — this is how you gather
CONTEXT for a task or defect: who asked for it, in what WORDS, when. Use it BEFORE filing a
task/defect from a chat request, and to clarify the intent of one already filed.
`chat`: "work" = the team work chat (default). `author`: substring of a team member's
display name. Returns {"found": N, "messages": [{at, author, text, is_full, chat}]} — a
message with `is_full: false` is TRUNCATED by the log and MUST NOT be quoted as verbatim.
Requires the global `read_all` capability: this is internal team traffic, not available
to client-scoped tokens.

**Доступ:** только чтение — безопасно вызывать повторно, ничего не меняет

**Доступен на:** `/mcp/`, `/mcp/readonly/`

_Подсказки, объявленные MCP-клиентам (ToolAnnotations)_

| Подсказка | Значение |
| --- | --- |
| `readOnlyHint` | true |
| `destructiveHint` | false |
| `idempotentHint` | true |
| `openWorldHint` | false |

## Параметры

| Имя | Тип | Обязателен | Описание |
| --- | --- | --- | --- |
| `query` | `string` | да | Topic or phrase to look for in the archive |
| `chat` | `string \| null` | нет | Chat alias: work (default) or agents |
| `author` | `string \| null` | нет | Substring of the author's display name |
| `since_days` | `integer \| null` | нет | Only messages from the last N days |
| `limit` | `integer` | нет | Maximum number of messages to return |


## Пример вызова

Отправляется внутри инициализированной MCP-сессии (см. [Подключение](../../connecting/)). Каждый параметр показан типизированной заглушкой; необязательные можно опустить — но для инструментов дефектов/задач именно QA-поля спасают отчёт от карантина.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "entherium_search_chat",
    "arguments": {
      "query": "<query>",
      "chat": "<chat>",
      "author": "<author>",
      "since_days": 1,
      "limit": 1
    }
  }
}
```

## Возвращает

| Поле | Тип | Описание |
| --- | --- | --- |
| `found` | `integer` (необязательно) | Total matches (the page may be shorter) |
| `messages` | `массив object` (необязательно) | Matching messages, newest first |
| `messages[].at` | `string` | ISO-8601 timestamp of the message |
| `messages[].author` | `string \| null` | Author as recorded in the archive |
| `messages[].text` | `string` | Message text; may be truncated when is_full is false |
| `messages[].is_full` | `boolean` | False when the archive holds a truncated copy — do not quote it verbatim |
| `messages[].chat` | `string \| null` | Chat name or id |
| `error` | `string` (необязательно) | Present only when the search could not run (e.g. missing capability) |

## Если не работает

| Симптом | Причина | Действие |
| --- | --- | --- |
| `401` | Токен отсутствует или истёк | Токены выпускает владелец платформы через `POST /api/v1/auth/agent-token` (только суперпользователь) — попросите перевыпуск. ⚠️ Новый токен **заменяет** набор грантов |
| `403` / ошибка capability | У токена нет capability или гранта на контракт | Сначала `my_capabilities`; грант запрашивается у владельца |