From 7b0b7ffd1dc79d0afe1fa82a373f5fcb2907a861 Mon Sep 17 00:00:00 2001 From: leemour Date: Wed, 18 Nov 2026 00:38:36 +0100 Subject: [PATCH] docs(configuration): say that over MCP ask runs the change without a question NEED-2731 B keeps ask as a default for changes. In a terminal it waits for the owner. Over MCP the server asks nothing, and the agent writes and deletes at once, unless the AI app shows its own confirmation. The permissions table and the MCP section now say so in EN, RU and ES, with the readonly command that stops it for a profile. Co-Authored-By: Claude Opus 5.5 --- content/docs/configuration.es.mdx | 7 ++++--- content/docs/configuration.mdx | 7 ++++--- content/docs/configuration.ru.mdx | 8 ++++---- 3 files changed, 12 insertions(+), 10 deletions(-) diff --git a/content/docs/configuration.es.mdx b/content/docs/configuration.es.mdx index 8cd18229..ad83fe11 100644 --- a/content/docs/configuration.es.mdx +++ b/content/docs/configuration.es.mdx @@ -131,7 +131,7 @@ Elige qué puede hacer tu agente: leer mensajes, enviar respuestas o cambiar un |---|---| | `deny` | Se rechaza la acción, incluso leer. | | `readonly` | Permite leer, pero no cambiar. | -| `ask` | Un cambio requiere confirmación en el terminal. | +| `ask` | En el terminal, un cambio espera tu confirmación. Por MCP se ejecuta sin preguntar. | | `allow` | Puede ejecutarse sin otra pregunta. | Un rechazo indica que debes revisar acción y ajustes, no que la conexión esté rota. @@ -178,8 +178,9 @@ Las instrucciones están en la seguridad de [Telegram](./tg/security.md) y [MAX] Añade `--permission messages.send=deny` al inicio del servidor para impedir enviar durante ese proceso. No cambia los ajustes guardados. La opción solo endurece: una anulación que aflojaría el nivel -del perfil se rechaza al iniciar, así que para permitir más cambia los permisos del perfil. Por MCP, `ask` no exige un formulario de confirmación en el servidor: la app -controla sus aprobaciones y puede permitir otra llamada sin preguntar. Usa `deny` o `readonly` para impedir cambios. Consulta [la conexión web](./browser-apps.mdx). +del perfil se rechaza al iniciar, así que para permitir más cambia los permisos del perfil. Por MCP, con el nivel `ask` el servidor no pregunta nada, y el agente escribe y borra en el momento. Solo tu app +de IA puede mostrar su propia confirmación. Para que el agente no cambie datos, da al perfil `readonly` o `deny`, +por ejemplo `tg work config set permissions.messages readonly`. Consulta [la conexión web](./browser-apps.mdx). ### Bloquear toda una ejecución en solo lectura diff --git a/content/docs/configuration.mdx b/content/docs/configuration.mdx index d1f89a46..b4b5631a 100644 --- a/content/docs/configuration.mdx +++ b/content/docs/configuration.mdx @@ -131,7 +131,7 @@ Choose which actions your agent may perform: reading messages, sending replies o |---|---| | `deny` | The action is refused, including reading. | | `readonly` | Reading works; changes are refused. | -| `ask` | A change requires confirmation in the terminal. | +| `ask` | In a terminal, a change waits for your confirmation. Over MCP it runs without a question. | | `allow` | The action can run without another question. | A refusal tells you to check the requested action and settings. It does not mean your account @@ -180,8 +180,9 @@ for the commands to manage these controls. Add `--permission messages.send=deny` to the server startup command to refuse sending for that process. Saved settings stay the same. The flag only tightens: an override that would loosen the profile's -level is refused at startup, so to allow more, change the profile's permissions. Over MCP, `ask` does not require a confirmation form on the server: the app controls -its own approvals and may allow a call without asking again. Use `deny` or `readonly` to refuse changes. [Browser setup](./browser-apps.mdx) explains the full connection. +level is refused at startup, so to allow more, change the profile's permissions. Over MCP, the server asks nothing at the `ask` level, and the agent writes and deletes at once. Only your AI app +may show its own confirmation. To keep the agent from changing data, give the profile `readonly` or `deny`, for +example `tg work config set permissions.messages readonly`. [Browser setup](./browser-apps.mdx) explains the full connection. ### Lock a whole run to reading diff --git a/content/docs/configuration.ru.mdx b/content/docs/configuration.ru.mdx index 419c64e4..26004c91 100644 --- a/content/docs/configuration.ru.mdx +++ b/content/docs/configuration.ru.mdx @@ -131,7 +131,7 @@ max support bot api get-my-info --json |---|---| | `deny` | Действие запрещено, включая чтение. | | `readonly` | Читать можно, изменять нельзя. | -| `ask` | Изменение требует подтверждения в терминале. | +| `ask` | В терминале изменение ждет вашего подтверждения. Через MCP оно выполняется без вопроса. | | `allow` | Действие может выполниться без нового вопроса. | Отказ означает, что нужно проверить действие и настройки. Это не признак неисправного @@ -178,9 +178,9 @@ max support config set sends_per_hour 30 --bot Добавьте `--permission messages.send=deny` к запуску сервера, чтобы запретить отправку этому процессу. Сохранённые настройки не меняются. Флаг только ужесточает: переопределение, которое ослабило -бы уровень профиля, отклоняется при запуске, поэтому, чтобы разрешить больше, измените права профиля. Через MCP уровень `ask` не требует формы подтверждения на сервере: -приложение управляет своими подтверждениями и может разрешить вызов без нового вопроса. -Чтобы запретить изменения, используйте `deny` или `readonly`. +бы уровень профиля, отклоняется при запуске, поэтому, чтобы разрешить больше, измените права профиля. Через MCP при уровне `ask` сервер ничего не спрашивает, и агент сразу выполняет запись и удаление. +Подтверждение может показать только само AI-приложение. Чтобы агент не менял данные, задайте профилю +`readonly` или `deny`, например `tg work config set permissions.messages readonly`. [Настройка браузера](./browser-apps.mdx) объясняет подключение целиком. ### Запретить изменения на весь запуск