telegram_watch_messages

Telegram · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Просит Local MCP сообщать этому сеансу о новых сообщениях в выбранных чатах Telegram, чтобы вам не приходилось постоянно вызывать telegram_read_messages. set требует `account` и `chats`. Local MCP проверяет каждые 300 секунд (доставка "poll"), поэтому уведомление может прийти примерно через 5 минут после сообщения. Каждое уведомление — это сообщение notifications/claude/channel для этого сеанса с platform, account, chat, count, max_id и event_id, но без текста: читайте чат через telegram_read_messages. Уведомление может повторяться: игнорируйте event_id, который уже видели. Наблюдение начинается сейчас; прочитайте чаты один раз, чтобы наверстать пропущенное. Оно заканчивается вместе с этим сеансом. Включить его могут только сборки ИИ-клиентов, сертифицированные для показа таких уведомлений; любой другой получает доставку "unsupported", и ничего не настраивается.

Обязательные входные данные

action

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "account": {
      "description": "Which linked Telegram account to use: its label or id from telegram_list_accounts. Leave it out to use the default account.",
      "type": "string"
    },
    "action": {
      "description": "set: watch these chats for this session; clear: stop; status: what is watched and when it was last checked.",
      "enum": [
        "set",
        "clear",
        "status"
      ],
      "type": "string"
    },
    "chats": {
      "description": "For set: 1 to 20 chat ids from telegram_list_chats of that account (user:… or, with include_groups, chat:…).",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "include_groups": {
      "description": "Allow basic groups (chat:…). Channels are not supported.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Пример для документации

Пример документации для telegram_watch_messages. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{
  "account": "Demo Telegram",
  "action": "set",
  "chats": [
    "user:5550100123"
  ]
}

Windows

Назначение

Обязательные входные данные

action

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "account": {
      "description": "For set: which linked Telegram account to watch, its label or id from telegram_list_accounts. Required: never the default.",
      "type": "string"
    },
    "action": {
      "description": "set: watch these chats for this session; clear: stop; status: what is watched and when it was last checked.",
      "enum": [
        "set",
        "clear",
        "status"
      ],
      "type": "string"
    },
    "chats": {
      "description": "For set: 1 to 20 chat ids from telegram_list_chats of that account (user:… or, with include_groups, chat:…).",
      "items": {
        "type": "string"
      },
      "maxItems": 20,
      "minItems": 1,
      "type": "array"
    },
    "include_groups": {
      "description": "Allow basic groups (chat:…). Channels are not supported.",
      "type": "boolean"
    }
  },
  "required": [
    "action"
  ],
  "type": "object"
}

Пример для документации

{
  "account": "Demo Telegram",
  "action": "set",
  "chats": [
    "user:5550100123"
  ]
}