API & MCP
Un account. Tre accessi: REST, MCP e llms.txt.
Gli stessi oltre 300 strumenti API/MCP — che si integri tramite REST, si lavori in un client AI tramite MCP o si passi llms.txt.
Un account, ospitato in UE: dietro ogni accesso si trova lo stesso Document Layer.
- Infrastruttura EU proprietaria I suoi dati rimangono in Europa.
- ISO 27001 attivo Sicurezza certificata.
- SOC 2 Type II attivo Standard internazionali per audit.
- Oltre 24 anni di esperienza Collaudato. Stabile. Futuro garantito.
Showroom
Cosa si può costruire con PaperOffice
Dalla singola chiamata API all'Agent Document: il Showroom mostra applicazioni, prompt e ricette tecniche.
Verifica e approvazione autonoma delle fatture
Estrazione, riconciliazione con i fornitori, rilevamento dei duplicati, approvazione e risultato conforme alle normative in un'unica procedura.
Document AIVerifica dei contratti per i rischi
Rilevamento automatico di clausole, scadenze e deviazioni.
ComplianceValidazione degli indirizzi
Estrarre, geocodificare e verificare i dati del documento.
TransformationPreparare i PDF per gli agenti
OCR, struttura e metadati per sistemi downstream.
KnowledgeInterrogare la conoscenza in tempo reale
Ottenere risposte dal corpus documentale corrente invece che da copie.
Avvio rapido
Dal prompt alla prima chiamata API
Nessuna documentazione da leggere: l'agente di codifica legge llms.txt e conosce subito funzionalità, autenticazione ed endpoint.
- Passare llms.txt L'agente legge la descrizione in formato machine-readable di API.
- Collegare l'account Un account per REST e MCP, un token nell'intestazione.
- Descrivere l'applicazione Descrivere in linguaggio naturale cosa deve essere creato.
Read https://api.paperoffice.ai/latest/docs/llms.txt and understand the available Document Operations.
Then build a workflow that:
1) Analyses incoming invoices
2) Checks required fields
3) Returns the result as structured JSON
4) Uses Authorization: Bearer po_ut_YOUR_API_KEYAPI compreso · pronto per la prima chiamata API
curl -X POST \ "https://api.paperoffice.ai/latest/job/add/workflow" \ -H "Authorization: Bearer po_ut_YOUR_API_KEY" \ -F "[email protected]" \ -F "idp_collection=invoice" \ -F "model=basic-pro-max"import requestsresponse = requests.post( "https://api.paperoffice.ai/latest/job/add/workflow", headers={"Authorization": "Bearer po_ut_YOUR_API_KEY"}, files={"file_1": open("invoice.pdf", "rb")}, data={"idp_collection": "invoice", "model": "basic-pro-max"},)print(response.json())const form = new FormData();form.append("file_1", new Blob([await readFile("invoice.pdf")]), "invoice.pdf");form.append("idp_collection", "invoice");form.append("model", "basic-pro-max");const response = await fetch("https://api.paperoffice.ai/latest/job/add/workflow", { method: "POST", headers: { Authorization: "Bearer po_ut_YOUR_API_KEY" }, body: form,});console.log(await response.json());<?php$ch = curl_init("https://api.paperoffice.ai/latest/job/add/workflow");curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer po_ut_YOUR_API_KEY"], CURLOPT_POSTFIELDS => [ "file_1" => new CURLFile("invoice.pdf"), "idp_collection" => "invoice", "model" => "basic-pro-max", ],]);echo curl_exec($ch);Prima chiamata API
Come appare la prima chiamata API
Una richiesta POST su /latest/job/add/workflow con file, raccolta e modello — oltre a un token Bearer nell'intestazione. Non serve altro.
- Un'intestazione
Authorization: Bearer po_ut_YOUR_API_KEY — nessun flusso OAuth, nessuna logica di refresh, nessuna necessità di SDK.
- Una pipeline per chiamata
Il percorso dopo /latest/job/add/ indica la pipeline; workflow restituisce IDP strutturato.
- Risultato o job_id
Per default mantiene API la connessione e restituisce il risultato inline; altrimenti viene restituito HTTP 202 con job_id e poll_url.
Tre accessi
Come PaperOffice si integra nello stack
Utilizzi esattamente l'accesso di cui il prodotto o l'agente ha bisogno. Il documento rimane la fonte affidabile.
Per prodotti personalizzati
Chiama le operazioni sui documenti direttamente da backend, workflow o SaaS.
- API basato su JSON
- Job asincroni
- Webhook ed eventi
Per agenti AI
Porta PaperOffice nativamente in Claude, ChatGPT, Cursor e altri client MCP.
- Scoperta degli strumenti
- Accesso ai documenti in tempo reale
- Azioni controllate
Per agenti di codifica
L'agente di codifica comprende immediatamente funzionalità, autenticazione ed esempi.
- Nessun SDK richiesto
- Documento leggibile da macchina
- Direttamente copiabile
Domande
Domande frequenti su API e MCP
Qual è la differenza tra REST, MCP e llms.txt?
REST è l'interfaccia per i prodotti propri, il server MCP porta gli stessi strumenti nei client AI come Claude, ChatGPT o Cursor, e llms.txt descrive entrambi in modo leggibile da macchina per gli agenti di codifica. Tutti e tre gli accessi funzionano sullo stesso account e sullo stesso livello documentale.
Ho bisogno di un SDK?
No. La API è HTTP e JSON, basta un qualsiasi client HTTP. Per gli agenti di codifica, la descrizione leggibile dalla macchina si trova all'indirizzo https://api.paperoffice.ai/latest/docs/llms.txt.
Come mi autentico?
Con un token nell'intestazione HTTP: Authorization: Bearer po_ut_YOUR_API_KEY. Quali tipi di chiavi esistono e a cosa si applicano sono indicati nella pagina Autenticazione & Chiavi.
Dove trovo esempi pronti?
Nel Cookbook ci sono prompt e esempi di codice copiabili; la raccolta Postman contiene gli stessi endpoint per provarli direttamente.
Prossima fermata
Come procedere
Il prossimo passo consigliato nel funnel degli sviluppatori e due diramazioni pertinenti.
