gnubok MCP-server

TL;DRMCP-server för svensk dubbel bokföring. 67 verktyg över bokföring, fakturor, leverantörer, moms, lön och rapporter. OAuth 2.1 med PKCE och dynamisk klientregistrering. Installeras som connector i Claude.ai, Claude Desktop, Cursor och Continue.

Servern i korthet

Bryggan exponerar 67 verktyg som en MCP-klient kan kalla. De grupperas ungefär så här:

Område	Exempel-verktyg	Server-side scope
Transaktioner	gnubok_list_uncategorized_transactions, gnubok_categorize_transaction, gnubok_match_transaction_to_invoice	transactions:read / :write
Fakturor	gnubok_create_invoice, gnubok_send_invoice, gnubok_credit_invoice	invoices:write
Leverantörer	gnubok_list_suppliers, gnubok_create_supplier_invoice_from_inbox, gnubok_approve_supplier_invoice	suppliers:read / :write
Rapporter	gnubok_get_trial_balance, gnubok_get_balance_sheet, gnubok_get_income_statement, gnubok_get_vat_report, gnubok_vat_close_check, gnubok_get_kpi_report	reports:read
Bokslut	gnubok_year_end_readiness (read), gnubok_run_year_end, gnubok_close_period, gnubok_explain_voucher_gap	reports:read / bookkeeping:write
Lön	gnubok_list_employees, gnubok_calculate_salary_run, gnubok_generate_agi	payroll:read / :write
Audit	gnubok_audit_package, gnubok_export_sie, gnubok_query_journal	reports:read

Skriv-operationer stagar en pending_operation som du godkänner i gnubok-appen. Inget skrivs till DB innan en människa klickat.

Server-side scopes är knutna till ditt gnubok-konto, inte till OAuth-grantet. Agenten kan göra allt du själv kan göra inom de verktyg den får exponera.

Installera i Claude.ai

1. I Claude → Settings → Connectors → Add custom connector.
2. Ange URL: https://app.gnubok.se/api/extensions/ext/mcp-server/mcp.
3. Claude öppnar gnubok-OAuth i webbläsaren. Logga in. Godkänn anslutningen.
4. Connectorn dyker upp i listan. Slå på för de chattar där du vill ha den aktiv.

Installera i Claude Desktop

claude_desktop_config.json (~/Library/Application Support/Claude/ på macOS):

{
  "mcpServers": {
    "gnubok": {
      "url": "https://app.gnubok.se/api/extensions/ext/mcp-server/mcp",
      "transport": "http"
    }
  }
}

Starta om Claude Desktop. OAuth-flödet triggas vid första anrop.

Installera i Cursor

.cursor/mcp.json:

{
  "mcpServers": {
    "gnubok": {
      "url": "https://app.gnubok.se/api/extensions/ext/mcp-server/mcp",
      "transport": "http"
    }
  }
}

Cmd-Shift-P → MCP: Refresh Servers. OAuth-prompten dyker upp i en webbläsarflik.

Installera i Continue

~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "gnubok",
      "url": "https://app.gnubok.se/api/extensions/ext/mcp-server/mcp",
      "transport": "http"
    }
  ]
}

Stdio-fallback för icke-OAuth-klienter

För klienter som bara stödjer stdio (vissa custom-agentmiljöer, CI-pipelines) finns en lokal bro via npm:

{
  "mcpServers": {
    "gnubok": {
      "command": "npx",
      "args": ["gnubok-mcp"],
      "env": {
        "GNUBOK_API_KEY": "gnubok_sk_..."
      }
    }
  }
}

API-nyckel skapas i app.gnubok.se → Inställningar → API-nycklar. Här väljer du scopes per nyckel: transactions:read, transactions:write, customers:read, customers:write, invoices:read, invoices:write, suppliers:read, suppliers:write, reports:read, bookkeeping:write, payroll:read, payroll:write.

API-nyckel-flödet kringgår OAuth-discoveryn men ger samma verktygsåtkomst. Lämpligt när maskinen som kör agenten inte kan öppna en webbläsare.

Audit och behandlingshistorik

För Skatteverkets revision och BFL-spårbarhet använder du gnubok_audit_package(period: "..."). Den producerar en zip med:

• SIE-4-fil för perioden
• Balans- och resultaträkning som PDF
• Huvudboken (per konto, alla rader)
• Audit-loggen som CSV: vem rörde vad när, scope, before/after
• Kvitto-arkivet som referens
• Voucher-gap-rapport per BFNAR 2013:2

Filen ligger i Supabase Storage med en signed URL på 1 timme. Audit-loggen genereras vid varje skriv-operation och kan inte stängas av.

Sånt bryggan inte gör

• Bryggan kör ingen tredjepartskod. Egna skills och workflows körs alltid hos den som skickar anropet, inte hos oss.
• Bryggan stagar alltid skriv-operationer. Ingen agent kan posta ett verifikat utan ett mänskligt godkännande i app.gnubok.se.
• En OAuth-anslutning är bunden till ett gnubok-konto, som i sin tur är bunden till ett företag. För byråer som hanterar flera klienter krävs en anslutning per klient idag. Multi-tenant via companies:read-scopen är på roadmap för v1 REST API.

Versionering

OAuth-discoveryn följer RFC 8414 (Authorization Server Metadata), RFC 9728 (Protected Resource Metadata) och RFC 7591 (Dynamic Client Registration). Stdio-bron är gnubok-mcp@1.0.1 på npm. Källkod under AGPL-3.0 på github.com/erp-mafia/gnubok.

OAuth-scopes

• mcp

gnubok-verktyg

• gnubok_list_uncategorized_transactions
• gnubok_categorize_transaction
• gnubok_create_invoice
• gnubok_get_vat_report
• gnubok_auto_match_period
• gnubok_export_sie

Vanliga frågor

Vad är gnubok MCP-server?

En HTTP-baserad MCP-server som ger en AI-agent åtkomst till en svensk huvudbok: verifikat, kunder, fakturor, moms, lön, SIE-export. OAuth 2.1 med PKCE och dynamisk klientregistrering. 67 verktyg över bokföring, fakturor, leverantörer, moms, lön och rapporter.

Hur funkar OAuth-flödet?

MCP-klienten upptäcker gnuboks autentiseringsserver via `.well-known/oauth-protected-resource`. Klienten registrerar sig dynamiskt (RFC 7591) på `/api/mcp-oauth/register`, öppnar `/api/mcp-oauth/authorize` i webbläsaren, du loggar in på gnubok och godkänner anslutningen, klienten utbyter authorization code mot en access token via `/api/mcp-oauth/token` med PKCE S256.

Vilka klienter funkar?

Allt som följer MCP-spec 2026-02 och stödjer HTTP-transport med OAuth: Claude.ai (connectors), Claude Desktop (HTTP), Cursor, Continue, Codex. För stdio-bara klienter finns en lokal bro: `npx gnubok-mcp` med API-nyckel.

Vilka scopes ger jag bort?

OAuth-flödet ger en enskild `mcp`-scope: 'denna agent får använda gnuboks MCP'. Inom det är agentens åtkomst begränsad till samma rättigheter som ditt eget gnubok-konto har. Du kan när som helst återkalla anslutningen i app.gnubok.se → Inställningar.

Får agenten skriva direkt till huvudboken?

Bara om ditt eget konto har skrivrättigheter. Och även då stagar varje write en `pending_operation` som du godkänner i app.gnubok.se. Poster är immutabla efter posting; rättelser är nya verifikat via `gnubok_correct_entry`. BFL 5 kap 5§ är arkitektoniskt, inte en policy.

Vad händer vid Skatteverkets revision?

Den 1 april 2026 öppnas online-åtkomst för revisorer. `gnubok_audit_package` paketerar SIE-4 + huvudbok + balans- och resultaträkning + audit-logg + voucher-gaps som en zip med 1-timmes signed URL. Det är samma data som UI:t bygger på.