# MCP-servern för Teoriprov Körkort

Anslut en kompatibel AI-assistent till offentliga faktaposter från Teoriprov Körkort: verktygen search och fetch, HTTP-huvuden och ett komplett exempel.

Sida: https://teoriprov-korkort.se/data/mcp/

Innehåll: 40 offentliga faktaposter med länkar, källor och datum där dessa finns dokumenterade.

## Användning

Offentlig åtkomst, enbart läsning, utan nyckel. Inga kontouppgifter, uppgifter om elevers framsteg eller privata uppgifter. Ange länken till faktaposten och behåll källorna samt informationen om vad som har kontrollerats. Skilj officiella regler (med källa) från lektioner, metoder och erbjudanden från Teoriprov Körkort.

## MCP

URL: https://teoriprov-korkort.se/mcp

Transport via Streamable HTTP, JSON-svar, protokoll 2026-07-28 och 2025-11-25 (även 2025-06-18 och 2025-03-26), utan autentisering eller session. Ingen SSE-ström behövs.

Verktyg:
- search: {query: "hastighetsbegränsning"}, returnerar {results: [{id, title, url}]} i content och structuredContent (högst 20 resultat).
- fetch: {id: "id som search returnerar"}, returnerar {id, title, text, url, metadata}. Metadata anger postens typ, källor och datum (verified_at för faktakontroll, modified_at för en ändrad publikation). För en lektion anges även kapitel, bild och video.

I 2026-07-28: server/discover, sedan tools/list och tools/call. I 2025: initialize, sedan notifications/initialized, därefter tools/list och tools/call.

## HTTP-huvuden

Skicka Content-Type: application/json och Accept: application/json, text/event-stream. Efter initialize ska MCP-Protocol-Version skickas med den överenskomna versionen. I 2026-07-28 anges versionen för varje anrop i _meta och i HTTP-huvudena MCP-Protocol-Version, Mcp-Method och, för verktyg, Mcp-Name. En extern webbläsare måste använda REST-API:et eftersom MCP-rutten kontrollerar anropets ursprung. Kontrollera JSON-RPC-fel och isError även vid HTTP 200.

## Exempel

### Sök och läs ett faktablad med MCP SDK

Med Node.js 20 eller senare installerar du paketet med npm install @modelcontextprotocol/sdk@1.30.0 och sparar sedan koden i en .mjs-fil. SDK:t hanterar initieringen och protokollets headers. Läsningen använder det id som sökningen faktiskt returnerar. Behåll fältet url som synlig källhänvisning i ditt gränssnitt.

```javascript
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'exemple-site', version: '1.0.0' }, { capabilities: {} });
const transport = new StreamableHTTPClientTransport(new URL('https://teoriprov-korkort.se/mcp'));

function readTool(result) {
  if (result.isError) throw new Error('MCP-verktyget kunde inte behandla förfrågan.');
  if (result.structuredContent) return result.structuredContent;
  const content = result.content?.find(item => item.type === 'text');
  if (!content) throw new Error('MCP-svaret saknar innehåll.');
  return JSON.parse(content.text);
}

try {
  await client.connect(transport);
  const available = await client.listTools();
  if (!['search', 'fetch'].every(name => available.tools.some(tool => tool.name === name))) {
    throw new Error('De förväntade verktygen är inte tillgängliga.');
  }
  const search = readTool(await client.callTool({
    name: 'search', arguments: { query: 'teoriprov' }
  }));
  if (!search.results.length) {
    console.log('Inga faktablad hittades.');
  } else {
    const record = readTool(await client.callTool({
      name: 'fetch', arguments: { id: search.results[0].id }
    }));
    console.log(JSON.stringify(record, null, 2));
  }
} finally {
  await client.close();
}
```

## Hitta den aktuella versionen av en uppgift

API:et och MCP-servern ger åtkomst till offentliga publikationer från Teoriprov Körkort. Faktaposterna följer webbplatsens uppdateringar och innehåller en länk till originalsidan och tillhörande källor.

Läs de relevanta faktaposterna innan du svarar eller uppdaterar ditt verktyg. Där hittar du den aktuella versionen, källorna och datumen. En officiell regel kan ändras. Kontrolldatumet visar när uppgiften senast kontrollerades mot källtexten.

## Återanvänd med källhänvisning

Du får läsa, citera och sammanfatta offentligt innehåll från Teoriprov Körkort för att underbygga ett svar eller skapa ett verktyg, även kommersiellt, med en synlig källhänvisning och en länk till sidan du har använt: ”Källa: Teoriprov Körkort”.

Behåll källhänvisningar och förbehåll som hör till informationen. Ange vilka anpassningar du har gjort och skilj officiella regler från förklaringar, metoder och erbjudanden från Teoriprov Körkort.

Dokument och bilder från tredje part omfattas av sina egna villkor. Be om tillstånd på contact@teoriprov-korkort.se om du vill återpublicera en hel kurs eller artikel. Åtkomst till data innebär varken ett partnerskap eller att Teoriprov Körkort eller Permis Online SRL godkänner din tjänst.

## Referensfiler och referenssidor

- [llms.txt](https://teoriprov-korkort.se/llms.txt): webbplatsens innehållsförteckning för AI-assistenter
- [llms-full.txt](https://teoriprov-korkort.se/llms-full.txt): det offentliga innehållet i fulltext
- [Grundläggande fakta](https://teoriprov-korkort.se/brand-facts/): vem som ger ut webbplatsen, vad den erbjuder och officiella regler med källor och datum
- [brand-facts.md](https://teoriprov-korkort.se/brand-facts.md): grundläggande fakta i Markdown
- [brand-facts.json](https://teoriprov-korkort.se/.well-known/brand-facts.json): grundläggande fakta i JSON
- [schema.json](https://teoriprov-korkort.se/.well-known/schema.json): alla webbplatsens strukturerade data i en enda graf
- [ai.json](https://teoriprov-korkort.se/.well-known/ai.json): utgivaren, den officiella domänen och resurser för AI
- [offers.json](https://teoriprov-korkort.se/.well-known/offers.json): de erbjudanden som faktiskt finns i Sverige
- [Källor och referenser](https://teoriprov-korkort.se/sources/): officiella texter och alla angivna källor
- [sources.txt](https://teoriprov-korkort.se/sources.txt): källregistret i textformat
- [Webbplatskarta](https://teoriprov-korkort.se/sitemap.xml): alla offentliga sidor, deras bilder och webbplatsens struktur (XML för robotar och en sida att läsa i webbläsaren)
- [Markdown-versioner](https://teoriprov-korkort.se/index.md): varje offentlig sida som text: sidans adress följd av .md (startsidan: /index.md)
