Metricool MCP

Come collegare l’MCP di Metricool

Questa guida spiega i metodi disponibili per collegare l’MCP (Metricool Connector Protocol) con diverse piattaforme e strumenti AI. L’MCP è uno strumento intelligente che si integra con il tuo account Metricool per ottimizzare la gestione dei social media, permettendoti di programmare i contenuti nei momenti migliori per pubblicarli, offrire raccomandazioni personalizzate basate sui tuoi dati, analizzare automaticamente le tue metriche e aiutarti a risparmiare tempo migliorando i tuoi risultati.

Puoi usare l’MCP di Metricool con qualsiasi piani di Metricool, incluso l’account gratuito. Si applicano le limitazioni del tuo piano attuale. Per esempio, con un account gratuito non puoi consultare dati più vecchi di 3 mesi né programmare più di 20 post. I piani a pagamento ampliano questi limiti.

Cosa ti serve prima di iniziare

Prima di collegare l’MCP, assicurati di avere quanto segue:

  • Un account Metricool: L’MCP funziona con qualsiasi piani, incluso l’account gratuito. Si applicano le limitazioni del tuo piani all’uso dell’MCP (ad esempio, gli account gratuiti non possono consultare dati più vecchi di 3 mesi né programmare più di 20 post).

  • Account attivo nello strumento che vuoi collegare (ChatGPT, Make, Zapier, ecc.), con accesso a funzionalità avanzate, come la possibilità di connettersi a fonti esterne o eseguire azioni tramite URL. 👉 Se hai domande sui requisiti specifici di ogni strumento, verifica direttamente con il fornitore del client AI.

  • URL di produzione dell’MCP di Metricool: https://ai.metricool.com/mcp

Ti consigliamo di rivedere l’informativa sulla privacy dell’app che stai per collegare prima di autorizzare l’accesso all’MCP.

Metodi di connessione disponibili

Metodo di connessione

Descrizione

Strumenti supportati

Connessione basata su URL (HTTP/OAuth)

Il metodo più comune e più semplice.

ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor

Connessione con token nell’header

Metodo avanzato che richiede token di autenticazione negli header HTTP.

N8N

Connessione CLI

Per sviluppatori che preferiscono lavorare dal terminale.

Claude Code, Gemini CLI

Inoltre, puoi collegare Claude Desktop usando mcp-remote.

Se non sei un utente tecnico, ti consigliamo di usare le connessioni basate su URL, perché sono le più semplici e visive.

Quali permessi concede l’MCP

Quando colleghi l’MCP, lo strumento AI potrà accedere ai seguenti dati e funzionalità del tuo account Metricool:

  • Visualizzare e gestire i tuoi brand e le connessioni ai social network

  • Visualizzare e scaricare metriche e analitica

  • Visualizzare, creare e pubblicare post (sia programmati che già pubblicati)

Questi permessi concedono accesso completo al tuo account Metricool, in modo simile a un accesso diretto. Autorizza l’MCP solo negli strumenti di cui ti fidi. Puoi revocare l’accesso in qualsiasi momento dalle impostazioni del tuo account.

Come collegare l’MCP di Metricool passo dopo passo

Per aiutarti a collegare l’MCP di Metricool usando il metodo più adatto al tuo flusso di lavoro, le sezioni seguenti ti guidano passo dopo passo per tutti i client supportati — inclusi ChatGPT, Make, Zapier, Smithery, Mistral Vibe, Cursor, N8N, Claude Code e Gemini CLI — sia che tu stia usando connessioni basate su URL, autenticazione con token nell’header o strumenti da riga di comando.

ChatGPT

Metricool è disponibile come connettore verificato nella sezione Apps di ChatGPT:

  1. Vai direttamente a Metricool for Social Media su ChatGPT, oppure apri ChatGPT, clicca su Apps nella barra laterale sinistra e cerca Metricool.

  2. Clicca su Connect. Apparirà un popup che ti chiederà di accedere con Metricool — clicca su Sign in with Metricool for Social Media

  3. Verrai reindirizzato su Metricool per autorizzare la connessione. Rivedi i permessi e clicca su Grant access.

  1. Una volta connesso, l’MCP di Metricool sarà disponibile automaticamente nelle tue chat di ChatGPT.

Make

  1. Vai a un nuovo scenario su Make.com

  2. Aggiungi un nuovo modulo e cerca MCP

  1. Crea una connessione

  1. Aggiungi un nuovo MCP Server e inserisci l’URL di Metricool. Clicca su Save

  1. Automaticamente si aprirà una nuova finestra per accedere a Metricool e autorizzare l’accesso

  2. Ora puoi usare l’MCP di Metricool in entrambi i modi: selezionando uno strumento e usandolo, oppure aggiungendo il task come prompt, e l’MCP eseguirà le azioni.

Zapier

  1. Vai su Zapier.com e avvia un nuovo Zap

  2. Aggiungi una nuova Action, cerca “MCP” e usa “MCP Client”

  1. Vai su Sign In. Aggiungi l’URL dell’MCP di Metricool e continua

  1. Accedi a Metricool e autorizza l’accesso

  2. Ora puoi usare l’MCP di Metricool dentro Zapier.

Smithery

  1. Vai alla pagina di Smithery (piani gratuito) → https://smithery.ai/playground

  2. In basso, nella casella di testo, clicca su 'Add tool'.

  1. Inserisci l’URL nella barra di ricerca e clicca su 'Connect to MCP server.

  1. Il passaggio successivo è concedere all’MCP l’accesso per usare il tuo account Metricool.

  2. Una volta stabilita la connessione, potrai vedere gli strumenti disponibili e sarà pronto per l’interazione.

Mistral Vibe

Mistral ha rinominato Le Chat in Vibe. Questa sezione è in aggiornamento — se ti servono i dettagli più recenti dei passaggi, consulta la documentazione ufficiale sui connettori MCP di Mistral.

  1. Vai alla pagina di Mistral Vibe (piani gratuito) → Le Chat

  2. Vai su Vibe → Connectors (pannello sinistro) → + Add Connector.

  1. Vedrai i connettori in evidenza. Per aggiungere il connettore Metricool, devi cliccare sul pulsante 'Add connector'.

  1. In 'Personalized MCP connector' dovrai aggiungere quanto segue: nome del connettore, server del connettore (URL), descrizione (opzionale) e il metodo di autenticazione, che è OAuth2.1, poi clicca su 'Connect'.

  1. Il passaggio successivo è concedere all’MCP l’accesso per usare il tuo account Metricool.

  2. In basso troverai i tuoi connettori disponibili, pronti per essere usati in una chat o per vedere gli strumenti disponibili.

Cursor

Per poter aggiungere MCP a Cursor ti serve l’app Cursor Desktop, puoi scaricarla qui: Download.

Dopo aver effettuato l’accesso al tuo account Cursor, hai due opzioni:

  1. Copia uno di questi link nel tuo browser:

    Deep link:

    cursor://anysphere.cursor-deeplink/mcp/install?name=metricool-mcp&config=eyJ1cmwiOiJodHRwczovL2FpLm1ldHJpY29vbC5jb20vbWNwIiwidHlwZSI6Imh0dHAifQ%3D%3D

    Web link: Auth | Cursor - The AI Code Editor

  2. Questi link apriranno la tua app Cursor Desktop e ti chiederanno se vuoi aggiungere il server MCP:

  3. Dopo aver cliccato su Install, il server MCP apparirà nella scheda Installed MCP. Tuttavia, mostrerà che richiede l’autenticazione, quindi clicca su Connect:

  4. Ti chiederà di aprire un URL esterno nel browser per autorizzare la connessione con Metricool:

  5. Dopo aver concesso l’accesso, l’applicazione Cursor si aprirà di nuovo e l’MCP sarà connesso.

  1. Il primo passaggio è cliccare sull’icona delle impostazioni in alto a destra e andare alla sezione Tools & MCP:

  2. Una volta dentro la sezione, clicca su Add Custom MCP per aprire il file mcp.json:

    In origine, se non è connesso alcun MCP, il file mcp.json ha la seguente struttura:

    {
      "mcpServers": {}
    }

    Per aggiungere un server MCP, in questo caso quello di Metricool, devi inserire il seguente snippet di codice dentro mcpServers:

    "metricool-mcp": {
      "url": "https://ai.metricool.com/mcp",
      "type": "http"
    }

    Il risultato finale dovrebbe essere il seguente:

    {
      "mcpServers": {
          "metricool-mcp": {
            "url": "https://ai.metricool.com/mcp",
            "type": "http"
          }
      }
    }

    Ricorda di salvare il file cliccando su Files > Save.

  3. Tornando alla sezione Tools & MCP, l’MCP dovrebbe apparire come non autenticato, quindi segui lo stesso processo cliccando su Connect:

  4. Ti chiederà di aprire un URL esterno nel browser per autorizzare la connessione con Metricool:

  5. Dopo aver concesso l’accesso, l’applicazione Cursor si aprirà di nuovo e l’MCP sarà connesso.

N8N

  1. Vai su N8N e crea un nuovo workflow

  2. Aggiungi un nuovo nodo AI Agent


3. Dentro gli strumenti dell’AI Agent cerca MCP Client Tool


4. Aggiungi l’URL di Metricool nel campo endpoint
5. Seleziona in Authentication → Header Auth

  1. Crea nuove credenziali.

  2. Aggiungi il Name → X-Mc-Auth

  3. E il valore → La tua API Key di Metricool (la trovi nelle impostazioni del tuo account)

  1. Salva le credenziali e avrai qualcosa di simile a questo


10. Ora puoi usare l’MCP di Metricool dentro N8N

Anche se il suo utilizzo è più orientato a compiti specifici e a un pubblico più specializzato, esistono anche client da riga di comando in grado di usare l’MCP di Metricool.

Claude Code

  1. Per usare Claude Code, ti serve un abbonamento Pro o Max e devi installarlo da questo sito Claude Code | Claude .

  2. Dopo averlo installato, devi digitare il seguente comando nel terminale in cui lo userai:

    claude mcp add --transport http metricool https://ai.metricool.com/mcp
  3. Avvia Claude Code inserendo il comando claude:

  1. Inserisci il comando /mcp in Claude Code per vedere gli MCP attivi e selezionare quello di Metricool. Quando premi Invio, mostrerà che è richiesta l’autenticazione per connettersi. Premi 1 o Invio per autenticarti:

  1. Si aprirà una scheda del browser che richiede l’autorizzazione:

  2. Quando clicchi su Grant access, apparirà un messaggio che indica che tutto è andato a buon fine e che puoi tornare a Claude Code:

  1. L’MCP sarà connesso:

Gemini CLI

  1. Per scaricare Gemini CLI devi aprire un terminale ed eseguire il seguente comando:

npm install -g @google/gemini-cli
  1. Una volta installato, devi accedere al file di configurazione, che si trova in uno dei seguenti percorsi:

  • /etc/gemini-cli/system-defaults.json (Linux)

  • C:\ProgramData\gemini-cli\system-defaults.json (Windows)

  • /Library/Application Support/GeminiCli/system-defaults.json (macOS).
    Il percorso può essere sostituito usando la variabile d’ambiente GEMINI_CLI_SYSTEM_DEFAULTS_PATH.

  1. Nel file di configurazione, aggiungi questo snippet di codice:

{
  "mcpServers": {
    "metricool": {
      "httpUrl": "https://ai.metricool.com/mcp"
    }
  },
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  }
}
  1. Salva il file e apri un terminale Gemini CLI con il comando gemini. Esegui il seguente comando:

/mcp auth metricool
  1. Si aprirà una scheda del browser che richiede l’autorizzazione:

  1. Dopo aver concesso l’accesso, puoi tornare al terminale e l’MCP sarà connesso.

Claude Desktop

A causa di un bug esterno che non consente agli utenti di collegare Claude Desktop all’MCP di Metricool nel modo abituale, c’è una soluzione alternativa usando mcp-remote.

  1. Per prima cosa, apri la scheda Settings cliccando sul tuo profilo:

  1. Nella scheda delle impostazioni, clicca sul pulsante Developer e poi sul pulsante Edit config sotto Local MCP servers per aprire il documento claude_desktop_config:

  1. Aggiungi il seguente codice al documento:

{
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp"
      ]
    }
  }
}

Se vuoi ottenere l’accesso tramite una API key invece di autorizzare l’applicazione, aggiungi invece il seguente codice:

{
  "mcpServers": {
    "metricool-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ai.metricool.com/mcp",
        "--header",
        "X-Mc-Auth: "<METRICOOL_API_KEY>""
      ]
    }
  }
}
  1. Salva il documento sul computer e riavvia Claude Desktop.

  2. Dopo aver riaperto l’applicazione, se hai incluso il primo snippet di codice, si aprirà una scheda del browser che richiede l’autorizzazione:

Se hai usato il metodo della API key, questa scheda non apparirà perché sei già autenticato.

  1. Dopo aver concesso l’accesso, puoi iniziare una chat e verificare in Connectors che l’MCP sia connesso:

È stato utile?