Collegare altri client MCP

Oltre a Claude e ChatGPT funziona qualsiasi client MCP che supporti server remoti via HTTP e l’accesso con OAuth – per esempio IDE come Cursor, oppure MCP Inspector per i test. Questo articolo è per chi configura da sé un client di questo tipo o sviluppa una propria integrazione.

#Dati principali

URL del server

https://dock.at-harbor.com/mcp

Trasporto

Streamable HTTP, stateless. Ogni richiesta è un POST con un messaggio JSON-RPC (o un batch) e la risposta torna come JSON. Non ci sono session ID né stream dal server.

Versioni del protocollo

2025-11-25, 2025-06-18 e 2025-03-26

Metodi

initialize, ping, tools/list e tools/call. Il server non offre resources né prompts.

Accesso

OAuth 2.1 con PKCE (S256). Senza token il server risponde con 401 e rimanda ai suoi metadati nell’header WWW-Authenticate.

#Configurare un client

1. Nel tuo client, aggiungi un server MCP remoto (spesso chiamato «Remote», «HTTP» o «Streamable HTTP»)
2. Inserisci https://dock.at-harbor.com/mcp come URL
3. Lascia vuoti client ID e secret – il client si registra da solo
4. Avvia la connessione; l’accesso si apre nel browser, seguito dalla pagina di consenso di LinkHarbor
5. Scegli workspace e autorizzazioni e clicca su «Consenti»

Il nome dell’impostazione varia da programma a programma. In MCP Inspector, per esempio, scegli il trasporto «Streamable HTTP».

#Il flusso OAuth nel dettaglio

1. Il client chiama il server MCP senza token e riceve 401 con un rimando ai metadati della risorsa
2. Legge i metadati dell’authorization server (endpoint, metodi supportati, autorizzazioni)
3. Si registra: tramite Dynamic Client Registration o con un client metadata document a un URL https
4. Apre il browser con la richiesta di autorizzazione, inclusi PKCE e resource=https://dock.at-harbor.com/mcp
5. Tu accedi e decidi sulla pagina di consenso
6. Il client scambia il codice con un access token e un refresh token

Se un client non richiede alcuna autorizzazione, vengono richieste tutte; puoi comunque restringerle sulla pagina di consenso. Se un refresh token già sostituito viene usato di nuovo, LinkHarbor chiude l’intera connessione per motivi di sicurezza.

#Regole per gli indirizzi di reindirizzamento

• Indirizzi https
• http solo per indirizzi di loopback sul tuo computer (per client desktop e IDE)
• Schemi di app personalizzati in notazione di dominio inversa
• Al massimo 10 indirizzi per client, senza frammenti

Se un’app invia un indirizzo non registrato per essa, LinkHarbor si ferma: «L'app ha inviato un indirizzo di ritorno non registrato per essa. La richiesta è stata interrotta.»

#Indirizzi di discovery per sviluppatori

#App sconosciute

Le app i cui indirizzi di reindirizzamento sono tutti su claude.ai, claude.com, chatgpt.com o openai.com sono considerate note. I programmi sul tuo computer che tornano tramite localhost – come Claude Code, Codex e gli IDE – mostrano sulla pagina di consenso la nota «LinkHarbor non conosce questa app. Gira sul tuo computer. Continua solo se l'hai appena avviata tu» e, in basso, «Dopo la tua scelta tornerai all'app sul tuo computer». Le altre app web sconosciute mostrano «LinkHarbor non conosce questa app. Continua solo se l'hai avviata tu e ti fidi di …», con il loro indirizzo al posto dei puntini. Entrambe le note sono normali se hai appena configurato tu il client. Un logo compare solo se l’app ne invia uno. Se non hai avviato tu l’accesso, clicca su «Rifiuta».