Back to Guides

Oxomi MCP Server — Ricerca cataloghi Baustoff per agenti AI

Cerca cataloghi Oxomi, prodotti, schede tecniche e disegni CAD da agenti AI via MCP. Adapter Oxomi integrato in AnythingMCP per il commercio Baustoff tedesco.

Pre-built adapter available on AnythingMCP Cloud

Skip the self-hosted setup — install this adapter in one click with a free trial. No credit card required.

Install on Cloud — Free Trial

Ricerca cataloghi e media Oxomi con agenti AI

Oxomi è il portale dominante di cataloghi e media per il commercio Baustoff (materiali da costruzione) tedesco — usato da grossisti e aziende di Handwerk per accedere a cataloghi digitali, schede tecniche prodotto, disegni tecnici, schede di sicurezza (Sicherheitsdatenblätter), guide di posa (Verarbeitungsanleitungen) e cross-selling su centinaia di marchi fornitori.

Collegando Oxomi a MCP, il tuo agente AI può risolvere una descrizione vaga ("la vite da 80mm con la testa blu") nello SKU + scheda tecnica + fornitore esatti in pochi secondi — perfetto per personale di banco, workflow di ordine e supporto tecnico.

Setup rapido con adapter integrato

AnythingMCP include un adapter Oxomi preconfigurato. Fornisci tre credenziali al momento dell'import.

Step 1: Deploy AnythingMCP

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Step 2: Genera le credenziali API in Oxomi

Nel tuo portale Oxomi:

  1. Vai su Portal-Einstellungen → ID per trovare l'ID numerico del tuo portale
  2. Annota l'username (spesso una email) usato per l'API
  3. Genera un token API in Portal-Einstellungen → API

Step 3: Importa l'adapter

Apri http://localhost:3000/connectors/store, clicca Import sull'adapter Oxomi e compila i tre campi richiesti dal form:

  • OXOMI_PORTAL_ID
  • OXOMI_USER
  • OXOMI_ACCESS_TOKEN

Ogni valore viene cifrato a riposo.

Step 4: Connetti al tuo agente AI

{
  "mcpServers": {
    "oxomi": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Tool disponibili

| Tool | Descrizione | |------|-------------| | oxomi_search_catalogs | Trova cataloghi per fornitore o keyword | | oxomi_get_catalog_pages | Lista pagine di un catalogo con anteprime | | oxomi_get_catalog_attachments | Link di download per allegati di catalogo | | oxomi_search_products | Ricerca prodotti per SKU o testo — restituisce fornitore + URL schede | | oxomi_search_documents | Cerca schede di sicurezza, guide di posa, file CAD |

Casi d'uso AI

  • "Trova la scheda di sicurezza per Knauf Diamant Spachtel"
  • "Qual è il codice articolo della vite Würth ASSY plus VG 6×80?"
  • "Lista tutti i cataloghi Bosch utensili elettrici nel nostro portale"
  • "Mi servono guide di posa per i sistemi Saint-Gobain Rigips"

Tip

  • I risultati sono limitati alla tua sottoscrizione del portale — vedi solo i fornitori inclusi nel tuo contratto.
  • La maggior parte delle descrizioni è in tedesco; passa lang=en dove esistono traduzioni inglesi.
  • Per export massivi (migliaia di pagine catalogo), preferire l'export batch di Oxomi rispetto al tooling per-call.

Prossimi step