API e MCP server per
l’AI on-premise.

Usa l’endpoint OpenAI-compatibile della box, collega i tuoi dati locali e pubblica MCP server nel registry IntelligenceBox senza cambiare stack.

Leggi la guida API Costruisci un MCP server

Quick startOn-prem

cURL

# Il Box serve il proprio modello:
# elencalo con GET /api/v1/models
curl -X POST "$BOX_URL/api/v1/chat/completions" \
  -H "Authorization: Bearer $IBX_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "role": "user", "content": "Dammi un riassunto dei log di oggi" }
    ]
  }'

Base URL

$BOX_URL/api/v1

Base URL per gli SDK compatibili OpenAI

Auth

JWT o x-api-key

Configurazione e permessi

Tutto quello che ti serve per integrare.

Documentazione completa

Endpoint OpenAI-compatibile

POST /api/v1/chat/completions per il modello locale. Per documenti, strumenti e cronologia usa /api/ai/chat.

Upload sicuro on-prem

Carica file con /api/public/vectors/:id/files e cerca i passaggi con /api/public/vectors/:id/search.

Registry pubblico

Catalogo assistenti e MCP accessibile via /api/open/catalog e /api/open/mcps/:id/manifest.

Upload, indicizzazione, query.

Crea una cartella, carica un file e verifica lo stato di indicizzazione. Cerca i passaggi nell’archivio con l’API di ricerca; per una risposta generata sulle fonti usa l’API di chat con l’ID della cartella.

# FOLDER_ID: ID di una cartella autorizzata
# DOCUMENT_PATH: percorso del file da caricare
curl -X POST "$BOX_URL/api/public/vectors/$FOLDER_ID/files" \
  -H "x-api-key: $IBX_API_KEY" \
  -F "file=@$DOCUMENT_PATH"

curl -X POST "$BOX_URL/api/public/vectors/$FOLDER_ID/search" \
  -H "x-api-key: $IBX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "penali di recesso",
    "limit": 5
  }'

Distribuisci i tuoi tools come MCP server.

Costruisci un server MCP, pubblicalo su Docker registry e registralo in IntelligenceBox. Gli assistenti potranno invocare i tuoi tools con privilegi controllati.

1Parti dalla guida MCP e definisci gli strumenti necessari alla tua integrazione.
2Implementa le chiamate nel tuo server (REST, SOAP, DB) e esponi i tools nel manifest MCP.
3Containerizza (Docker) e pubblica l’immagine su un registry accessibile.
4Configura il server nella Box e abilita gli strumenti per gli assistenti che devono usarli.

Riferimento API Endpoint chat Guida MCP Catalogo pubblico

Autenticazione e policy in un unico posto.

Genera API key dedicate via `/auth/api-key/*`, limita l’accesso agli endpoint MCP e controlla le sorgenti dati. Ogni server MCP viene eseguito nel perimetro della box o su infrastruttura approvata.

JWT + x-api-keyRete internaAudit log

OpenAI compatibile

Funziona con SDK OpenAI standard (Node/Python).

MCP manifest

Manifest JSON per tools, resources e endpoints sicuri.

Docker-first

Pubblica l’immagine MCP su GHCR o registry privato.

Riferimento API

Autenticazione, richieste e risposte documentate per ogni risorsa.

Porta i tuoi workflow in IntelligenceBox.

Integra dati locali, pubblica MCP server e abilita assistenti sicuri per i tuoi team. Il team engineering può partire da subito con le guide qui sopra.

Parla con noi Apri la documentazione

API e MCP server per l’AI on-premise.