Уся документація

MCP-сервер

Дайте Claude та іншим AI-агентам пошук у публічних Telegram-каналах лише для читання.

URL сервера https://mcp.opentg.ai/mcp

Автентифікація

Надсилайте API-ключ у заголовку Authorization. Це той самий ключ і та сама денна квота, що й у REST API.

Authorization: Bearer otg_live_...

Увійдіть, щоб створити безкоштовний API-ключ

Підключення

Claude (claude.ai і застосунки Claude)

  1. Відкрийте Settings → Connectors і виберіть «Add custom connector».
  2. Назвіть його OpenTG і вставте URL сервера.
  3. Виберіть вхід без авторизації й додайте заголовок запиту Authorization зі значенням Bearer, пробілом і вашим ключем.
  4. Збережіть і поставте питання в чаті. Claude викликає інструменти, коли йому потрібні пости з Telegram.

Claude Code

claude mcp add --transport http opentg https://mcp.opentg.ai/mcp \
  --header "Authorization: Bearer $OPENTG_API_KEY"

Інші MCP-клієнти

Будь-який клієнт, що підтримує віддалені Streamable HTTP-сервери з власними заголовками:

{
  "mcpServers": {
    "opentg": {
      "type": "http",
      "url": "https://mcp.opentg.ai/mcp",
      "headers": { "Authorization": "Bearer ${OPENTG_API_KEY}" }
    }
  }
}

Інструменти та їхня вартість

Платний виклик інструмента коштує рівно стільки, скільки відповідний запит до REST API. Кожен результат закінчується кількістю списаних і залишених одиниць.

ІнструментВартістьОпис
get_usageбезкоштовноСьогоднішня дата (UTC), залишок квоти й тариф. Агенти викликають його першим.
check_queryбезкоштовноПеревіряє пошуковий запит на помилки, не виконуючи його.
search_posts1Повнотекстовий пошук за останні 30 днів, спершу найновіші. Пошук довший за 7 днів іде по тижню, 1 одиниця за тиждень, тож 30 днів коштують 4. Попросіть один тиждень, щоб отримати лише найновіші пости за 1 одиницю.
channel_posts1Пости одного індексованого каналу, спершу найновіші, зокрема старші за 30 днів.
find_channels1Знаходить індексовані канали за темою, мовою чи розміром.
get_channel1Профіль одного каналу.
get_post1Повний текст одного поста за його посиланням.
live_channel2Читає публічний канал наживо з Telegram, до 100 постів.
read_postsбезкоштовноПовний текст вибраних рядків зі вже отриманої сторінки.
more_resultsбезкоштовноРешта сторінки, задовгої для одного результату.

Варто знати

  • Усі інструменти лише читають. Нічого не публікується і не змінюється.
  • Текст постів — це сторонній вміст. Він очищений і позначений як дані, а не інструкції, але агентові все одно варто вважати його неперевіреним.
  • «Нічого не знайдено» означає, що не знайдено в індексованих каналах за останні 30 днів, а не що цього ніколи не було.
  • На тарифах Starter і Pro виклики інструментів видно в журналі запитів із позначкою MCP.

Протокол

Streamable HTTP без стану: JSON-RPC через POST, без сесій. Підтримувані версії протоколу: 2026-07-28, 2025-11-25, 2025-06-18 і 2025-03-26.