Skip to main content
Glama
mainpart

ktalk-mcp

by mainpart
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

ktalk-mcp

MCP-сервер для Контур.Толк: создание комнат, планирование встреч, список и скачивание записей, чтение чата встреч — напрямую через HTTP API Толка.

Авторизация — браузерный Session-токен (заголовок Authorization: Session <token>), обновляется раз в ~30 дней: вручную через DevTools, букмарклетом из браузера или через chromedb CLI.

Инструменты

Инструменты разложены по сущностям: Комната → Встреча → Запись → Чат. Связка между встречей и записью — conference_key (одинаково в выхлопе и в параметрах).

Инструмент

Назначение

ktalk_create_room

Создать/пересоздать комнату

ktalk_create_meeting

Запланировать встречу в календаре

ktalk_list_meetings

Архив прошедших встреч с пагинацией и поиском

ktalk_get_meeting

Детали встречи с полным составом участников

ktalk_list_recordings

Список записей с пагинацией и поиском

ktalk_get_recording

Детали записи со ссылкой на скачивание

ktalk_download_recording

Скачать видеофайл записи

ktalk_get_chat_messages

Чат встречи

ktalk_auth_status

Состояние токена + путь к файлу токена

Модель данных и связи

flowchart TB
  room["Комната<br/>/api/rooms/{slug}"]
  meeting["Конференция<br/>/api/conferencesHistory/{conference_key}"]
  rec["Запись<br/>/api/recordings/{recording_id}<br/>видео + участники"]
  chat["Чат — артефакт встречи<br/>/api/conferencesHistory/{key}/chat"]

  room -->|"одна комната → N встреч"| meeting
  meeting -->|"recording_ids"| rec
  rec -.->|"conference_key"| meeting
  meeting -->|"conference_key"| chat
  rec -.->|"conference_key"| chat

  classDef core fill:#1168bd,stroke:#0b4884,color:#ffffff
  classDef art fill:#6b4fbb,stroke:#4a3785,color:#ffffff
  class room,meeting core
  class rec,chat art

Установка

Переменные окружения

Переменная

Обязательна

По умолчанию

Назначение

KTALK_SPACE_URL

да

—

Адрес пространства Толка, например https://<your-space>.ktalk.ru

KTALK_TOKEN_FILE

нет

~/.config/ktalk-mcp/token

Файл токена (0600); папка и файл создаются при старте

KTALK_RECEIVER_PORT

нет

8765

Локальный порт, на который букмарклет отправляет токен

KTALK_VERIFY_SSL

нет

false

Проверка TLS-сертификата; true — требовать валидный сертификат

KTALK_LOG_LEVEL

нет

INFO

Уровень логов (в stderr)

Claude Desktop / Claude Code — uvx (без установки)

{
  "mcpServers": {
    "ktalk": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/mainpart/ktalk-mcp", "ktalk-mcp"],
      "env": { "KTALK_SPACE_URL": "https://<your-space>.ktalk.ru" }
    }
  }
}

Получение токена

Каждый способ кладёт Session-токен в файл токена. Путь по умолчанию — ~/.config/ktalk-mcp/token.

Способ 1 — консоль DevTools

На вкладке, где вы залогинены в https://<your-space>.ktalk.ru, откройте DevTools → Console и выполните:

copy(JSON.parse(localStorage.session).data.token)

Вставьте скопированную строку в файл токена:

pbpaste > ~/.config/ktalk-mcp/token && chmod 600 ~/.config/ktalk-mcp/token

Способ 2 — букмарклет (один клик, сохраняет сам)

Букмарклет читает токен (по возможности перевыпускает его на полный срок), отправляет на localhost:8765 (слушающий сервер стартует вместе с mcp). Добавьте это как закладку:

javascript:(async()=>{try{const s=JSON.parse(localStorage.session||"{}"),d=s.data||{};let t=d.token,e=d.expiresAt||null;try{if(d.idToken){const r=await fetch("/api/authorize/session",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({idToken:d.idToken})});if(r.ok){const j=await r.json();if(j&&j.token){t=j.token;e=j.expiresAt||e}}}}catch(_){}if(!t){alert("Толк: токен не найден в localStorage.session.data.token — залогинься и повтори.");return}const p=await fetch("http://127.0.0.1:8765/ktalk-token",{method:"POST",headers:{"Content-Type":"text/plain"},body:JSON.stringify({token:t,expiresAt:e})});const o=await p.json().catch(()=>({}));if(p.ok&&o.ok){alert("Токен Толка сохранён"+(o.expiresAt?", годен до "+o.expiresAt:"")+"\n"+(o.path||""))}else{alert("Не удалось сохранить токен: "+(o.message||p.status))}}catch(x){alert("Ошибка букмарклета: "+x)}})();

Как добавить в Chrome: показать панель закладок (⌘⇧B) → правый клик по ней → Добавить страницу… → вставить строку выше в поле URL. Chrome иногда вырезает javascript: при первой вставке — тогда откройте Изменить у закладки и вставьте ещё раз, со второго раза он сохраняется.

Как использовать: находясь на вкладке своего пространства Толка (залогинены), нажмите закладку. Появится alert вида «Токен Толка сохранён, годен до …». Инструменты начинают работать без перезапуска MCP-сервера.

Порт в букмарклете по умолчанию — 8765. Если задали KTALK_RECEIVER_PORT, поправьте порт в букмарклете под него.

Способ 3 — chromedb (из файлов профиля Chrome, без запуска браузера)

chromedb читает localStorage Chromium прямо с диска — удобно, когда не хочется открывать DevTools. localStorage не зашифрован, пароль или связка ключей не нужны; работает и при запущенном браузере.

Установка (нужен Go):

go install -v github.com/noperator/chromedb/cmd/chromedb@latest

Укажите каталог профиля Chrome (точный путь — в chrome://version, строка «Profile Path»):

# macOS:   ~/Library/Application Support/Google/Chrome/Default
# Windows: %LOCALAPPDATA%\Google\Chrome\User Data\Default
# Linux:   ~/.config/google-chrome/Default
PROFILE="$HOME/Library/Application Support/Google/Chrome/Default"

Вывести токен строкой:

chromedb -ls -p "$PROFILE" | jq -r 'select(.storage_key=="https://<your-space>.ktalk.ru" and .script_key=="session") | .value.data.token'

This server cannot be installed

-
license - not tested
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mainpart/ktalk-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server