Usa l’endpoint MCP di produzione di Metricool https://ai.metricool.com/mcp, abbina il tuo client AI al metodo di connessione corretto, poi passa ai controlli qui sotto se il server non si connette.
L’MCP di Metricool funziona con qualsiasi piano di Metricool, incluso Free. I limiti del tuo piano continuano ad applicarsi anche dopo la connessione. Per esempio, gli account Free non possono pianificare più di 20 post.
Checklist rapida di connessione
Verifica questi elementi prima di entrare nelle correzioni specifiche per il 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 indicato qui sotto (URL/OAuth, token nell’header, CLI o mcp-remote).
Autenticazione: completa l’accesso OAuth e concedi l’accesso, oppure configura l’autenticazione tramite 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.
Segnale di successo: il client mostra Metricool come connesso, autenticato o pronto all’uso (la dicitura varia in base allo strumento).
Per i passaggi completi di configurazione per client, vedi Come connettere l’MCP di Metricool.
Scegli il metodo di connessione giusto
Usa il metodo che corrisponde al tuo client. Usare il metodo sbagliato è uno dei motivi più comuni per cui il server MCP non finisce mai di connettersi.
Le altre opzioni di autenticazione documentate per i client MCP sono l’accesso OAuth oppure la fornitura di METRICOOL_USER_TOKEN e METRICOOL_USER_ID nella configurazione del client. Vedi Domande frequenti sull’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 correzione.
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 Developer → Edit config sotto Local MCP servers.
Aggiungi questa configurazione:
Per autenticarti con una chiave API invece che con OAuth nel browser, usa questa configurazione:
Salva il file e riavvia Claude Desktop.
Se hai usato OAuth, completa l’autorizzazione nel browser quando richiesto. Se hai usato il metodo con la chiave API, il passaggio nel browser viene saltato.
In una chat, apri Connectors e conferma che Metricool sia connesso.
Passaggi completi per Claude Desktop e Claude Code: Come connettere l’MCP di Metricool con Claude.
L’endpoint, il metodo o il passaggio di autorizzazione non è completo. Risolvi in quest’ordine:
Conferma che l’URL del server sia esattamente https://ai.metricool.com/mcp (nessun percorso aggiuntivo, spazio o host alternativo).
Conferma che il tuo client stia usando il metodo indicato nella tabella sopra. Per esempio, N8N ha bisogno dell’autenticazione tramite header, non di una semplice configurazione OAuth-only; Claude Desktop ha bisogno di mcp-remote.
Completa l’accesso nel browser e scegli Grant access quando Metricool ti chiede i permessi.
In Cursor, dopo l’installazione il server può apparire non autenticato finché non fai clic su Connect 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.
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 connetti di nuovo Metricool. Claude Code richiede comunque un abbonamento Pro o Max.
Claude Code richiede un abbonamento Pro o Max e l’installazione dalla pagina prodotto di Claude Code prima che tu possa aggiungere Metricool.
Conferma che Claude Code sia installato e che tu abbia Pro o Max.
Esegui:
Avvia Claude Code con claude, esegui /mcp, seleziona Metricool e autentica.
La configurazione MCP di Cursor richiede l’app Cursor Desktop. Cursor solo da browser non può completare il percorso di installazione documentato.
Installa e apri Cursor Desktop.
Usa il deep link di installazione di Metricool o il link web da Come connettere l’MCP di Metricool, oppure aggiungi un MCP personalizzato con:
Fai clic su Connect, autorizza Metricool nel browser e torna su Cursor per confermare la connessione.
Di solito è un limite del piano, non una connessione del server fallita. L’MCP funziona sui piani Free e a pagamento, ma i limiti del piano Metricool continuano ad applicarsi a ciò che l’MCP può interrogare o pianificare.
Se ti serve accesso HTTP programmatico fuori da un client AI, quello è l’API di Metricool (Advanced o Custom), non MCP. Vedi MCP vs accesso API: qual è la differenza?.
Conferma che la connessione sia riuscita
Usa il segnale di successo del tuo client:
Claude Desktop: Metricool appare in Connectors come connesso.
Claude Code: dopo l’autorizzazione nel browser, /mcp mostra Metricool come 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 è connesso nella sessione del terminale.
ChatGPT: Metricool risulta connesso da Apps dopo l’accesso e la concessione dell’autorizzazione. Passaggi completi: Come connettere l’MCP di Metricool con ChatGPT.
Make, Zapier, Smithery, Mistral Vibe, N8N: dopo aver concesso l’accesso (o dopo aver salvato le credenziali dell’header in N8N), il client mostra il connettore/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 l’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 l’MCP.