Is Ktalk Mcp safe to install?

SaferSkills independently audited Ktalk Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

README.md · 1 file

README.md9.0 KB · Markdown

ktalk-mcp

MCP сервер для доступа к записям Контур.Толк (KTalk) из Claude Code.

Предоставляет доступ к:

Списку записей конференций
Деталям записи
Транскриптам (распознанная речь по спикерам)
Саммари и протоколам встреч

Установка

Требуется Python 3.12+ и uv.

uv tool install ktalk-mcp

Или через pip:

pip install ktalk-mcp

Получение session token

KTalk использует session token для авторизации API-запросов. Токен передаётся как query parameter.

Откройте https://your-domain.ktalk.ru в браузере
Войдите в свой аккаунт
Откройте DevTools: нажмите F12 (или Cmd+Option+I на Mac)
Перейдите во вкладку Application → Cookies → https://your-domain.ktalk.ru
Найдите cookie с именем sessionToken
Скопируйте его значение

Важно: session token имеет ограниченный срок жизни. Если MCP tool возвращает ошибку авторизации, получите новый токен по инструкции выше.

Подключение к Claude Code

Добавьте в файл ~/.claude/.mcp.json (глобально) или .mcp.json (в проекте):

{
  "mcpServers": {
    "ktalk": {
      "command": "uvx",
      "args": ["ktalk-mcp"],
      "env": {
        "KTALK_SESSION_TOKEN": "ваш_session_token",
        "KTALK_BASE_URL": "https://your-domain.ktalk.ru"
      }
    }
  }
}

Альтернативная конфигурация

Переменные окружения можно задать отдельно:

export KTALK_SESSION_TOKEN="ваш_session_token"
export KTALK_BASE_URL="https://your-domain.ktalk.ru"

Также поддерживается файл .env в рабочей директории:

KTALK_SESSION_TOKEN=ваш_session_token
KTALK_BASE_URL=https://your-domain.ktalk.ru

Доступные MCP Tools

`ktalk_list_recordings`

Список записей конференций.

Параметр	Тип	Default	Описание
`query`	str	—	Поиск по названию, комнате, автору
`start_from`	str	—	Начало периода (ISO 8601)
`start_to`	str	—	Конец периода
`top`	int	30	Количество записей (1–1000)
`order`	str	byTimeNewFirst	Сортировка: `byTimeNewFirst`, `byTimeOldFirst`, `byTitle`, `bySizeBigFirst`, `bySizeSmallFirst`
`page_token`	str	—	Токен пагинации
`format`	str	markdown	raw / markdown

`ktalk_get_recording`

Детали одной записи — автор, дата, длительность, список участников.

Параметр	Тип	Default	Описание
`recording_key`	str	—	Ключ (ID) записи
`format`	str	markdown	raw / markdown

`ktalk_get_transcript`

Транскрипт записи — распознанная речь по спикерам с таймкодами.

Поддерживает чанкинг для длинных транскриптов: при превышении chunk_size ответ автоматически разбивается на части по границам реплик (не в середине фразы). Каждый чанк содержит метаданные для постраничного чтения.

Параметр	Тип	Default	Описание
`recording_key`	str	—	Ключ (ID) записи
`format`	str	markdown	raw / markdown
`chunk`	int	0	Номер чанка. 0 = авто (целиком если маленький, первый чанк если большой). 1+ = конкретный чанк
`chunk_size`	int	30000	Макс. символов в чанке (~7500 токенов). Мягкий лимит — разрез по границам реплик

`ktalk_get_summary`

Полное саммари записи (краткое резюме + протокол).

Параметр	Тип	Default	Описание
`recording_key`	str	—	Ключ (ID) записи
`format`	str	markdown	raw / markdown

`ktalk_get_summary_by_type`

Саммари конкретного типа.

Параметр	Тип	Default	Описание
`recording_key`	str	—	Ключ (ID) записи
`summary_type`	str	—	`shortSummary` / `protocol`
`format`	str	markdown	raw / markdown

API

Сервер работает с KTalk Web API. Авторизация — через sessionToken query parameter.

Эндпоинт	Описание
`GET /api/recordings`	Список записей
`GET /api/recordings/{id}`	Детали записи
`GET /api/recordings/{id}/transcript`	Транскрипт
`GET /api/recordings/v2/{id}/summary`	Полное саммари (v2)
`GET /api/recordings/{id}/summary/{type}`	Саммари по типу

OpenAPI спецификация talk.public.api-api-2.json включена как справочник, но содержит расхождения с реальным API (пути, формат авторизации, структура ответов).

CLI реестра (`ktalk`)

Тот же пакет ставит вторую команду — ktalk, операционный реестр записей на SQLite. Вся детерминированная механика (синхронизация списка записей, дедуп, экспирация, смена статусов, рендер дашборда и markdown-зеркала, разовая миграция) живёт в коде, а не в рассуждениях модели.

SQLite — операционный source of truth. Markdown-файл registry.md — генерируемое read-only зеркало для git (ktalk export), руками не редактируется.

Путь к базе: флаг --db PATH > переменная KTALK_REGISTRY_DB > дефолт 95_TRANSCRIPTS/.registry.db (относительно текущего каталога). Бинарную БД нужно добавить в .gitignore (.registry.db, .registry.db-wal, .registry.db-shm).

Команда	Назначение
`ktalk sync [--days 7] [--json]`	Загрузить записи из KTalk, upsert новых (`new`), экспирировать `new` старше N дней → `skipped`, показать дашборд. Идемпотентно.
`ktalk dashboard [--json]`	Дашборд: новые записи, статистика по статусам.
`ktalk list [--status S] [--json]`	Список записей с фильтром по статусу.
`ktalk show <id> [--json]`	Детали записи: участники, статус, пути, длительность.
`ktalk mark-processing <id>`	Перевести в `processing`.
`ktalk mark-done <id> --transcript P --protocol P [--type T]`	Завершить, проставить пути и `processed_at`.
`ktalk mark-partial <id> [--transcript P] [--protocol P]`	Частичная обработка.
`ktalk mark-skipped <id>`	Пропустить вручную.
`ktalk set-vault-id <id> <ktalk_id> <vault_id>`	Привязать профиль к участнику.
`ktalk export [--out PATH] [--full]`	Сгенерировать markdown-зеркало.
`ktalk migrate <vault> [--dry-run] [--json]`	Разовый импорт из markdown-реестров.

Все команды поддерживают --json (валидный JSON в stdout; ошибки — в stderr с ненулевым кодом возврата). Несколько фоновых агентов могут безопасно писать параллельно (WAL + busy_timeout + транзакция на операцию).

Разработка

git clone https://github.com/mdemyanov/ktalk-mcp.git
cd ktalk-mcp
uv sync

# Запуск тестов
uv run pytest -v

# Линтинг
uv run ruff check .

# Локальный запуск сервера
KTALK_SESSION_TOKEN=... KTALK_BASE_URL=... uv run ktalk-mcp

Лицензия

MIT

Ktalk Mcp— agent skill

Is Ktalk Mcp safe to install?

ktalk-mcp

Установка

Получение session token

Подключение к Claude Code

Альтернативная конфигурация

Доступные MCP Tools

`ktalk_list_recordings`

`ktalk_get_recording`

`ktalk_get_transcript`

`ktalk_get_summary`

`ktalk_get_summary_by_type`

API

CLI реестра (`ktalk`)

Разработка

Лицензия

Audit the pieces. Scan the whole. Decide.

Is Ktalk Mcp safe to install?

ktalk-mcp

Установка

Получение session token

Подключение к Claude Code

Альтернативная конфигурация

Доступные MCP Tools

ktalk_list_recordings

ktalk_get_recording

ktalk_get_transcript

ktalk_get_summary

ktalk_get_summary_by_type

API

CLI реестра (ktalk)

Разработка

Лицензия

Audit the pieces. Scan the whole. Decide.

`ktalk_list_recordings`

`ktalk_get_recording`

`ktalk_get_transcript`

`ktalk_get_summary`

`ktalk_get_summary_by_type`

CLI реестра (`ktalk`)