Server MCP per assistenti AI

Cosa puoi chiedere

Quali dei miei siti impostano cookie prima che un visitatore acconsenta, e cosa devo correggere per primo?
Scansiona tutti i siti dei clienti e fammi un breve report per ogni cliente, per la nostra riunione mensile.
Su shop.example.com sono comparsi nuovi cookie dall'ultima scansione? Chi li imposta?
Quanti visitatori hanno accettato il banner su example.com il mese scorso, e da quali paesi?
Un visitatore mi ha mandato l'ID di consenso 1b4e28ba-2fa1-41d2-883f-0016d3cca427. A cosa ha acconsentito, e quando?
Confronta i tassi di accettazione di tutti i miei siti e dimmi quale banner va peggio.
Controlla il contenitore Tag Manager di example.com e correggi i tag che partono prima del consenso.

L'assistente legge i tuoi siti, le scansioni e il registro dei consensi tramite gli strumenti qui sotto. Può avviare una scansione o pubblicare un sito solo quando glielo chiedi, e i client migliori ti chiedono prima una conferma.

Collega

Ti serve una chiave. Un proprietario o un amministratore la crea in Impostazioni, Chiavi API. Inizia con cmk_; la mostriamo una volta sola, quindi copiala subito. Il server si trova qui:

https://cookiemark.com/mcp

Claude Code

claude mcp add --transport http cookiemark https://cookiemark.com/mcp \
  --header "Authorization: Bearer cmk_..."

Cursor, Windsurf e altri client con un file di impostazioni

{
  "mcpServers": {
    "cookiemark": {
      "url": "https://cookiemark.com/mcp",
      "headers": { "Authorization": "Bearer cmk_..." }
    }
  }
}

Claude Desktop

Aggiungi Cookiemark a claude_desktop_config.json tramite il piccolo bridge mcp-remote, che richiede Node.js:

{
  "mcpServers": {
    "cookiemark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cookiemark.com/mcp", "--header", "Authorization: Bearer cmk_..."]
    }
  }
}

Riavvia Claude Desktop e Cookiemark compare tra i suoi strumenti.

Gli strumenti

Strumento	Cosa fa
`list_sites`	Tutti i siti, con l'indicazione se il banner è online e un riepilogo dell'ultima scansione.	Lettura
`get_scan_report`	L'ultima scansione di un sito: i problemi e come risolverli, i controlli, tutti i cookie e gli ID di tracciamento trovati.	Lettura
`find_new_cookies`	I cookie trovati dall'ultima scansione che non sono ancora nell'elenco dei cookie, con una categoria suggerita.	Lettura
`consent_stats`	Come hanno risposto i visitatori in un certo numero di giorni: accettato, rifiutato, scelta personalizzata, il tasso di accettazione e i paesi principali.	Lettura
`get_consent_log`	Le scelte su un sito, dalla più recente, per un periodo che scegli tu.	Lettura
`find_consent`	Tutte le scelte fatte con un ID di consenso, per rispondere a un visitatore che chiede a cosa ha acconsentito.	Lettura
`start_scan`	Avvia una nuova scansione di un sito. Una scansione per sito ogni dieci minuti.	Modifica
`publish_site`	Mette online la bozza attuale di un sito.	Modifica
`gtm_check`	Controlla il consenso nel contenitore Google Tag Manager del sito ed elenca cosa non va.	Lettura
`gtm_prepare_fix`	Mette la correzione in una nuova area di lavoro di Tag Manager che puoi vedere in anteprima. Non va online niente.	Modifica
`gtm_publish_fix`	Pubblica la correzione in attesa e avvia una scansione per verificarla.	Modifica

Ogni strumento che riguarda un sito accetta il suo dominio, per esempio example.com, oppure il suo ID da list_sites.

Chiavi e sicurezza

Una chiave appartiene a una sola organizzazione e vede solo i suoi siti.
L'assistente non può modificare i testi, l'aspetto o l'elenco dei cookie. Quello lo fai nella dashboard.
Una chiave può fare 120 richieste al minuto. Revocala in Impostazioni, Chiavi API e l'assistente perde subito l'accesso.
Tratta la chiave come una password: chiunque la abbia può leggere il tuo registro dei consensi.

Per gli sviluppatori

Il server parla MCP su Streamable HTTP senza sessioni: invia con POST un messaggio JSON-RPC o un batch a /mcp con la chiave come Bearer token, e ogni richiesta riceve una risposta JSON. Supporta le versioni del protocollo 2025-06-18, 2025-03-26 e 2024-11-05. Gli strumenti di sola lettura hanno readOnlyHint; publish_site ha destructiveHint.