ktalk-mcp

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

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

Инструменты

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

Related MCP server: time-messenger-mcp-server

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

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

Установка

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

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, поправьте порт в букмарклете под него.

Приёмник принимает POST только со страницы, чей origin совпадает с KTALK_SPACE_URL (иначе 403 forbidden_origin): порт слушается всё время жизни процесса, и без этой проверки токен-файл могла бы перезаписать любая открытая вкладка. Если букмарклет отвечает 403, сверьте KTALK_SPACE_URL с адресом вкладки.

Способ 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'