Shortlist MCP

Установка

Работает в

• Claude Code
• Codex
• SourceCraft
• Koda
• Coddy

Ручная установка

[mcp_servers.shortlist]
url = "http://127.0.0.1:5959/mcp"
bearer_token_env_var = "SHORTLIST_MCP_CREDENTIAL"

Что делает

Shortlist запускается в одном контейнере Docker и дает каждому пользователю сервера Plex собственные ряды рекомендаций: Picked for You, Because you watched, Watch it again и сезонные подборки. Для каждого человека он читает его историю просмотров, выбирает из вашей библиотеки то, что он не видел, и объясняет выбор. Ряды перестраиваются по расписанию и видны только их владельцу. Перед показом ряд получает метку, а у остальных аккаунтов фильтр общего доступа Plex скрывает ее, и только потом ряд попадает на главную. Кандидатов Shortlist берет из TMDB и Trakt, а недостающее может передать в Radarr, Sonarr, Overseerr или Jellyseerr. Ключ нейросети не обязателен. Необязательный MCP-доступ дает агенту именованное подключение со сроком и кнопкой отключения. Владелец выбирает режим View only или Manage Shortlist. Агент помогает завершить мастер настройки, планирует изменения людей и рядов, тем, аудиторий, сезонов и расписаний, смотрит предварительные рекомендации и запускает сохраненные ряды. Ключи сервисов, владение Plex и точные подтверждения остаются за владельцем. Эндпоинт лежит по адресу вида https://хост/mcp, для локальной работы подходит http://127.0.0.1:5959/mcp, а для клиентов на stdio есть мост shortlist-mcp-stdio.

Для кого. Владельцы домашних серверов Plex, которые хотят отдавать персональные рекомендации семье и друзьям и управлять ими через ассистента.

Пример запроса к агенту

Покажи статус настройки Shortlist и список рядов для каждого человека, ничего не меняй.

MCP

Транспорт

http, stdio

Авторизация

OAuth

Ограничения

MCP-доступ выключен по умолчанию и включается владельцем. Адрес задается переменной SHORTLIST_MCP_URL, обычный HTTP допускается только на loopback, для остальных адресов нужен HTTPS. Обычные запуски в режиме Manage используют настроенные сервисы и могут стоить денег, общего лимита расходов нет. Установку, часовой пояс, резервные копии, загрузку постеров, тестовые уведомления и удаление выполняет владелец вручную.

Как отключить. В Settings, раздел AI assistants, нажмите Disconnect у подключения: локальные ключи и токены OAuth отзываются сразу. Чтобы выключить MCP полностью, уберите SHORTLIST_MCP_URL у контейнера и перезапустите его.

Коротко о README

README начинается с постановки проблемы одинаковых рядов Plex и показывает порядок скрытия рядов перед показом. Дальше описаны интеграции с TMDB, Trakt, Radarr, Sonarr, Overseerr и Kometa, быстрый старт в одном контейнере Docker и ссылки на документацию. Отдельное руководство assistant-access подробно объясняет MCP, роли и подключение клиентов.