Server MCP

Usa PitchHighway dentro Claude e ChatGPT

PitchHighway ha un server MCP. Collegalo una volta e il tuo assistente IA potrà leggere la tua estensione vocale misurata, le canzoni che hai caricato, i tuoi punteggi di pratica e i tuoi report di intonazione nota per nota — così, quando chiedi «sto migliorando?» o «riesco a cantare questa canzone?», la risposta arriva dai tuoi dati e non da una supposizione.

Ogni strumento è di sola lettura, e nessun audio lascia mai il tuo dispositivo tramite MCP. Il rilevamento dell’intonazione gira in locale; questo server consegna al tuo assistente le metriche calcolate, mai una registrazione.

Strumenti: 8
Trasporto: Streamable HTTP
Autenticazione: OAuth 2.1 o token
Accesso: Gratis dopo aver cantato

URL del server

https://pitchhighway.com/mcp

Incolla questo in qualsiasi client MCP. https://pitchhighway.com/api/mcp è lo stesso server al suo URL originale e continua a funzionare: se hai già un connettore che punta lì, lascialo com’è.

Come collegarlo

Claude (web / desktop)

Apri Impostazioni → Connettori → Aggiungi connettore personalizzato
Incolla l’URL del server: https://pitchhighway.com/mcp
Claude apre l’accesso a PitchHighway: entra e approva
Chiedi: «Qual è la mia estensione vocale, e quali delle mie canzoni ci stanno dentro?»

Claude Code / Codex CLI

Claude Code — un solo comando; la prima chiamata apre l’accesso nel browser:

claude mcp add --transport http pitchhighway https://pitchhighway.com/mcp

Codex CLI — aggiungi il server, poi accedi (aggiungere un server protetto da OAuth non avvia l’accesso da solo):

codex mcp add pitchhighway --url https://pitchhighway.com/mcp

codex mcp login pitchhighway

Approva una volta e la connessione resta attiva.

ChatGPT

Apri Impostazioni → App e connettori e attiva la modalità sviluppatore
Crea un connettore e dagli questo URL del server
Lascia OAuth come metodo di autenticazione
Accetta l’avviso, crealo, poi collegati e accedi
Chiedi: «Guarda la mia ultima esecuzione completa: sto cantando crescente o calante?»

Altri client MCP (Cursor, Zed, …)

Aggiungi un server MCP con trasporto http (streamable HTTP)
Dagli l’URL del server qui sopra e completa l’accesso OAuth
Chiedi: «La mia precisione di intonazione è migliorata questa settimana?»

Alternativa avanzata: genera un token di accesso personale nell’app web (Home → il banner Collega → Avanzate) e, nelle impostazioni avanzate del connettore, aggiungi un header di richiesta chiamato authorization con il tuo token come valore.

Cosa può vedere il tuo assistente

Ogni strumento è di sola lettura, non richiede argomenti ed è limitato al tuo account: MCP può leggere i tuoi dati di allenamento, mai modificarli, e non carica né espone mai audio.

Strumento	Cosa restituisce
`list_songs`	Tutte le canzoni che hai caricato: titolo, se l’elaborazione è finita e se esiste un percorso di apprendimento per quella canzone.
`get_voice_profile`	La tua estensione vocale misurata (nota più grave e più acuta, ampiezza in semitoni) e l’impostazione Canta nella tonalità originale.
`get_progress`	Serie di pratica, livello del percorso, punteggi e attività settimanale.
`get_voice_analysis`	Ultimi 7 giorni rispetto alla settimana precedente: punteggi per categoria su 100, andamento dell’estensione, volume di pratica, ciascuno con il numero di tentativi che lo sostiene.
`get_coaching_context`	Dove sei adesso: percorso attuale, il nodo a cui sei arrivato, il passaggio in cui sei più debole e i tuoi ultimi ~10 esercizi.
`get_last_song_evaluation`	Report di intonazione nota per nota della tua ultima esecuzione completa: percentuale di note intonate, tendenza crescente o calante in cent, stabilità, note sbagliate più spesso.
`get_upload_quota`	Se puoi caricare una canzone adesso e quanto ti resta della tua quota.
`get_voice_check_report`	La tua ultima analisi «Controlla la mia voce», servita dalla cache.

Cose da chiedere

«Qual è la mia estensione vocale, e quali delle mie canzoni ci stanno davvero dentro?»
«Guarda la mia ultima esecuzione completa: sto cantando crescente o calante?»
«In quale parte del mio percorso attuale sono più debole? Dammi un piano di studio da 15 minuti.»
«La mia precisione di intonazione è migliorata questa settimana rispetto alla scorsa?»
«Posso caricare un’altra canzone adesso?»

Requisiti

Un account PitchHighway — crearlo è gratis, nel browser o su iPhone e iPad.
Completa un esercizio di canto prima di collegarti. Canta una canzone.
Un assistente compatibile con MCP che parli streamable HTTP.

MCP è gratuito dopo il primo esercizio di canto completato. L’accesso resta attivo anche se smetti di esercitarti o termina l’abbonamento.

Per le macchine

Streamable HTTP senza stato, JSON-RPC 2.0, revisione del protocollo 2025-06-18. Un POST in ingresso, una risposta JSON in uscita: niente flusso SSE, niente id di sessione, niente batch. GET restituisce questa pagina a chiunque chieda text/html e 405 a tutto il resto; DELETE è 405.

L’autenticazione è OAuth 2.1 con PKCE S256 obbligatorio e registrazione dinamica dei client. La discovery si trova su /.well-known/oauth-protected-resource/mcp e /.well-known/oauth-authorization-server.

https://pitchhighway.com/api/mcp è lo stesso server al suo URL originale e continua a funzionare; non è deprecato e non verrà rimosso.

Copie leggibili dalle macchine di questo sito: /llms.txt e /mcp.md.

Domande

Il server MCP di PitchHighway è gratuito?

Sì. Collegare la tua IA è gratuito dopo un esercizio di canto completato. Non serve un abbonamento Premium.

Il mio assistente può sentirmi cantare?

No. Il rilevamento dell’intonazione gira sul tuo dispositivo e MCP serve solo i numeri che ne escono: punteggi, estensioni, cent di scarto. Nessuna registrazione, traccia o file audio viene mai esposto tramite questo server.

Il mio assistente può modificare il mio account o caricare canzoni?

No. Tutti e 8 gli strumenti sono di sola lettura e non accettano argomenti. Non esiste uno strumento MCP che carichi, rinomini, cancelli, compri o disdica qualcosa: un assistente può leggere i tuoi dati di allenamento e nient’altro.

Quali assistenti funzionano?

Qualunque cosa parli MCP su streamable HTTP: Claude sul web, Claude Desktop, Claude Code, ChatGPT con la modalità sviluppatore attiva, Cursor, Zed e altri client compatibili con MCP.

Che differenza c’è tra /mcp e /api/mcp?

Nessuna. Sono due URL per un solo server, con autenticazione, strumenti e risposte identici. /mcp è quello corto da incollare nella finestra di un connettore; https://pitchhighway.com/api/mcp è l’originale e continua a funzionare esattamente come sempre.

Dai al tuo assistente qualcosa da leggere

Carica la canzone che vuoi cantare e PitchHighway costruisce un percorso per impararla: riscaldamenti nella tonalità del brano, esercizi per le note che ancora non prendi e feedback di intonazione in tempo reale su ogni verso. Collega il server MCP e il tuo assistente ti guida lungo tutto il percorso.

Inizia gratis