Vai al contenuto principale

Che cos’è il Model Context Protocol?

Il Model Context Protocol (MCP) è uno standard aperto che permette agli assistenti IA (come Claude, Cursor o qualsiasi framework di agenti compatibile con MCP) di chiamare strumenti e servizi esterni durante l’esecuzione. Puoi immaginarlo come un ponte strutturato tra un modello linguistico e le API con cui deve interagire. Un server MCP è un servizio leggero che espone a un client IA un insieme di tool con un nome. Quando un assistente IA è collegato a un server MCP, può invocare quei tool in autonomia: decide quando chiamarli, passa i parametri corretti e interpreta i risultati, senza che tu debba costruire un’integrazione personalizzata da zero. Il server MCP di identifAI incapsula l’intera API REST di identifAI e la espone come una raccolta di tool pronti all’uso, che qualsiasi client compatibile con MCP può individuare e chiamare.
Poiché il server MCP è remoto e il protocollo si basa su JSON, tutti i file vengono trasferiti come stringhe codificate in base64. Questo può causare problemi con i file di grandi dimensioni (soprattutto i video), perché la codifica base64 aumenta la dimensione del payload e può superare i limiti del server o del client. Per i file di grandi dimensioni ti consigliamo vivamente di usare i tool di classificazione “da URL” (ad es. classify_image_url, classify_video_url, classify_audio_url) per evitare problemi di trasferimento e garantire un’elaborazione affidabile.

Perché usare identifAI tramite MCP?

Per i flussi di lavoro basati sull’IA

Se sviluppi o distribuisci agenti IA, chatbot o copilot, l’integrazione MCP è la via più rapida per dotarli di funzionalità di rilevamento dei contenuti generati dall’IA. Invece di scrivere codice di raccordo con l’API, descrivi un compito in linguaggio naturale e l’agente pensa al resto:
“Verifica se questa immagine è generata dall’IA prima di pubblicarla.” “Analizza questa clip audio e dimmi se è sintetica.”

Casi d’uso comuni

Moderazione dei contenuti

Blocca la pubblicazione di immagini, video o audio generati dall’IA su piattaforme social, forum, marketplace e community online.

Fact-checking e redazioni

Verifica l’autenticità di foto, video e audio nelle redazioni, nelle agenzie di stampa e nei flussi di verifica delle fonti.

Identità e KYC

Rileva deepfake e manipolazioni nei processi di onboarding, verifica dell’identità e KYC per banche, assicurazioni e fintech.

Copyright e tutela del brand

Proteggi la proprietà intellettuale e il copyright rilevando i contenuti generati dall’IA in campagne pubblicitarie, asset digitali e archivi multimediali.

Integrità pubblicitaria e antifrode

Previeni le frodi pubblicitarie e gli annunci falsi rilevando i contenuti generati dall’IA nelle campagne di marketing e nei circuiti pubblicitari.

Broadcast e media

Tutela la reputazione di emittenti, TV e radio verificando l’autenticità dei contenuti prima della messa in onda.

Vantaggi rispetto a un’integrazione REST diretta

Requisiti

Prima di collegarti al server MCP di identifAI ti servono:
  1. Un’API key di identifAI. Registrati su https://web.identifai.net, poi vai nella dashboard, fai clic sull’icona utente in alto a destra e seleziona “Api-Key”.
  2. Un client compatibile con MCP: Claude Desktop, Cursor o qualsiasi framework di agenti che supporti il Model Context Protocol.
L’API key viene passata a ogni richiesta come parametro del tool. Il server non la memorizza né la mette in cache: ogni chiamata a un tool si autentica in modo indipendente direttamente sull’API REST di identifAI.

Endpoint pubblico del server MCP

In produzione puoi collegarti direttamente al nostro server MCP pubblico all’indirizzo:
https://mcp.identifai.net
Questo endpoint è sempre disponibile e pronto a servire le richieste di qualsiasi agente o assistente compatibile con MCP. Non serve alcuna installazione locale, a meno che tu non voglia un’istanza privata. Ti basta configurare il tuo agente con https://mcp.identifai.net come URL del server MCP.

Tool disponibili

Il server espone 17 tool organizzati per tipo di media.
I job di classificazione sono asincroni. Dopo aver inviato un file o un URL, usa il tool get_*_classification corrispondente con l’ID del job restituito per interrogare periodicamente il risultato. Gli agenti compatibili con MCP lo fanno automaticamente quando chiedi loro di attendere il completamento.

Esempio di integrazione: Claude Desktop

Il modo più rapido per iniziare è collegare Claude Desktop direttamente al server MCP pubblico di identifAI, senza alcuna installazione locale.
  1. Apri (o crea) il file di configurazione di Claude Desktop:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Aggiungi il server di identifAI alla sezione mcpServers:
Assicurati di avere installato npx (incluso in Node.js) per avviare il server mcp-remote tramite comando.
  1. Riavvia Claude Desktop. Ora dovresti vedere identifAI nel pannello dei tool collegati.
  2. Nella chat di Claude Desktop prova un prompt come:
“Usando identifAI con l’API key sk-xxxxxxxx, classifica questa immagine e dimmi se è generata dall’IA: https://example.com/sample.jpg”
Claude chiamerà identifai/classify_image_url, riceverà l’ID del job, poi interrogherà automaticamente identifai/get_image_classification e restituirà il verdetto con il relativo punteggio di confidenza.
Puoi inserire l’API key direttamente nel prompt, oppure chiedere all’assistente di usare una key che hai salvato in un prompt di sistema o in una variabile d’ambiente, a seconda di come è configurato il tuo agente.

Prossimi passi

Ottieni la tua API key

Segui la guida quickstart per creare un account e ottenere la tua API key.

Esplora il riferimento API

Consulta la documentazione completa dell’API REST con tutti gli endpoint disponibili.

Classifica un'immagine

Scopri come funziona la classificazione delle immagini dall’inizio alla fine.

Classifica un video

Scopri come funziona la classificazione dei video dall’inizio alla fine.