Usa l'endpoint MCP di produzione di Metricool https://ai.metricool.com/mcp, abbina il tuo client AI al metodo di connessione corretto, quindi esegui i controlli riportati di seguito se il server non si connette.
Verifica questi elementi prima di approfondire le soluzioni 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 di seguito (URL/OAuth, token nell'header, CLI o mcp-remote).
Autenticazione: completa l'accesso OAuth e concedi l'autorizzazione, 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 un solo connettore personalizzato alla volta. Elenco completo: Limiti MCP e requisiti dei piani.
Indicatore di successo: il client mostra Metricool come connesso, autenticato o pronto all'uso (la dicitura varia in base allo strumento).
Scegli il metodo di connessione corretto
Usa il metodo corrispondente al tuo client. Usare il metodo sbagliato è un motivo comune per cui il server MCP non completa mai la connessione.
Metodo di connessione
Come eseguire l'autenticazione
Client supportati
Basato su URL (HTTP/OAuth)
Incolla l'URL MCP, quindi accedi a Metricool e concedi l'autorizzazione
ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, TypingMind, Claude Desktop e Claude.ai (tramite la Directory dei connettori)
Token nell'header
Imposta il nome dell'header X-Mc-Auth sulla tua chiave API di Metricool disponibile in Impostazioni account > API
N8N
CLI
Aggiungi MCP tramite HTTP/CLI, quindi esegui l'autenticazione quando richiesto
Claude Code, Gemini CLI
mcp-remote
Esegui npx mcp-remote sull'URL di Metricool, quindi usa OAuth o X-Mc-Auth
Claude Desktop (solo come alternativa manuale, non come percorso predefinito)
Claude Desktop e Claude.ai si connettono nello stesso modo: Impostazioni → Connettori → Sfoglia connettori → cerca Metricool → Concedi l'autorizzazione. Questo flusso OAuth non richiede una chiave API di Metricool. mcp-remote è un'alternativa solo per Claude Desktop, nel caso in cui l'elenco della directory non sia disponibile o il flusso non venga completato.
Altre opzioni di autenticazione documentate per i client MCP sono l'accesso OAuth oppure l'inserimento di METRICOOL_USER_TOKEN e METRICOOL_USER_ID nella configurazione del client. Consulta le Domande frequenti su Metricool MCP.
Problemi di connessione
Apri il sintomo corrispondente a ciò che visualizzi. Ogni sezione descrive una modalità di errore verificata e la relativa soluzione.
Claude Desktop non si connette tramite il percorso abituale
Inizia dalla Directory dei connettori: Impostazioni → Connettori → Sfoglia connettori → cerca Metricool → Concedi l'autorizzazione. Questo è lo stesso flusso OAuth usato su Claude.ai e non richiede una chiave API di Metricool. Se il percorso non viene completato, connettiti manualmente usando mcp-remote.
In Claude Desktop, apri Impostazioni dal tuo profilo.
Vai a Sviluppatore → Modifica configurazione nella sezione Server MCP locali.
Questa configurazione OAuth non richiede una chiave API. Per eseguire l'autenticazione con una chiave API invece di OAuth tramite browser, usa questa configurazione:
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 verifica che Metricool sia connesso.
Il client non completa mai la connessione o rimane non autenticato
L'endpoint, il metodo o il passaggio di autorizzazione non è completo. Risolvi il problema in questo ordine:
Verifica che l'URL del server sia esattamente https://ai.metricool.com/mcp (senza percorsi aggiuntivi, spazi o host alternativi).
Verifica che il client utilizzi il metodo indicato nella tabella precedente. Ad esempio, N8N richiede l'autenticazione tramite header, non una semplice configurazione solo OAuth; Claude Desktop inizia dalla Directory dei connettori e usa mcp-remote solo come alternativa se il flusso non viene completato.
Completa l'accesso nel browser e seleziona Concedi l'autorizzazione quando Metricool richiede i permessi.
In Cursor, dopo l'installazione il server può apparire 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, quindi esegui l'autenticazione quando richiesto.
L'autenticazione tramite header di N8N non riesce
N8N si connette tramite autenticazione con token nell'header, non tramite il flusso OAuth basato solo sull'URL usato dalla maggior parte degli altri client.
In MCP Client Tool, imposta l'endpoint su https://ai.metricool.com/mcp.
Salva la credenziale e prova nuovamente 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 un solo connettore personalizzato alla volta.
Rimuovi o sostituisci il connettore personalizzato esistente, quindi connetti nuovamente Metricool. Claude Code richiede comunque un abbonamento Pro o Max. Consulta Come connettere Metricool MCP con Claude.
Claude Code non accetta il comando per aggiungere MCP
Claude Code richiede un abbonamento Pro o Max e l'installazione dalla pagina del prodotto Claude Code prima di poter aggiungere Metricool.
Verifica che Claude Code sia installato e che tu disponga di un abbonamento Pro o Max.
Esegui:
claude mcp add --transport http metricool https://ai.metricool.com/mcp
Avvia Claude Code con claude, esegui /mcp, seleziona Metricool ed esegui l'autenticazione.
Cursor non mostra il flusso di installazione di Metricool MCP
La configurazione di Cursor MCP richiede l'app Cursor Desktop. Cursor utilizzato solo dal browser non può completare il percorso di installazione documentato.
Fai clic su Connetti, autorizza Metricool nel browser e torna a Cursor per confermare la connessione.
MCP si connette, ma le azioni non riescono o i dati sembrano limitati
Di solito si tratta di un limite del piano, non di una connessione al server non riuscita. MCP funziona con i piani Free e a pagamento, ma i limiti dei piani Metricool si applicano comunque a ciò che MCP può interrogare o pianificare.
Consulta gli esempi per il piano Free, i requisiti lato client e la distinzione tra MCP e API in Limiti MCP e requisiti dei piani. Se ti serve l'accesso HTTP programmatico al di fuori di un client AI, si tratta dell'API di Metricool (Advanced o Custom), non di MCP. Consulta Accesso MCP e API: qual è la differenza?.
Conferma che la connessione è riuscita
Usa l'indicatore di successo del tuo client:
Claude Desktop: Metricool appare in Connettori 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, MCP è connesso nella sessione del terminale.
Make, Zapier, Smithery, Mistral Vibe, TypingMind, N8N: dopo aver concesso l'autorizzazione (o salvato le credenziali dell'header in N8N), il client mostra il connettore o gli strumenti come disponibili.
Revoca l'accesso e riconnettiti
Per revocare l'accesso, rimuovi o disconnetti il connettore Metricool dal client AI o dalla piattaforma in cui lo hai autorizzato (ad esempio Claude, ChatGPT, Cursor o un altro client MCP). Non puoi revocare l'autorizzazione del connettore da Metricool.
Dopo aver revocato l'accesso sulla piattaforma, riconnettiti ripetendo i passaggi di connessione del client e concedendo nuovamente l'autorizzazione se ti serve ripristinare MCP.