Usa l’endpoint MCP di produzione di Metricool https://ai.metricool.com/mcp, abbina il tuo client AI al metodo di connessione corretto, poi segui i controlli qui sotto se il server non si connette.
Conferma questi elementi prima di passare alle correzioni specifiche del client:
Endpoint: usa esattamente l’URL di produzione: https://ai.metricool.com/mcp.
Account Metricool: hai un account Metricool e puoi accedere.
Metodo del client: il tuo strumento usa il metodo elencato qui sotto (URL/OAuth, token nell’header, CLI o mcp-remote).
Autenticazione: completa l’accesso OAuth e concedi l’accesso, oppure configura l’autenticazione via header con la chiave API di Metricool quando il client lo richiede.
Prerequisiti del client: Claude Code richiede un abbonamento Pro o Max; Cursor richiede l’app Cursor Desktop; Claude Free può usare solo un connettore personalizzato alla volta. Elenco completo: Limiti MCP e requisiti dei piani.
Segnale di successo: il client mostra Metricool come connesso, autenticato o pronto all’uso (la dicitura varia a seconda dello strumento).
Scegli il metodo di connessione giusto
Usa il metodo che corrisponde al tuo client. Usare quello sbagliato è una delle ragioni più comuni per cui il server MCP non finisce mai di connettersi.
Metodo di connessione
Come ti autentichi
Client supportati
Basato su URL (HTTP/OAuth)
Incolla l’URL MCP, poi accedi a Metricool e concedi l’accesso
Aggiungi MCP tramite HTTP/CLI, poi autenticati quando richiesto
Claude Code, Gemini CLI
mcp-remote
Esegui npx mcp-remote sull’URL di Metricool, poi usa OAuth o X-Mc-Auth
Claude Desktop
Altri metodi di autenticazione documentati per i client MCP sono l’accesso OAuth oppure fornire METRICOOL_USER_TOKEN e METRICOOL_USER_ID nella configurazione del client. Vedi Domande frequenti su MCP di Metricool.
Problemi di connessione
Apri il sintomo che corrisponde a quello che vedi. Ogni sezione copre una modalità di errore verificata e la relativa soluzione.
Claude Desktop non si connette tramite il percorso normale
Claude Desktop ha un bug esterno documentato che blocca il normale percorso di connessione MCP. Usa invece mcp-remote.
In Claude Desktop, apri Impostazioni dal tuo profilo.
Vai su Sviluppatore → Modifica config sotto Server MCP locali.
Se hai usato OAuth, completa l’autorizzazione nel browser quando richiesto. Se hai usato il metodo con chiave API, il passaggio nel browser viene saltato.
In una chat, apri Connettori e conferma che Metricool sia connesso.
Il client non termina mai la connessione o resta non autenticato
L’endpoint, il metodo o il passaggio di autorizzazione non sono completi. Correggi in quest’ordine:
Conferma che l’URL del server sia esattamente https://ai.metricool.com/mcp (nessun percorso extra, spazio o host alternativo).
Conferma che il tuo client stia usando il metodo della tabella qui sopra. Per esempio, N8N richiede l’autenticazione via header, non una configurazione solo OAuth; Claude Desktop richiede mcp-remote.
Completa l’accesso nel browser e scegli Concedi accesso quando Metricool chiede le autorizzazioni.
In Cursor, dopo l’installazione il server può risultare non autenticato finché non fai clic su Connetti e completi l’autorizzazione nel browser.
In Gemini CLI, dopo aver aggiunto la configurazione, esegui /mcp auth metricool e completa l’autorizzazione nel browser.
In Claude Code, esegui /mcp, seleziona Metricool, poi autentica quando richiesto.
L’autenticazione via header in N8N non funziona
N8N si connette con l’autenticazione tramite token nell’header, non con il flusso OAuth solo tramite URL usato dalla maggior parte degli altri client.
Nel MCP Client Tool, imposta l’endpoint su https://ai.metricool.com/mcp.
Salva la credenziale e prova di nuovo il workflow.
Claude Free non può aggiungere Metricool come altro connettore personalizzato
I connettori personalizzati MCP remoti sono disponibili su Claude Free, Pro, Max, Team ed Enterprise. Gli utenti Free possono usare solo un connettore personalizzato alla volta.
Rimuovi o sostituisci il connettore personalizzato esistente, poi riconnetti Metricool. Claude Code richiede comunque un abbonamento Pro o Max. Vedi Come connettere MCP di Metricool con Claude.
Claude Code non accetta il comando di aggiunta MCP
Claude Code richiede un abbonamento Pro o Max e l’installazione dalla pagina prodotto di Claude Code prima di poter aggiungere Metricool.
Conferma che Claude Code sia installato e che tu abbia Pro o Max.
Esegui:
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Avvia Claude Code con claude, esegui /mcp, seleziona Metricool e autentica.
Cursor non mostra il flusso di installazione di MCP di Metricool
La configurazione MCP di Cursor richiede l’app Cursor Desktop. Cursor solo da browser non può completare il percorso di installazione documentato.
Fai clic su Connetti, autorizza Metricool nel browser e torna in Cursor per confermare la connessione.
L’MCP si connette, ma le azioni falliscono o i dati sembrano limitati
Di solito è un limite del piano, non una connessione al server fallita. MCP funziona sui piani Free e a pagamento, ma i limiti del piano Metricool si applicano comunque a ciò che MCP può interrogare o programmare.
Controlla gli esempi del piano Free, i requisiti lato client e il confine tra MCP e API in Limiti MCP e requisiti dei piani. Se ti serve accesso HTTP programmatico fuori da un client AI, quella è la API di Metricool (Advanced o Custom), non MCP. Vedi Accesso MCP vs API: qual è la differenza?.
Conferma che la connessione sia riuscita
Usa il segnale di successo del tuo client:
Claude Desktop: Metricool appare in Connettori come connesso.
Claude Code: dopo l’autorizzazione nel browser, /mcp mostra Metricool connesso.
Cursor: dopo l’autorizzazione nel browser, Cursor si riapre con Metricool connesso.
Gemini CLI: dopo /mcp auth metricool e l’autorizzazione nel browser, l’MCP risulta connesso nella sessione del terminale.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: dopo aver concesso l’accesso (o salvato le credenziali dell’header in N8N), il client mostra il connettore o gli strumenti come disponibili.
Revoca l’accesso e riconnetti
Per revocare l’accesso, rimuovi o disconnetti il connettore Metricool dal client AI o dalla piattaforma in cui lo hai autorizzato (per esempio Claude, ChatGPT, Cursor o un altro client MCP). Non puoi revocare quel permesso del connettore dall’interno di Metricool.
Dopo aver revocato l’accesso sulla piattaforma, riconnettiti ripetendo i passaggi di connessione di quel client e concedendo di nuovo l’accesso se ti serve di nuovo MCP.