# Handla i Tools Universe från Claude

> Butiken är också en MCP-server: Claude kan söka i katalogen, jämföra verktyg på en batteriplattform, boka en hyrmaskin och fylla en varukorg, med samma Crystallize-data och samma personliga rankning som webbplatsen. Och varje sida är skriven för maskiner: strukturerad data, typade specifikationer med enhets- och ETIM-koder, och textversioner för språkmodeller.

- **MCP-server (Streamable HTTP):** https://tools-universe.superfast.shop/api/mcp

## Konfigurera MCP-servern

Fem minuter i Claude, en rad i Claude Code. De öppna verktygen fungerar utan konto; logga in som demokund för egna priser, historik och rekommendationer.

### Lägg till butiken i Claude

claude.ai, Claude Desktop och mobilapparna delar kopplingar. Interaktiva produktkort kräver en värd med stöd för MCP Apps; själva verktygen fungerar överallt.

1. Öppna **Inställningar → Kopplingar** (Connectors) och välj **Lägg till anpassad koppling**.
2. Kalla den ”Tools Universe” och klistra in server-URL:en ovan.
3. Låt autentiseringen stå på **Logga in vid behov**: servern svarar medvetet utan token, och bara de personliga verktygen ber dig logga in.
4. Om du tillfrågas om en OAuth-klient, låt Claude registrera sig själv. Lämna förfrågningshuvuden tomma.
5. Starta en ny chatt, öppna **+ → Kopplingar** och slå på Tools Universe.

**Claude Code:**

```
claude mcp add --transport http tools-universe https://tools-universe.superfast.shop/api/mcp
claude "Jag kör Milwaukee M18. Vilka SDS-plus-borrhammare går på batterierna jag redan har?"
```

Kör `/mcp` i en session för att logga in när ett personligt verktyg ber om det.

**Andra MCP-värdar:** Streamable HTTP, tillståndslös, OAuth 2.1 med PKCE och upptäckt på `/.well-known/oauth-protected-resource`. VS Code, Cursor, ChatGPT och MCP Inspector ansluter på samma sätt.

### Logga in som demokund

Det finns inga lösenord. Fråga något personligt så visar Claude en Anslut-knapp; butiken öppnar en sida där du väljer en av demokunderna, samma personer som kontoväljaren i sidhuvudet.

Varje kund har en riktig orderhistorik i Shop API, ett företag med yrkes- eller avtalspriser, och en marknad. Sindre, möbelsnickaren som bara kör Festool, har den tydligaste smaken; Martin sågar betong med Hilti Nuron; Lotte är helgsnickare på DeWalt XR.

- **Priser och marknad:** Priserna följer kundens marknad (EUR, NOK eller SEK) och prislista: företagskunder ser företagets yrkes- eller avtalspris, exkl. moms.
- **Personlig rankning:** Varje lista rankas med smakvektorn från deras ordrar: batteriplattformen de äger, deras yrke, utrustningen de köper.
- **Egna uppgifter:** Ordrar, hyrbokningar och offerter läses från Shop API. Varukorgar och bokningar görs för den kunden.

### Vad Claude kan göra

Verktygen speglar webbutiken. Sök- och produktverktygen ger kort med produktbild, pris och lager; varje svar länkar till samma sida i butiken.

**Katalog**

- `search_products`: Fritext plus filter: kategori, varumärke, plattform, yrke, typade specifikationer (`concrete.impactEnergy ≥ 8`), pris och lager.
- `get_product`: Allt om ett verktyg: specifikationer med enheter och ETIM-koder, utföranden och kit med innehåll, pris, lager.
- `similar_products`: Alternativ efter produkttyp, plattform och specifikationer.
- `show_products`: Kort för en lista som Claude valt själv.
- `list_categories`: Avdelningarna och produkttyperna.
- `list_brands`: De sex tillverkarna.

**Batteriplattformar**

- `battery_platforms`: Alla plattformar med spänning och varumärke; med en plattform, verktygen på den och batterierna och laddarna som passar; med ett artikelnummer, det som passar det verktyget.

**Uthyrning**

- `search_rentals`: Maskiner att hyra, med pris per dag, helg, vecka och 4 veckor.
- `rental_availability`: Lediga enheter per depå och period.

**Varukorg och kassa**

- `add_to_cart`: Lägg till ett utförande med artikelnummer; ger en varukorg du kan bygga vidare på.
- `view_cart`: Rader och summor inkl. och exkl. moms.
- `update_cart_line`: Ändra antal eller ta bort en rad.
- `suggest_add_ons`: Tillbehör, batterier och förvaring som passar det som ligger i varukorgen.
- `checkout`: En länk som öppnar varukorgen i butikens kassa.

**Inloggad** (Ber dig logga in)

- `book_rental`: Reservera en maskin i varukorgen; bekräftas i kassan.
- `whoami`: Vem du är för butiken: företag, marknad, prislista och smak.
- `my_orders`: Ordrar, hyror och offerter, med status.
- `recommendations`: Förslag rankade med din smakvektor.

### Saker att prova

- (Öppen) “Jag kör Milwaukee M18. Vilka SDS-plus-borrhammare går på batterierna jag redan har?”
- (Öppen) “Jämför 18V slagskruvdragare med minst 200 Nm, billigast först, bara det som finns i lager.”
- (Öppen) “Vilket batteri och vilken laddare behöver jag till en Makita LXT cirkelsåg? Lägg dem i en varukorg.”
- (Öppen) “Jag ska bila upp ett betonggolv i Göteborg nästa helg. Vad kan jag hyra och vad kostar det?”
- (Öppen) “What is the difference between Hilti Nuron and Milwaukee MX FUEL for demolition?”
- (Öppen) “Kärnborr för 150 mm hål: köpa, eller hyra en vecka?”
- (Inloggad) “Vad skulle du rekommendera för mig, och varför?”
- (Inloggad) “Vad har jag beställt tidigare? Vilka batterier passar verktygen jag har?”
- (Inloggad) “Boka bilningshammaren från närmaste depå från fredag till måndag.”
- (Inloggad) “Visa mina öppna offerter och hyror.”

## Byggd för att hittas av sökmotorer och språkmodeller

Att gå att ansluta till är halva jobbet. Andra halvan är att läsas rätt när någon frågar en AI-assistent om en batteridriven bilningshammare eller ett 5 Ah-batteri. Allt nedan genereras från samma Crystallize-data som sidorna, på fyra språk.

### En JSON-LD-graf på varje sida

schema.org i `<script type="application/ld+json">`, länkat med `@id` så att produkten, varumärkessidan och batteriplattformssidan beskriver en graf.

Organisationen och webbplatsen (med sökåtgärd) på startsidan; Product eller ProductGroup med en Product per utförande på produktsidor; uthyrda Products på hyrsidor; CollectionPage med ItemList på kategorier, varumärken och plattformar; BreadcrumbList överallt.

- `ProductGroup / Product`: utföranden (utan batteri, kit) med artikelnummer, GTIN och eget Offer
- `Offer`: pris inkl. och exkl. moms, mängdpriser, lager som availability och inventoryLevel, innehåll, garanti
- `category`: produkttypssökväg och ETIM-klassen som CategoryCode
- `isAccessoryOrSparePartFor · isConsumableFor`: maskinerna ett batteri, en laddare, ett blad eller ett borr är gjort för
- `DefinedTerm`: batteriplattformen, definierad på sin egen sida och refererad från varje produkt på den
- `Offer för hyra`: LeaseOut, hyrtid i timmar, depåerna som platser med adress och koordinater

### Typade fakta, inte text

Varje specifikation är en PropertyValue med ETIM-egenskapen som `propertyID`, ett numeriskt `value`, `unitText` och UN/CEFACT-koden `unitCode`, och `maxValue` eller `minValue` när fältet är en gräns. Val har alternativnyckeln och ETIM-värdekoden. Samma koder finns i Markdown-sidorna och i llms-full.txt.

| Specifikation | Värde | unitCode | ETIM |
|---|---|---|---|
| Märkspänning | 18 V | VLT | EF000002 |
| Kapacitet | 5 Ah | AMH | EF001985 |
| Vridmoment, hårt skruvförband | 230 Nm | NU | EF002842 |
| Tomgångsvarvtal | 3 400 1/min | RPM | EF011125 |
| Vikt utan batteri | 2,2 kg | KGM | EF011121 |
| Verktygsfäste | SDS-max | – | EF002843 · EV005657 |

### Ren text för språkmodeller

- **llms.txt och llms-full.txt:** En Markdown-karta över butiken (marknader, kategorier, plattformar, varumärken, uthyrning) enligt llmstxt.org, och hela katalogen i en fil med priser i tre valutor, lager, produkttyp, ETIM-klass och varje typad specifikation med koder. https://tools-universe.superfast.shop/llms.txt, https://tools-universe.superfast.shop/llms-full.txt
- **En Markdown-version av varje sida:** Lägg till `.md` på en URL, eller skicka `Accept: text/markdown`. Produktsidor listar specifikationer med enhets- och ETIM-koder, utföranden, innehåll, passar till och köps med; varje sida länkar till de andra. Annonseras i `<head>` med `rel="alternate" type="text/markdown"`. https://tools-universe.superfast.shop/sv.md
- **robots.txt med namngivna AI-crawlers:** GPTBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Google-Extended med flera tillåts med namn, med `Content-Signal: search=yes, ai-input=yes`. Varukorg, konto, API och OAuth hålls utanför. https://tools-universe.superfast.shop/robots.txt
- **Sitemap med hreflang:** Varje kategori-, produkt-, hyr-, varumärkes-, plattforms- och tekniksida på fyra språk, med översatta alternativ och senaste ändring från Crystallize. https://tools-universe.superfast.shop/sitemap.xml
- **Canonical och hreflang:** Sökvägarna är översatta per språk, så alternativen slås upp på item-id. Filtrerade kategorivyer pekar canonical på den rena kategorin; sökresultat är noindex.
- **Metadata i HTML för robotar:** Next.js strömmar metadata efter första byten. För crawlers som läser HTML utan att köra JavaScript (sökmotorer och AI-agenter) lägger `htmlLimitedBots` titel, beskrivning, canonical och hreflang i `<head>`.

Kontrollera själv: klistra in en produkt-URL i Claude med webbåtkomst och fråga efter spänning, vikt och pris inkl. moms, eller öppna sidans `.md`-version.

---

Webbsida: https://tools-universe.superfast.shop/sv/mcp
Markdown-version av sidan, för språkmodeller. Priserna är netto (exkl. moms) om de inte är märkta inkl. moms.
