> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Server MCP

> Collega agenti e assistenti IA direttamente a identifAI tramite il Model Context Protocol.

## 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.

> [!NOTE]
>
> 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

> [card] Moderazione dei contenuti
>
> Blocca la pubblicazione di immagini, video o audio generati dall'IA su piattaforme social, forum, marketplace e community online.

> [card] 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.

> [card] Identità e KYC
>
> Rileva deepfake e manipolazioni nei processi di onboarding, verifica dell'identità e KYC per banche, assicurazioni e fintech.

> [card] 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.

> [card] 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.

> [card] 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

| | API REST | Server MCP |
| - | - | - |
| Impegno di integrazione | Codice client HTTP personalizzato | Nessun codice di raccordo: basta aggiungerlo alla configurazione dell'agente |
| Adatto agli agenti | Richiede di incapsulare i tool a mano | Individuabile nativamente dai client MCP |
| Multimodale | Endpoint separati per ogni tipo | Tutti i 17 tool in un unico server |
| Polling asincrono | Ciclo di polling manuale | Il tool gestisce il flusso |

## Requisiti

Prima di collegarti al server MCP di identifAI ti servono:

1. **Un'API key di identifAI.** Registrati su [https://web.identifai.net](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.

> [!NOTE]
>
> 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](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.

> [accordion] Tool per le immagini (6)
>
> | Tool | Descrizione |
> | - | - |
> | `identifai/classify_image` | Invia un file immagine per la classificazione dei contenuti generati dall'IA |
> | `identifai/classify_image_url` | Invia l'URL di un'immagine per la classificazione dei contenuti generati dall'IA |
> | `identifai/get_image_classification` | Recupera il risultato di una classificazione tramite ID |
> | `identifai/get_all_image_classifications` | Recupera i risultati di più classificazioni di immagini |
> | `identifai/get_classification_heatmap` | Ottieni una heatmap che evidenzia le aree generate dall'IA |
> | `identifai/override_image_classification` | Esegui manualmente l'override del risultato di una classificazione |

> [accordion] Tool per i video (5)
>
> | Tool | Descrizione |
> | - | - |
> | `identifai/classify_video` | Invia un file video per la classificazione dei contenuti generati dall'IA |
> | `identifai/classify_video_url` | Invia l'URL di un video per la classificazione dei contenuti generati dall'IA |
> | `identifai/get_video_classification` | Recupera il risultato della classificazione di un video tramite ID |
> | `identifai/get_all_video_classifications` | Recupera i risultati di più classificazioni di video |
> | `identifai/override_video_classification` | Esegui manualmente l'override del risultato della classificazione di un video |

> [accordion] Tool per l'audio (5)
>
> | Tool | Descrizione |
> | - | - |
> | `identifai/classify_audio` | Invia un file audio per la classificazione dei contenuti generati dall'IA |
> | `identifai/classify_audio_url` | Invia l'URL di un audio per la classificazione dei contenuti generati dall'IA |
> | `identifai/get_audio_classification` | Recupera il risultato della classificazione di un audio tramite ID |
> | `identifai/get_all_audio_classifications` | Recupera i risultati di più classificazioni di audio |
> | `identifai/override_audio_classification` | Esegui manualmente l'override del risultato della classificazione di un audio |

> [accordion] Tool per l'utente (1)
>
> | Tool | Descrizione |
> | - | - |
> | `identifai/get_user_credits` | Recupera il saldo dei crediti rimanenti del tuo account |

> [!TIP]
>
> 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`:

```json theme={null}
{
  "mcpServers": {
    "identifAI": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.identifai.net/"]
    }
  }
}
```

> [!NOTE]
>
> Assicurati di avere installato `npx` (incluso in Node.js) per avviare il server mcp-remote tramite comando.

3. Riavvia Claude Desktop. Ora dovresti vedere **identifAI** nel pannello dei tool collegati.
4. 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](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.

> [!NOTE]
>
> 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

> [card] [Ottieni la tua API key](https://docs.identifai.net/it/quickstart.md)
>
> Segui la guida quickstart per creare un account e ottenere la tua API key.

> [card] [Esplora il riferimento API](https://docs.identifai.net/it/api-reference/introduction.md)
>
> Consulta la documentazione completa dell'API REST con tutti gli endpoint disponibili.

> [card] [Classifica un'immagine](https://docs.identifai.net/it/classification/classify-image.md)
>
> Scopri come funziona la classificazione delle immagini dall'inizio alla fine.

> [card] [Classifica un video](https://docs.identifai.net/it/classification/classify-video.md)
>
> Scopri come funziona la classificazione dei video dall'inizio alla fine.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.