MCP API Доступ

Що таке MCP?
Model Context Protocol (MCP) дозволяє AI-агентам — таким як Claude, ChatGPT або власні боти — підключатися до твоєї бібліотеки YouTube Music. Після підключення агент може переглядати плейлисти, шукати музику, додавати або видаляти треки та створювати нові плейлисти від твого імені.
Ручне налаштування
  1. Згенеруй API-токен нижче — це ключ, який AI-агент використовуватиме для автентифікації.
  2. Скопіюй URL ендпоінту та токен, потім додай їх у MCP-конфігурацію свого AI-агента.
  3. Агент тепер може викликати будь-який з доступних інструментів нижче для керування бібліотекою.
Встановлення одним кліком для Claude Desktop
Завантаж файл розширення та двічі клікни на нього (або перетягни в Claude Desktop) для автоматичного встановлення. Жодних конфіг-файлів.
Завантажити Sortune.mcpb

Після встановлення Claude Desktop запитає API-токен. Згенеруй його в секції нижче.

Підключити AI до Sortune

Claude Code (CLI)

Виконай у терміналі:

claude mcp add sortune \
  --transport http \
  /api/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Claude Desktop

В Settings → Developer → Edit Config (claude_desktop_config.json):

{
  "mcpServers": {
    "sortune": {
      "url": "/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Після підключення

Просто скажи Claude:

"Organize my liked music into playlists by season, year and genre"
"Проаналізуй мою лайкнуту музику і розсортуй по плейлистам типу winter-2026-ambient"

Claude прочитає інструкції MCP сервера, візьме лайкнуті треки, сам визначить жанр кожного, згрупує за сезоном + роком + жанром, створить плейлисти і додасть треки.

Токен бери з секції API Токен нижче.

Ендпоінт
/api/mcp
API Токен
Доступні інструменти
list_playlistsОтримати список усіх плейлистів з кількістю треків
get_playlist_tracksОтримати всі треки плейлиста з артистом, жанром та метаданими
create_playlistСтворити новий плейлист з назвою та налаштуванням приватності
add_tracks_to_playlistДодати одне або кілька відео до плейлиста
remove_tracks_from_playlistВидалити треки з плейлиста за ID відео
move_tracks_between_playlistsПеремістити треки з одного плейлиста в інший
search_youtube_musicШукати відео на YouTube Music за запитом
get_track_detailsОтримати детальні метадані для конкретних відео
delete_playlistВидалити плейлист
save_track_genresЗберегти AI-класифіковані жанри треків у базу даних
get_saved_genresОтримати раніше класифіковані жанри з бази даних
mark_tracks_sortedПозначити треки як відсортовані у плейлист сезон-рік-жанр
0:00--:--