Metricool MCP

Come collegare l’MCP di Metricool

Le schermate di questa guida sono in inglese.

Collega il server MCP (Model Context Protocol) di Metricool così un client AI può leggere e agire sul tuo account Metricool. Usa l’URL di produzione https://ai.metricool.com/mcp, scegli il metodo di connessione per il tuo client, poi autorizza l’accesso.

Per i limiti del piano che continuano ad applicarsi dopo la connessione, vedi Limiti MCP e requisiti dei piani. Se il server non si connette, vedi Non riesco a connettermi a Metricool MCP.

Prima di iniziare

Tieni tutto pronto prima di aggiungere il connettore:

  • Un account Metricool su qualsiasi piano, incluso Free. I limiti del tuo piano continuano ad applicarsi all’uso di MCP.

  • Un account sul client AI o sullo strumento di automazione che vuoi collegare, con i permessi per aggiungere connettori MCP esterni o strumenti basati su URL. I requisiti specifici del client (per esempio Claude Code Pro/Max o Cursor Desktop) sono elencati in Limiti MCP e requisiti dei piani.

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

Controlla l’informativa sulla privacy dell’app che colleghi prima di autorizzare l’accesso al tuo account Metricool.

Metodi di connessione disponibili

Abbina il tuo client a un metodo di connessione. Usare il metodo sbagliato è una delle cause più comuni per cui il server non completa mai la connessione.

Metodo di connessione

Descrizione

Strumenti supportati

Basato su URL (HTTP/OAuth)

Incolla l’URL MCP, poi accedi a Metricool e concedi l’accesso.

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

Header token

Autenticati con un header token nel client.

N8N

CLI

Aggiungi il server dal terminale, poi autenticati quando richiesto.

Claude Code, Gemini CLI

mcp-remote

Usa Metricool tramite npx mcp-remote (workaround per Claude Desktop).

Claude Desktop

Se non stai lavorando da un terminale, inizia con un client basato su URL (HTTP/OAuth).

Quali permessi concede l’MCP

Quando colleghi MCP, lo strumento AI può accedere a queste parti del tuo account Metricool entro i limiti del tuo piano:

  • Visualizza e gestisci brand e connessioni ai social network

  • Visualizza e scarica metriche e analitica

  • Visualizza, crea e pubblica post (programmati e già pubblicati)

Questi permessi concedono un accesso completo, simile a quello di un accesso diretto. Autorizza solo strumenti di cui ti fidi. Revoca l’accesso dal client AI o dalla piattaforma in cui hai collegato Metricool.

Scegli il tuo client

ChatGPT e Claude hanno guide dedicate per la configurazione. Usa le sezioni qui sotto per gli altri client supportati.

Make

  1. Vai a un nuovo scenario su Make.com.

  2. Aggiungi un nuovo modulo e cerca MCP.

Ricerca moduli di Make.com che mostra MCP
  1. Crea una connessione.

Creazione connessione MCP su Make.com
  1. Aggiungi un nuovo server MCP, inserisci l’URL di Metricool https://ai.metricool.com/mcp e fai clic su Salva.

Aggiunta URL del server MCP su Make.com
Server MCP di Make.com salvato
  1. Accedi a Metricool nella finestra del browser che si apre e concedi l’accesso.

  2. Usa Metricool MCP nello scenario selezionando uno strumento o descrivendo l’attività in un prompt.

Zapier

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

  2. Aggiungi una nuova Action, cerca MCP e scegli MCP Client.

Azioni MCP Client di Zapier
  1. Apri Sign In, aggiungi l’URL MCP di Metricool e continua.

Accesso a Zapier MCP Client con URL Metricool
  1. Accedi a Metricool e concedi l’accesso.

  2. Usa Metricool MCP dentro lo Zap.

Smithery

  1. Apri la playground di Smithery: https://smithery.ai/playground.

  2. In basso, nella casella di testo, fai clic su Add tool.

Smithery playground: Add tool
  1. Inserisci l’URL MCP di Metricool nella barra di ricerca e fai clic su Connect to MCP server.

Smithery: connessione al server MCP
  1. Concedi a MCP l’accesso al tuo account Metricool.

  2. Quando la connessione è stabilita, gli strumenti disponibili compaiono e il server è pronto all’uso.

Mistral Vibe

Collega l’MCP di Metricool in Mistral Vibe aggiungendo un connettore personalizzato con OAuth 2.1.

  1. Apri Mistral Vibe.

  2. Vai su Connectors nel pannello a sinistra, poi fai clic su + Add Connector.

    Pannello sinistro di Mistral Vibe con Connectors sotto Intelligence
  3. Nella pagina dei connettori in evidenza, fai clic su Add connector.

    Pagina Featured Connectors con il pulsante Add Connector
  4. In Custom MCP Connector, inserisci un nome per il connettore, l’URL del server del connettore https://ai.metricool.com/mcp, una descrizione opzionale e il metodo di autenticazione OAuth2.1, poi fai clic su Connect.

    Modulo Custom MCP Connector con URL del server Metricool e autenticazione OAuth2.1
  5. Concedi a MCP l’accesso al tuo account Metricool.

  6. Metricool appare tra i tuoi connettori disponibili per chattare o visualizzare gli strumenti.

    Elenco dei connettori disponibili che mostra Metricool come Connected
    Dettaglio del connettore Metricool con stato Connected

Cursor

La configurazione MCP di Cursor richiede l’app Cursor Desktop. Dopo aver effettuato l’accesso, usa uno dei percorsi di installazione qui sotto.

  1. Apri uno di questi link nel browser:

    Deep link:

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

    Web link: Installa Metricool MCP in Cursor

  2. Cursor Desktop si apre e ti chiede se aggiungere il server MCP.

    Prompt di Cursor per installare Metricool MCP
  3. Fai clic su Installa. Nella scheda Installed MCP, il server appare e richiede l’autenticazione — fai clic su Connect.

    Scheda Installed MCP di Cursor che mostra che Metricool richiede autenticazione
  4. Autorizza Metricool nel browser quando richiesto.

  5. Torna a Cursor. Metricool MCP è connesso.

  1. Apri l’icona delle impostazioni in alto a destra, poi vai su Tools & MCP.

    ingranaggio delle impostazioni di Cursor
    Sezione Tools e MCP di Cursor
  2. Fai clic su Add Custom MCP per aprire il file mcp.json.

    Cursor Add Custom MCP

    Se nessun MCP è ancora collegato, il file appare così:

    {
      "mcpServers": {}
    }

    Aggiungi Metricool dentro mcpServers:

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

    Il file completo dovrebbe apparire così:

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

    Salva il file (Files > Save).

  3. In Tools & MCP, Metricool appare come non autenticato. Fai clic su Connect.

    Cursor Tools e MCP con server Metricool non autenticato
  4. Autorizza Metricool nel browser quando richiesto.

  5. Torna a Cursor. Metricool MCP è connesso.

    Cursor che mostra Metricool MCP connesso

TypingMind

Collega l’MCP di Metricool in TypingMind con OAuth basato su URL. Non serve alcun token né l’installazione di un server locale, e funziona con qualsiasi piano Metricool, incluso Free.

In TypingMind, non usare la sezione MCP della barra laterale per Metricool. Quella area è per server MCP locali o di debug che esegui tu. Collega Metricool da SettingsAdvanced SettingsModel Context Protocol (oppure PluginsMCP Connectors, a seconda del layout di TypingMind).

  1. In TypingMind, vai su SettingsAdvanced SettingsModel Context ProtocolAdd custom connector.

  2. Nel campo URL, inserisci https://ai.metricool.com/mcp.

  3. Fai clic su Connect.

  4. La prima volta, scegli TypingMind Cloud quando ti chiede quale connettore usare.

  5. Autorizza con il tuo login Metricool nel browser e accetta l’accesso.

Se vedi solo un’opzione di connessione basata su token, quel percorso usa l’API di Metricool e richiede Advanced. Per Free e altri piani, preferisci il metodo URL OAuth qui sopra. Vedi Accesso MCP vs API: qual è la differenza?.

N8N

N8N usa l’autenticazione con header token, non il flusso OAuth solo URL usato dalla maggior parte degli altri client.

  1. In N8N, crea un nuovo workflow.

  2. Aggiungi un nodo AI Agent.

Aggiunta del nodo AI Agent in N8N
  1. Negli strumenti dell’AI Agent, cerca MCP Client Tool.

N8N MCP Client Tool
  1. Imposta l’endpoint su https://ai.metricool.com/mcp.

  2. Imposta Authentication su Header Auth.

Endpoint di N8N MCP Client Tool e Header Auth
  1. Crea una nuova credenziale.

  2. Imposta il nome dell’header su X-Mc-Auth.

  3. Imposta il valore sulla tua chiave API di Metricool da Account Settings > API.

Credenziale N8N con header X-Mc-Auth
  1. Salva la credenziale.

N8N MCP Client Tool configurato
  1. Usa Metricool MCP dentro il workflow di N8N.

Gemini CLI

  1. Installa Gemini CLI da un terminale:

    npm install -g @google/gemini-cli
  2. Apri il file di configurazione in uno di questi percorsi (o nel percorso impostato da GEMINI_CLI_SYSTEM_DEFAULTS_PATH):

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

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

    • /Library/Application Support/GeminiCli/system-defaults.json (macOS)

  3. Aggiungi questa configurazione:

    {
      "mcpServers": {
        "metricool": {
          "httpUrl": "https://ai.metricool.com/mcp"
        }
      },
      "security": {
        "auth": {
          "selectedType": "oauth-personal"
        }
      }
    }
  4. Salva il file, avvia Gemini CLI con gemini, poi esegui:

    /mcp auth metricool
  5. Autorizza Metricool nella scheda del browser che si apre.

Autorizzazione di Metricool MCP nel browser
  1. Torna al terminale. Metricool MCP è connesso.


Articoli correlati

È stato utile?