# MCP-server för svensk bolagsdata: så ansluter du Bolagskvarnen i Claude, ChatGPT, Cursor och andra AI-verktyg

Granskad 2026-11-13 av Bolagskvarnen.

**Kort svar:** Bolagskvarnens MCP-server ligger på https://app.bolagskvarnen.se/mcp (Streamable HTTP) och har sex verktyg som läser bolag, styrelse, historik och bokslut. Riktig bolagsdata öppnar senare. I dag svarar servern ur en sandlåda med påhittade bolag, och den når du med en gratis testnyckel i Claude Code, Cursor, VS Code och Codex (2026-11-13).

Skriven av Bolagskvarnen. Klienternas steg är kontrollerade i deras egen dokumentation 2026-11-13, och serverns uppgifter i dess egen metadata samma dag.

## Vad servern gör

MCP (Model Context Protocol) är ett öppet protokoll som låter en AI-assistent anropa verktyg hos någon annan. När Bolagskvarnens MCP-server är ansluten kan du fråga Claude, ChatGPT eller agenten i din editor om ett svenskt bolag, och assistenten hämtar svaret ur registret i stället för att gissa ur minnet.

| Uppgift | Värde |
|---|---|
| Adress | `https://app.bolagskvarnen.se/mcp` |
| Transport | Streamable HTTP (inte den äldre SSE-transporten) |
| Inloggning | OAuth 2.1 med PKCE, eller en API-nyckel i rubriken `Authorization: Bearer` |
| Klientregistrering | Dynamisk registrering (`/oauth/register`) eller metadatadokument för klienten |
| Behörigheter (scopes) | `companies:read`, `roles:read`, `history:read`, `financials:read`, `persons:read` |
| Verktyg | Sex, alla läser bara. Inget verktyg ändrar något |

Servern har samma data, priser och gränser som REST-API:t. Uppgifterna kommer från Bolagsverket och SCB, och varje svar säger varifrån datan kommer och vad anropet kostade.

### De sex verktygen

- `gb_search_companies`: Upp till tio bolag som matchar ett namn eller ett organisationsnummer. **Gratis, upp till 1 000 sökningar per dygn.**
- `gb_get_company`: Namn, bolagsform, status, säte och bransch. Med `detail: "full"` även adresser, F-skatt, moms, verksamhet, tidigare namn och aktiekapital. **0,10 kr, hela profilen 0,15 kr.**
- `gb_get_company_roles`: Styrelse, vd, suppleanter, revisor och firmateckningen som text. **0,10 kr.**
- `gb_get_company_history`: Registrerade ändringar sedan ett datum, och statushistorik. **0,10 kr.**
- `gb_get_financials`: Bokslut och nyckeltal för upp till fem år, för aktiebolag. **0,10 kr.**
- `gb_get_person_engagements`: En persons uppdrag i andra bolag, utifrån ett `person_ref` ur rollsvaret. **0,10 kr.**

Personer anges med ett `person_ref`, ett id som är bundet till ditt konto, aldrig med personnummer. Inte hittat kostar ingenting, och sandlådan är gratis.

## Vad som fungerar i dag

Riktig bolagsdata (live) öppnar senare. Fram till dess svarar servern på två sätt beroende på hur klienten loggar in:

- **Med en testnyckel** (`gb_test_…`) svarar alla verktyg ur sandlådan, som har sju påhittade bolag i samma format som live. Det fungerar nu, och det kostar ingenting.
- **Med OAuth** loggar du in med ditt konto. En sådan anslutning räknas alltid som live, så verktygen svarar med felet `blocked_by_phase` tills riktig data öppnar.

Om du kan prova i dag hänger alltså på om klienten kan skicka en egen nyckel i en rubrik:

| Klient | Testnyckel i rubrik (sandlådan nu) | OAuth (när live öppnar) | Guide |
|---|---|---|---|
| Claude Code | Ja, `--header` | Ja, `/mcp` | [Claude](/guider/bolagsdata-i-claude/) |
| Claude.ai och Claude Desktop | Bara om organisationen har betafunktionen Request headers | Ja, anpassad connector | [Claude](/guider/bolagsdata-i-claude/) |
| ChatGPT | Nej, OpenAI beskriver inget sådant fält | Ja, på webben i Business, Enterprise och Edu, och i Pro för verktyg som bara läser | [ChatGPT och Codex](/guider/bolagsdata-i-chatgpt/) |
| Codex | Ja, `bearer_token_env_var` | Ja, `codex mcp login` | [ChatGPT och Codex](/guider/bolagsdata-i-chatgpt/) |
| Cursor | Ja, `headers` i `mcp.json` | Ja | [Cursor och VS Code](/guider/bolagsdata-i-cursor/) |
| VS Code med Copilot | Ja, `headers` i Copilots konfiguration | Enligt VS Code: följ serverns anvisningar | [Cursor och VS Code](/guider/bolagsdata-i-cursor/) |

Uppgifterna om klienterna kommer från deras egen dokumentation, läst 2026-11-13. Klienterna ändras ofta, så kontrollera där om en meny inte heter som här.

## Hämta en testnyckel

1. Skapa ett konto på [app.bolagskvarnen.se/registrera](https://app.bolagskvarnen.se/registrera) med ditt företags organisationsnummer och din jobbmejl, och bekräfta mejladressen.
2. Gå till Konto, Nycklar, och välj Skapa nyckel med miljön Test. Testnycklar fungerar direkt, också medan vi granskar kontot.
3. Spara nyckeln på ett ställe där klienten kan läsa den, helst som miljövariabel. I exemplen heter den `BOLAGSKVARNEN_KEY`:

```bash
export BOLAGSKVARNEN_KEY="gb_test_…"
```

Nyckeln visas bara en gång. Lägg den aldrig i en fil som checkas in i ett repo.

## Anslut på en minut i Claude Code

Det kortaste sättet att se servern svara är Claude Code i terminalen:

```bash
claude mcp add --transport http bolagskvarnen https://app.bolagskvarnen.se/mcp \
  --header "Authorization: Bearer $BOLAGSKVARNEN_KEY"
```

Starta Claude Code och skriv `/mcp`. Där ska `bolagskvarnen` stå som ansluten med sex verktyg. Stegen för övriga klienter, med skärmarnas namn och de fel som brukar uppstå, står i guiderna för [Claude](/guider/bolagsdata-i-claude/), [ChatGPT och Codex](/guider/bolagsdata-i-chatgpt/) och [Cursor och VS Code](/guider/bolagsdata-i-cursor/).

En klient som inte står här fungerar om den stöder Streamable HTTP. Klienter med OAuth-stöd hittar inloggningen själva: servern svarar `401` med en hänvisning till `/.well-known/oauth-protected-resource/mcp`, som pekar vidare till inloggningen. Annars skickar du testnyckeln i rubriken `Authorization: Bearer gb_test_…` i varje anrop.

## Ett första samtal

Sandlådans bolag har nummer i serien 569900. Exempelbolaget i Norrland AB, `569900-0013`, är det mest kompletta. Fråga till exempel:

> Vilka sitter i styrelsen för 569900-0013, och vem får teckna firman?

Assistenten anropar `gb_get_company_roles` och får tillbaka en vd som också är ledamot, en suppleant och ett revisionsbolag, var och en med datum, och firmateckningen som text: styrelsens ledamöter två i förening, och vd för den löpande förvaltningen. Personerna har ett `person_ref`, så att en följdfråga som "vilka andra bolag har vd uppdrag i?" går vidare till `gb_get_person_engagements` utan att något personnummer syns.

Så här ser verktygets svar ut för en enklare fråga, "vad är 569900-0013 för bolag?", som går till `gb_get_company`. Utdraget är ett riktigt svar ur sandlådan, förkortat:

```json
{
  "data": {
    "org_number": "569900-0013",
    "name": "Exempelbolaget i Norrland AB",
    "legal_form": { "code": "AB", "text": "Aktiebolag" },
    "status": { "active": true, "code": 100, "text": "Aktiv" },
    "registered_date": "2015-03-10",
    "seat": { "municipality": "Umeå", "region": "Västerbottens län" },
    "industry": { "sni_code": "62010", "text": "Dataprogrammering" }
  },
  "meta": {
    "source": ["sandbox"],
    "attribution": ["Påhittad testdata. Inga riktiga bolag eller personer."],
    "environment": "test",
    "cost_sek": 0,
    "coverage": { "company": "available" }
  }
}
```

Fältet `cost_sek` säger vad anropet kostade, och `attribution` säger varifrån uppgiften kommer. I live står källan där i stället för "påhittad testdata". Assistenten brukar återge båda om du ber om det, vilket gör att du kan se om ett svar kommer ur registret eller ur modellens eget minne.

Fler bolag att prova: `569900-0039` är avregistrerat och har bara tidigare styrelse, och `569900-0096` finns inte i sandlådan, så att du ser hur assistenten hanterar ett bolag som inte hittas.

## Vad det kostar

Priserna är preliminära (2026-10-28) och gäller när riktig data öppnar.

- **Sandlådan** är gratis, utan tidsgräns.
- **Uppslag** kostar 0,10 kr för en bolagsprofil, styrelse, historik, bokslut eller en persons engagemang, och 0,15 kr för hela bolagsprofilen. Sökningen är gratis upp till 1 000 per dygn. Ett uppslag som inte hittar något kostar ingenting.
- **Att börja:** 500 gratis krediter, ungefär 50 bolagsprofiler med riktig data. Sedan fyller du på mot faktura från 250 kr. En kredit är ett öre.

En fråga till assistenten kan bli flera verktygsanrop. "Vem sitter i styrelsen, och hur har det gått de senaste åren?" blir en sökning, ett rolluppslag och ett bokslut, alltså 0,20 kr. Hela prislistan står på [prissidan](/priser/). Ge gärna nyckeln som en agent använder ett eget dygnstak i kronor under Konto, så att en agent som fastnar i en loop inte kan kosta mer än du bestämt.

## Personuppgifter och AI-tjänsten

Svaren från rollverktyget innehåller namn på styrelseledamöter. När du frågar i ett AI-verktyg skickas svaren till den AI-leverantör du valt, och ditt företag ansvarar för den behandlingen. Datan får användas internt, till exempel för att kontrollera en leverantör eller hålla ditt eget kundregister rätt, men inte visas för dina kunder eller säljas vidare. Läs [personuppgifter](https://app.bolagskvarnen.se/docs/personuppgifter) i dokumentationen innan du kopplar servern till ett verktyg som hela organisationen använder.

## När du inte behöver oss

Behöver du bara namn, bolagsform, adress, status och SNI-kod är den uppgiften gratis i Bolagsverkets API för värdefulla datamängder, utan avtal ([Bolagsverkets API förklarat](/guider/bolagsverkets-api/)). Det API:et är inte en MCP-server, så du får antingen bygga ett eget verktyg runt det eller fråga assistenten att skriva anropen åt dig. Styrelse, firmateckning, historik och bokslut finns inte där.

## Vanliga frågor

### Finns det en MCP-server för svensk bolagsdata?

Ja. Bolagskvarnens MCP-server ligger på `https://app.bolagskvarnen.se/mcp` och har verktyg för sökning, bolagsprofil, styrelse och firmateckning, historik, bokslut och personers engagemang. Den använder Streamable HTTP och loggar in med OAuth 2.1 eller en API-nyckel. Riktig data öppnar senare. I dag svarar den ur en sandlåda med påhittade bolag.

### Vilka AI-verktyg fungerar med Bolagskvarnen?

Alla klienter som stöder fjärrservrar över Streamable HTTP. Vi har guider för Claude (claude.ai, Claude Desktop och Claude Code), ChatGPT, Codex, Cursor och VS Code. Med en testnyckel fungerar Claude Code, Codex, Cursor och VS Code redan nu. Claude.ai och ChatGPT loggar in med OAuth och svarar `blocked_by_phase` tills riktig data öppnar.

### Varför svarar verktygen blocked_by_phase?

Du är ansluten med OAuth eller en live-nyckel, och riktig data är inte öppnad än. Anslut med en testnyckel (`gb_test_…`) i rubriken `Authorization` i stället, så svarar samma verktyg ur sandlådan. När live öppnar fungerar OAuth-anslutningen utan att du gör om den.

### Vad kostar MCP-servern?

Själva servern kostar ingenting. Du betalar per uppslag, samma pris som i REST-API:t: 0,10 kr för en bolagsprofil, styrelse, historik eller bokslut, 0,15 kr för hela profilen, och sökningen är gratis upp till 1 000 per dygn (preliminära priser 2026-10-28). Sandlådan är gratis, och 500 krediter ingår när du börjar.

### Får assistenten personnummer?

Nej. Personer anges med ett `person_ref` som bara fungerar för ditt konto. Enskilda firmors organisationsnummer, som är innehavarens personnummer, visas inte heller.

### Kan servern ändra något i mitt konto?

Nej. Alla sex verktyg läser bara, och de är märkta som skrivskyddade i servern så att klienten kan visa det. Du ser anslutna klienter under Konto och kan koppla bort dem där.

## Källor

- [Bolagskvarnen: dokumentationen för MCP-servern](https://app.bolagskvarnen.se/docs/mcp), läst 2026-11-13
- [Bolagskvarnen: sandlådan och dess påhittade bolag](https://app.bolagskvarnen.se/docs/sandlada), läst 2026-11-13
- [Bolagskvarnen: OAuth-metadata för MCP-servern](https://app.bolagskvarnen.se/.well-known/oauth-protected-resource/mcp), läst 2026-11-13
- [Claude Code: Connect Claude Code to tools via MCP](https://code.claude.com/docs/en/mcp), läst 2026-11-13
- [Claude: Add a connector that isn't in the directory](https://claude.com/docs/connectors/custom/add-unlisted), läst 2026-11-13
- [OpenAI: Connecting custom MCP servers in ChatGPT](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt), läst 2026-11-13
- [OpenAI: MCP i Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli), läst 2026-11-13
- [Cursor: Model Context Protocol](https://cursor.com/docs/context/mcp), läst 2026-11-13
- [VS Code: MCP configuration reference (sidan daterad 2026-11-11)](https://code.visualstudio.com/docs/agents/reference/mcp-configuration), läst 2026-11-13
- [Model Context Protocol: specifikationen för transport och auktorisering](https://modelcontextprotocol.io/specification), läst 2026-11-13