telegram_watch_messages

Telegram · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Pide a Local MCP que avise a esta sesión cuando lleguen mensajes nuevos a los chats de Telegram elegidos, para que no tengas que llamar una y otra vez a telegram_read_messages. set necesita `account` y `chats`. Local MCP comprueba cada 300 segundos (delivery "poll"), así que un aviso puede llegar unos 5 minutos después del mensaje. Cada aviso es un mensaje notifications/claude/channel para esta sesión con platform, account, chat, count, max_id y event_id, nunca el texto: lee el chat con telegram_read_messages. Un aviso puede repetirse: ignora un event_id que ya viste. La vigilancia empieza ahora; lee los chats una vez para ponerte al día. Termina con esta sesión. Solo los clientes de IA certificados para mostrar estos avisos pueden activarlo; cualquier otro recibe delivery "unsupported" y no se configura nada.

Entradas obligatorias

action

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para telegram_watch_messages. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows