Smaltera MCP Server

Connectez Claude Desktop (ou tout client MCP) au catalogue de votre magasin Smaltera. Accès lecture seule : recherche de produits, fiches détaillées, collections, devis estimatifs et informations du magasin.

Prérequis

• Node.js 20 ou plus
• Un client MCP (Claude Desktop, par ex.)
• Un token MCP, obtenu dans votre admin Smaltera → Paramètres → Connexion IA

Installation (Claude Desktop)

Ajoutez ce bloc à votre configuration Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json sur macOS) :

{
  "mcpServers": {
    "smaltera": {
      "command": "npx",
      "args": ["-y", "@smaltera/mcp-server"],
      "env": {
        "SMALTERA_TOKEN": "smal_mcp_votre-token-ici"
      }
    }
  }
}

Redémarrez Claude Desktop. Le catalogue Smaltera est désormais accessible.

Variables d'environnement

| Variable | Requis | Défaut | Rôle | |---|---|---|---| | SMALTERA_TOKEN | oui | — | Token d'accès créé dans l'admin Smaltera | | SMALTERA_API_URL | non | https://app.smaltera.com | Origine de l'instance Smaltera |

Outils disponibles

• search_products — Recherche par matériau, format, prix, antidérapance, stock, marque…
• get_product_details — Fiche complète à partir d'une référence interne
• list_collections — Parcourir les collections (familles de produits)
• get_collection — Détail d'une collection et de ses produits (par slug)
• list_suppliers — Fournisseurs, marques distribuées et nombre de produits
• estimate_quote — Calcul des boîtes, palettes et prix HT pour une surface donnée
• get_shop_info — Coordonnées du magasin

Exemples de questions

« Trouve-moi des carreaux effet marbre 60x60 sous 80€/m² en stock. » « Combien de boîtes pour 18 m² de Carrara Bianco ? » « Quelles sont les coordonnées du magasin ? »

Développement

pnpm install
pnpm build        # bundle dans dist/ via tsup
pnpm typecheck

Lancer en local contre une instance de dev :

SMALTERA_API_URL=http://localhost:3000 \
SMALTERA_TOKEN=smal_mcp_... \
node dist/index.js

Licence

MIT