telegram_watch_messages

Telegram · macOS · Windows

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Pede ao Local MCP que avise esta sessão quando chegarem novas mensagens nas conversas do Telegram escolhidas, para que você não precise chamar telegram_read_messages o tempo todo. set exige `account` e `chats`. O Local MCP verifica a cada 300 segundos (entrega "poll"), então um aviso pode chegar cerca de 5 minutos depois da mensagem. Cada aviso é uma mensagem notifications/claude/channel para esta sessão com platform, account, chat, count, max_id e event_id, nunca o texto: leia a conversa com telegram_read_messages. Um aviso pode se repetir: ignore um event_id que você já viu. A observação começa agora; leia as conversas uma vez para se atualizar. Ela termina com esta sessão. Somente builds de clientes de IA certificados para mostrar esses avisos podem ativá-la; qualquer outro recebe delivery "unsupported" e nada é configurado.

Entradas obrigatórias

action

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para telegram_watch_messages. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows