ktalk-mcp

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

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

Инструменты

Инструмент	Эндпоинт	Назначение
ktalk_create_room(title, …)	PUT /api/rooms/{slug}	Создать/пересоздать комнату; возвращает url, room_name
ktalk_get_room(room_name)	GET /api/rooms/{name}	Данные комнаты
ktalk_schedule_meeting(subject, start, end, …)	POST /api/calendar	Запланированная встреча + ссылка
ktalk_list_recent(top=20)	GET /api/conferencesHistory/recent	Недавние конференции
ktalk_list_recordings()	GET /api/recordings	Список записей
ktalk_get_recording(recording_id)	GET /api/recordings/{id}	Детали записи
ktalk_download_recording(recording_id, …)	qualities[].fileUrl	Скачать видеофайл записи
ktalk_get_chat_messages(recording_id)	GET /api/recordings/{id}/chat/messages	Чат встречи
ktalk_auth_status()	—	Состояние токена + путь к файлу токена

Установка

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

Переменная	Обязательна	По умолчанию	Назначение
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'