Svensk bolagsdata i Cursor och VS Code: anslut Bolagskvarnens MCP-server i editorn

Skriven av Bolagskvarnen. Stegen är kontrollerade i Cursors och VS Codes dokumentation 2026-11-13. Grunderna om servern, verktygen och priset står i MCP-server för svensk bolagsdata.

Varför i editorn

I en editor är MCP-servern mest till nytta när du bygger något som ska använda bolagsdata, till exempel en kontroll av leverantörer i inköpssystemet eller en tvätt av det egna kundregistret. Agenten kan slå upp sandlådans bolag medan den skriver koden, se hur svaren faktiskt ser ut och testa felfallen, i stället för att gissa fältnamnen. Själva integrationen skriver du sedan mot REST-API:t, som har samma data och samma priser.

Båda editorerna kan skicka en egen nyckel i rubriken Authorization. Med en testnyckel (gb_test_…) svarar Bolagskvarnens sandlåda redan nu. Med OAuth räknas anslutningen som live och svarar blocked_by_phase tills riktig data öppnar. Testnyckeln skapar du gratis under Konto, Nycklar, på app.bolagskvarnen.se med miljön Test.

Cursor

Med testnyckel (sandlådan, fungerar nu)

1. Lägg testnyckeln i miljövariabeln BOLAGSKVARNEN_KEY. Cursor läser miljön när programmet startar, så sätt variabeln där Cursor ser den (på Windows med setx BOLAGSKVARNEN_KEY "gb_test_…", på macOS och Linux i skalets profil) och starta om Cursor.
2. Öppna eller skapa ~/.cursor/mcp.json för alla projekt, eller .cursor/mcp.json för ett enda projekt, och lägg till:

{
  "mcpServers": {
    "bolagskvarnen": {
      "url": "https://app.bolagskvarnen.se/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BOLAGSKVARNEN_KEY}"
      }
    }
  }
}

3. Öppna Cursors inställningar för MCP. Där ska bolagskvarnen stå som påslagen med sex verktyg.

Skriv aldrig själva nyckeln i filen. Med ${env:…} står bara variabelns namn där, så filen går att checka in i ett projekt utan att nyckeln följer med.

Med OAuth (när live öppnar)

{
  "mcpServers": {
    "bolagskvarnen": {
      "url": "https://app.bolagskvarnen.se/mcp"
    }
  }
}

Cursor hittar inloggningen via serverns metadata, registrerar sig som klient utan hemlighet och ber dig logga in. Du kommer till Bolagskvarnens samtyckessida, där du ser kontot och vilka behörigheter Cursor ber om. Åtkomsten förnyas med den refresh token som Bolagskvarnen lämnar, och den gäller 30 dagar.

VS Code med Copilot

Enligt VS Codes dokumentation (daterad 2026-11-11) ska nya servrar läggas i Copilots egen konfiguration. Den äldre filen .vscode/mcp.json hör till det som VS Code kallar Local harness, som tas bort i februari 2027.

Lägg till servern

1. Kontrollera att Copilot är valt som mål för chatten och att du har en projektmapp öppen.
2. Öppna kommandopaletten och kör MCP: Add Server.
3. Välj HTTP (HTTP or Server-Sent Events) och ange https://app.bolagskvarnen.se/mcp.
4. Ange id:t bolagskvarnen.
5. Välj Global och sedan Copilot Global, så gäller servern i alla projekt och i Copilot CLI på samma dator.

Lägg till testnyckeln

Copilot Global sparar servrarna i ~/.copilot/mcp-config.json (eller i $COPILOT_HOME/mcp-config.json). Öppna filen och lägg till rubriken, så att posten ser ut så här:

{
  "mcpServers": {
    "bolagskvarnen": {
      "type": "http",
      "url": "https://app.bolagskvarnen.se/mcp",
      "headers": {
        "Authorization": "Bearer ${BOLAGSKVARNEN_KEY}"
      }
    }
  }
}

Variabeln läses ur miljön där VS Code eller Copilot startar, precis som i Cursor. VS Codes dokumentation säger att Copilot inte kan föra in ett hemligt värde som du skriver in vid start (${input:…}) i en rubrik, så miljövariabeln är vägen för en nyckel. Utan rubriken försöker VS Code logga in med OAuth, och då gäller samma sak som för andra klienter: svaren kommer när riktig data öppnar.

Kontrollera anslutningen

VS Code föreslår att du ber Copilot om en liten uppgift som använder servern och sedan fäller ut verktygsanropet för att se att det gick. Fråga till exempel “använd bolagskvarnen och hämta bolaget 569900-0013” och öppna anropet till gb_get_company.

Exempel på vad agenten kan göra

Bolagen är påhittade och finns bara i sandlådan.

Hämta 569900-0013 med bolagskvarnen och skriv en TypeScript-typ för svaret.

Agenten anropar gb_get_company och får tillbaka fälten org_number, name, legal_form, status, registered_date, seat och industry, plus meta med attribution och cost_sek. Typen bygger den på det riktiga svaret i stället för på en gissning.

Skriv en funktion som kontrollerar att en leverantör finns och är aktiv. Prova den mot 569900-0013, 569900-0039 och 569900-0096.

Det första bolaget är aktivt, det andra är avregistrerat och det tredje finns inte i sandlådan. Agenten ser alltså alla tre utfallen, inklusive felkoden not_found, innan funktionen körs mot riktig data.

Vilka fält skiljer mellan detail concise och full?

Agenten hämtar samma bolag två gånger och jämför. Hela profilen lägger till adresser, F-skatt, moms, verksamhetsbeskrivning, tidigare namn, aktiekapital och storleksklasser. OpenAPI-beskrivningen för REST-API:t finns på app.bolagskvarnen.se/openapi.json om du vill generera en klient.

Om något inte fungerar

• 401 eller “Inloggning krävs”: miljövariabeln är tom för editorn. Starta om editorn efter att du satt variabeln, och kontrollera att värdet börjar med gb_test_.
• blocked_by_phase: anslutningen är live. Byt till en testnyckel.
• rate_limited: takten och sökkvoten gäller också i sandlådan, så att du kan testa felhanteringen. Vänta och försök igen.
• Servern syns inte: kontrollera att JSON-filen är giltig och att du redigerade rätt fil, global eller projekt.

Vad det kostar

Sandlådan är gratis. Med riktig data kostar en bolagsprofil, styrelsen, historiken eller bokslutet 0,10 kr per uppslag och hela bolagsprofilen 0,15 kr. Sökningen är gratis upp till 1 000 per dygn, och ett uppslag som inte hittar något kostar ingenting. Priserna är preliminära (2026-10-28), se prissidan. En agent som får arbeta själv kan göra många anrop, så ge nyckeln ett eget dygnstak i kronor under Konto.

Vanliga frågor

Hur lägger jag till Bolagskvarnen i Cursor?

Lägg en post bolagskvarnen med "url": "https://app.bolagskvarnen.se/mcp" i ~/.cursor/mcp.json eller .cursor/mcp.json. För sandlådan lägger du till "headers": { "Authorization": "Bearer ${env:BOLAGSKVARNEN_KEY}" } och sätter miljövariabeln till en testnyckel. Utan rubrik loggar Cursor in med OAuth, och då kommer svaren när riktig data öppnar.

Fungerar .vscode/mcp.json fortfarande?

Enligt VS Codes dokumentation (daterad 2026-11-11) hör den filen till Local harness, som är utfasad och tas bort i februari 2027. Lägg nya servrar i Copilots konfiguration med MCP: Add Server.

Kan agenten ändra något hos Bolagskvarnen?

Nej. Alla sex verktyg läser bara. Det värsta en agent kan göra är att använda krediter, och det begränsar du med ett dygnstak per nyckel.

Ska jag använda MCP-servern eller REST-API:t i min kod?

REST-API:t. MCP-servern är till för assistenten i editorn, som använder den för att förstå datan medan den skriver koden. Programmet du bygger anropar sedan https://app.bolagskvarnen.se/api/v1 med en nyckel. Data, priser och felkoder är desamma.