# MCP

Anslut Claude, Claude Code och Cursor till getBolag via MCP, med OAuth eller API-nyckel. Verktyg och parametrar.

Källa: https://getapi.gradientvibe.se/docs/mcp

getBolag är en MCP-server. AI-verktyg som Claude och Cursor kan söka bolag och hämta profiler, styrelser, historik och bokslut direkt i samtalet. Verktygen använder samma data, priser och gränser som REST-API:t.

Serverns adress:

```text
https://getapi.gradientvibe.se/mcp
```

- Transport: Streamable HTTP, tillståndslöst. Bara `POST`; servern skickar inget `Mcp-Session-Id` och öppnar ingen SSE-ström.
- Inloggning: OAuth 2.1 (klienten sköter det) eller en API-nyckel i headern `Authorization`. En testnyckel (`gb_test_…`) fungerar direkt som bearer och svarar ur sandlådan.
- OAuth-resursen (`resource`) är `https://getapi.gradientvibe.se/mcp`. Klienten registrerar sig själv (dynamisk registrering) eller med ett metadatadokument.
- Godkända redirect-URI:er: `https`, eller `http` mot loopback (`127.0.0.1`, `localhost`, `[::1]`) med valfri port. Inga fragment (`#`) och inga användaruppgifter i adressen.
- Alla verktyg läser bara (`readOnlyHint`). Inget verktyg ändrar något.

> **Medan live-data är stängd.** En OAuth-token är alltid live och svarar `blocked_by_phase` tills live-data öppnas. Vill du prova nu: anslut med en testnyckel som header (se nedan), så svarar verktygen ur sandlådan.

## Claude (claude.ai och Claude Desktop)

1. Öppna **Inställningar → Connectors** och välj **Lägg till anpassad connector** (Add custom connector).
2. Ange namnet `getBolag` och adressen `https://getapi.gradientvibe.se/mcp`.
3. Välj **Anslut**. Logga in på getBolag och godkänn åtkomsten på samtyckessidan.
4. Slå på connectorn i ett samtal och fråga till exempel: "Vilka sitter i styrelsen för 569900-0013?"

I organisationer med Team eller Enterprise kan det vara en administratör som lägger till connectorn.

## Claude Code

Med OAuth: lägg till servern och logga in med `/mcp` i Claude Code.

```bash
claude mcp add --transport http getbolag https://getapi.gradientvibe.se/mcp
```

Med en API-nyckel (till exempel en testnyckel):

```bash
claude mcp add --transport http getbolag https://getapi.gradientvibe.se/mcp \
  --header "Authorization: Bearer $GETBOLAG_KEY"
```

## Cursor

Lägg till servern i `~/.cursor/mcp.json` (alla projekt) eller `.cursor/mcp.json` (ett projekt). Med OAuth räcker adressen; Cursor ber dig logga in.

mcp.json med OAuth:

```json
{
  "mcpServers": {
    "getbolag": {
      "url": "https://getapi.gradientvibe.se/mcp"
    }
  }
}
```

mcp.json med API-nyckel:

```json
{
  "mcpServers": {
    "getbolag": {
      "url": "https://getapi.gradientvibe.se/mcp",
      "headers": {
        "Authorization": "Bearer ${env:GETBOLAG_KEY}"
      }
    }
  }
}
```

## Andra klienter och egna agenter

Alla klienter som stöder Streamable HTTP fungerar. Klienter med OAuth-stöd hittar inloggningen själva via `/.well-known/oauth-protected-resource`. Annars skickar du en API-nyckel i varje anrop:

```http
POST /mcp HTTP/1.1
Authorization: Bearer gb_test_…
Content-Type: application/json
Accept: application/json, text/event-stream
```

Ge en nyckel som en agent använder ett eget dygnstak och bara de scopes den behöver. Se [autentisering](https://getapi.gradientvibe.se/docs/autentisering#dygnstak).

## Verktyg

| Verktyg | Gör | Parametrar | Pris |
| --- | --- | --- | --- |
| `gb_search_companies`<br>Sök bolag | Hittar bolag på namn eller organisationsnummer, högst tio träffar. Se [Sök bolag](https://getapi.gradientvibe.se/docs/api/sok-bolag). | `query` (krävs): string. Namn (minst fyra tecken) eller organisationsnummer.<br>`limit`: integer 1–10. Antal träffar, standard 10.<br>`only_active`: boolean. Bara aktiva bolag. | Gratis |
| `gb_get_company`<br>Hämta bolag | Bolagsprofil, kort eller hel. Se [Bolag](https://getapi.gradientvibe.se/docs/api/bolag). | `org_number` (krävs): string. Organisationsnummer.<br>`detail`: "concise" \| "full". Standard `concise`. | 0,05 kr, full 0,10 kr |
| `gb_get_company_roles`<br>Hämta styrelse och roller | Styrelse, VD, revisor och firmateckning, med person_ref. Se [Roller](https://getapi.gradientvibe.se/docs/api/roller). | `org_number` (krävs): string. Organisationsnummer.<br>`include_former`: boolean. Ta med tidigare uppdrag. | 0,10 kr |
| `gb_get_company_history`<br>Hämta historik | Registrerade ändringar sedan ett datum och statushistorik. Se [Historik](https://getapi.gradientvibe.se/docs/api/historik). | `org_number` (krävs): string. Organisationsnummer.<br>`since`: string (ÅÅÅÅ-MM-DD). Från och med datumet.<br>`limit`: integer 1–200. Antal ändringar, standard 50. | 0,50 kr |
| `gb_get_financials`<br>Hämta bokslut | Nyckeltal och bokslut för upp till fem år. Bara aktiebolag. Se [Bokslut](https://getapi.gradientvibe.se/docs/api/bokslut). | `org_number` (krävs): string. Organisationsnummer.<br>`years`: integer 1–5. Antal år, standard 5. | 0,10 kr |
| `gb_get_person_engagements`<br>Hämta personens engagemang | Uppdrag i andra bolag för en person_ref. Se [Engagemang](https://getapi.gradientvibe.se/docs/api/engagemang). | `person_ref` (krävs): string. person_ref från roller.<br>`include_former`: boolean. Ta med avslutade uppdrag. | 0,10 kr |

Verktygen svarar med samma `data` och `meta` som REST-API:t, med `attribution` och `cost_sek`. Fel har samma [felkoder](https://getapi.gradientvibe.se/docs/fel).

## Koppla från en klient

Under Konto ser du anslutna MCP-klienter, när de senast användes och vilka scopes de har. Återkalla en anslutning där. Alla klienter återkallar inte sin token när du kopplar från i klienten, så gör det också i Konto.

## AI-verktyg och personuppgifter

När du använder getBolag i ett AI-verktyg skickas svaren, med namn på styrelseledamöter, till den AI-leverantör du valt. Ditt företag ansvarar för den behandlingen. Se [personuppgifter](https://getapi.gradientvibe.se/docs/personuppgifter).