| spotifyAuth | Gestiona autenticación de Spotify. FLUJO RECOMENDADO: Si error "Credenciales no configuradas": Pide al usuario clientId y clientSecret (de https://developer.spotify.com/dashboard) o que los agregue en env del mcp.json, luego usa accion="configurar" Después de configurar: Usa accion="ejecutar" para completar OAuth (abre navegador automáticamente) Si el usuario no puede autorizar: Usa accion="urlAuth" para darle el link manual
IMPORTANTE: Las credenciales se guardan en ~/.spotify-mcp-tokens.json junto con los tokens de sesión
|
| spotifyPlayer | Controla reproduccion de Spotify. MANEJO DE ERRORES: Si error "No hay dispositivo activo": 1) Usa spotifyInfo(accion="devices") para obtener lista. 2) Si hay dispositivos, usa spotifyPlayer(accion="transfer", dispositivo="ID") para activarlo y luego reintenta play. 3) Si no hay dispositivos, usa spotifyPlayer(accion="openApp"), espera que cargue, repite desde paso 1. Si transfer falla o no hay dispositivos despues de abrir: Pide al usuario que reproduzca algo manualmente en Spotify para activar la sesion. Si error "Premium requerido": Informa que necesita Spotify Premium. Para reproducir: Primero busca con spotifyInfo(accion="search"), luego usa el ID con play.
FLUJO RECOMENDADO cuando no reproduce: devices -> transfer(dispositivo=ID) -> play. Si falla, openApp -> esperar -> devices -> transfer -> play.
|
| spotifyInfo | Busca y obtiene información de Spotify. USOS COMUNES: Para reproducir música: Primero search(consulta="nombre canción", tipo="track") para obtener el ID, luego usar spotifyPlayer(play, id=ID_OBTENIDO) Para verificar dispositivos antes de reproducir: devices (si "Sin dispositivos", usar spotifyPlayer openApp) Para ver qué suena: nowPlaying Para ver estado de reproducción: state
NO REQUIERE dispositivo activo para búsquedas, pero sí para nowPlaying/state/queue.
|
| spotifyLibrary | Gestiona biblioteca y playlists del usuario. FLUJOS COMUNES: Guardar canción actual: Primero spotifyInfo(nowPlaying) para obtener ID, luego save(ids=[ID]) Crear playlist con canciones: 1) createPlaylist(nombre="Mi Playlist"), 2) addToPlaylist(playlistId=ID_PLAYLIST, ids=[IDs de canciones]) Ver playlists del usuario: spotifyInfo(playlists) Ver canciones de playlist: spotifyInfo(playlistTracks, id=PLAYLIST_ID)
NOTA: Los IDs de canciones se obtienen de spotifyInfo(search) o spotifyInfo(nowPlaying).
|
