# Collega il tuo agente tramite MCP

[HTML](https://pdfcraft.ai/it-IT/docs/getting-started/mcp/)
[Site index](https://pdfcraft.ai/llms.txt)

Converti e traduci file PDF ed EPUB con il tuo agente IA e PDFCraft.


Collega PDFCraft a un agente IA che supporti server MCP remoti. Il tuo agente potrà convertire PDF in Markdown o EPUB, tradurre PDF e libri EPUB, controllare il saldo, stimare i costi e recuperare i risultati.

## Configura la connessione

1. Crea la tua API Key in [OOMOL Console](https://console.oomol.com/api-key).
2. Aggiungi un server MCP remoto nelle impostazioni dell’agente. Inserisci `https://api.pdfcraft.ai/v1/mcp` come URL e scegli Streamable HTTP come trasporto.
3. Aggiungi l’header `Authorization: Bearer YOUR_API_KEY`, sostituendo `YOUR_API_KEY` con la tua chiave.

Questo JSON mostra i dati di connessione. I nomi dei campi dipendono dal client: inserisci questi valori nelle impostazioni dell’URL e degli header HTTP.

```json
{
  "url": "https://api.pdfcraft.ai/v1/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}
```

Conserva la chiave nelle impostazioni protette del client. Non incollarla nelle conversazioni e non inserirla nei link ai file. Le conversioni consumano crediti PDFCraft; puoi [ricaricare qui](https://pdfcraft.ai/it-IT/recharge/).

## Verifica la compatibilità

Il servizio usa Streamable HTTP con la versione `2026-07-28` del protocollo MCP. Il client deve supportare questa versione e consentire header di autenticazione Bearer personalizzati. I vecchi flussi di inizializzazione e sessione del 2025 non sono supportati.

Non è disponibile l’accesso interattivo tramite OAuth. I client che richiedono OAuth e non consentono di inviare una API Key come Bearer non possono collegarsi direttamente.

## Prova la prima conversione

Dopo la connessione, l’agente può individuare gli strumenti e leggere le istruzioni. Chiedigli di chiamare prima `get_capabilities` per conoscere formati, lingue e passaggi supportati. Ad esempio:

> Converti questo PDF in EPUB. Prima di iniziare, controlla il mio saldo e stima il costo.

L’agente deve poter leggere e caricare il contenuto del file: il solo percorso locale non basta al server remoto. Potrà poi creare un’attività, caricare il file, avviare l’elaborazione, controllare l’avanzamento e ottenere un link per il download. Conserva l’UUID dell’attività per riprenderla in seguito.

Per impostazione predefinita viene scaricato il file completo. Se un importo dovuto blocca il download, ricarica il saldo e richiedi un nuovo link per la stessa attività. Un file incompleto viene fornito solo su richiesta esplicita e se ne esiste una versione disponibile.

Per integrare il servizio direttamente nella tua applicazione, consulta il [riferimento dell’API REST](https://pdfcraft.ai/it-IT/docs/api/overview/).