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:- 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”.
- 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.netQuesto 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.Tool per le immagini (6)
Tool per le immagini (6)
Tool per i video (5)
Tool per i video (5)
Tool per l'audio (5)
Tool per l'audio (5)
Tool per l'utente (1)
Tool per l'utente (1)
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.- 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
- macOS:
- 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.- Riavvia Claude Desktop. Ora dovresti vedere identifAI nel pannello dei tool collegati.
- 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.