BaaS Bokföring MCP

Sköt din bokföring med en AI-assistent. Det här är den officiella MCP-servern (Model Context Protocol) för BaaS Bokföring — den låter Claude, ChatGPT och andra AI-assistenter arbeta direkt mot din bokföring: skapa och skicka fakturor, bokföra kvitton, stämma av banken, ta fram rapporter, beräkna moms och mycket mer.

144 verktyg. Samma regler och samma bokföringsmotor som webbappen — assistenten kan inte bokföra på något annat sätt än appen gör.

Assistenten föreslår, du bestämmer. Varje bokföringsåtgärd förhandsvisas (konton, belopp, balans, om perioden är låst) och utförs först när du sagt ja. Assistenten börjar med en orientering om ditt företag och en att-göra-lista, hämtar hur du brukar kontera varje leverantör, och laddar produktens egna arbetsflöden och regelreferenser i stället för att gissa svenska bokföringsregler ur minnet.

Krav

• Ett konto hos BaaS Bokföring med aktivt abonnemang
• En AI-klient med MCP-stöd (Claude Desktop, Claude Code, Cursor m.fl.)
• För npx-vägen nedan: Node.js 18 eller senare. Claude Desktop-tillägget (.mcpb) behöver inget Node installerat.

Kom igång

Claude Desktop, enklast: tillägget

Ladda ner baas-bokforing-<version>.mcpb från app.baasbokforing.se/mcp och dubbelklicka på filen (eller Inställningar → Tillägg → Installera tillägg). Klart. Uppdatera genom att installera en nyare fil.

Claude Desktop

Lägg till i claude_desktop_config.json (Inställningar → Utvecklare → Redigera konfiguration):

{
  "mcpServers": {
    "baas-bokforing": {
      "command": "npx",
      "args": ["-y", "@baasbokforing/mcp"]
    }
  }
}

Claude Code

claude mcp add baas-bokforing -- npx -y @baasbokforing/mcp

Cursor och andra MCP-klienter

Samma kommando överallt: npx -y @baasbokforing/mcp (stdio-transport).

Logga in

Starta din AI-klient och skriv t.ex. "Logga in på min bokföring". Webbläsaren öppnas för säker inloggning — inga lösenord behöver skrivas i chatten. Sessionen sparas lokalt på din dator (~/.config/baas-mcp, endast läsbar för dig), så du behöver inte logga in varje gång.

Har du flera företag väljer du med "Byt till företaget …". Alla kommandon gäller det valda företaget och räkenskapsåret.

Vad kan du säga?

• "Skapa en faktura till Andersson Bygg AB på 12 500 kr exkl. moms för konsulttjänster, bokför och mejla den."
• "Vilka leverantörsfakturor är förfallna?"
• "Bokför det här kvittot" (bifoga en bild — den skannas och förifylls)
• "Synka banken och matcha transaktionerna."
• "Hur ser resultatet ut i år jämfört med kostnaderna? Visa resultaträkningen."
• "Beräkna momsen för andra kvartalet och kontrollera att den ser rimlig ut."
• "Skicka en påminnelse på alla förfallna fakturor."
• "Exportera en SIE-fil för räkenskapsåret."

Så arbetar assistenten

1. Orientering. get_agent_briefing ger bolagsform, bokföringsmetod, momsperiod, räkenskapsår, påslagna moduler, reglerna som styr arbetet och rekommenderade verktyg per flöde. get_attention listar vad som väntar: omatchade banktransaktioner, obehandlad inkorg, förfallna fakturor, momsrapporter som ska in, avskrivningar, rot/rut-frister, med antal, exempel och nästa verktyg.
2. Kunskap från servern. list_skills / load_skill ger steg-för-steg-flöden (daglig bokföring, bankavstämning, månadsavslut, momsdeklaration, årsskifte, rättelser, rot/rut …) och regelreferenser (bokföringsmetod, kreditering, föreningar), filtrerade till ditt företag. get_ledger_context visar hur du brukar kontera varje leverantör och kund, med antal som bevis.
3. Minne och förslag. Säg "Klarnas avgifter går på 6570" en gång: remember_fact sparar regeln per företag och den gäller i alla kommande sessioner, före historiken. suggest_categories rankar kontering för varje omatchad banktransaktion med bevis (regel, historik, öppen faktura med samma belopp, leverantörens förvalda konto, känt mönster) och pekar på verktyget som utför den; book_bank_transaction bokför ett godkänt förslag med momsen bruten ur bruttot, genom samma regler som appens snabbokning.
4. Förslag och godkännande. Verktyg som skriver i bokföringen returnerar staged: true med en förhandsvisning och ett pending_operation_id. Assistenten visar förhandsvisningen; approve_pending_operation utför den efter ditt ja (confirmed: true krävs för åtgärder med risk_level: high, t.ex. makulering, låsning av period, godkännande av momsrapport). reject_pending_operation avvisar. Samma id utförs aldrig två gånger.
5. Tydliga fel. Ett fel har alltid code, svensk och engelsk text, retryable (om samma anrop kan lyckas vid omförsök) och ofta next med verktyget som löser situationen.

Registervård (kunder, leverantörer, artiklar) och läsningar utförs direkt. Vill du köra utan godkännandesteget (t.ex. i en egen automation) sätter du BAAS_MCP_STAGING=off i serverns miljö.

Verktyg (144)

get_agent_briefing, get_attention, run_bookkeeping_controls, analyze_books, get_account_status, create_billing_portal_link, get_ledger_context, list_skills, load_skill, search_tools, list_pending_operations, approve_pending_operation, reject_pending_operation, report_tool_feedback

login, logout, list_companies, select_company, session_status, list_financial_years, select_financial_year

Skapa, bokföra, betala och makulera: list_invoices, get_invoice, create_invoice (även rot-, rut- och grön teknik-avdrag med klassade rader och köpare), book_invoice, register_invoice_payment, void_invoice — samt utskick, kreditering och påminnelser: mark_invoice_sent, send_invoice_email, create_credit_invoice, settle_customer_credit_note, send_invoice_reminder

Register: list_suppliers, get_supplier, create_supplier, update_supplier. Fakturor: list_supplier_invoices, get_supplier_invoice, book_supplier_invoice, register_supplier_payment, void_supplier_invoice, create_credit_supplier_invoice, settle_supplier_credit_note

create_supplier_invoice (bokför leverantörsfaktura med underlag), create_receipt (utlägg/bankkort/kreditkort), list_file_inbox (mejlade/uppladdade underlag med AI-skannad metadata)

list_bank_accounts, request_bank_consent (ny PSD2-länk), upload_bank_file, preview_bank_file_import, import_bank_file (kontoutdrag som fil, stegas), link_bank_account, sync_bank_transactions, list_unmatched_transactions, get_bank_transaction, suggest_categories (rankade förslag med bevis), book_bank_transaction (bokför förslag, moms ur bruttot), find_transaction_matches, match_transaction, create_bank_writeoff, auto_match_transactions

save_note, list_notes, get_note, update_note, update_note_table, delete_note, list_note_categories, create_note_category (kunskap om företaget: svar från andra system som KYC/AML, beslut, kontakter, avtal; företagets egna kategorier; kopplas till kund, leverantör, faktura, inkorgsfil, verifikat, banktransaktion, artikel, anställd, lönekörning eller avstämningsdag; tabell per anteckning som litet kalkylblad med formler (=SUM(B1:B3), =B1*C1) och summering per kolumn, uträknade värden i svaret; känsligt = bara ägare/admin; lagringskrav spärrar radering)

list_calendar_events, create_calendar_event, update_calendar_event, delete_calendar_event (företagets egna händelser på Baasen → Kalender; lagstadgade frister finns i get_attention)

remember_fact, forget_fact, list_facts — konteringsregler, fakta och preferenser per företag som gäller i alla sessioner (tabell agent_facts)

list_verifications, get_verification, create_verification, create_correction_verification (rättelseverifikat enligt BFL 5 kap. 5 §), get_correction_verifications, check_verification_deletable, delete_verification, strike_verification_rows

list_vat_reports, get_vat_report, calculate_vat_report, approve_vat_report, revert_vat_report, generate_vat_periods, calculate_vat_deviation_report, check_vat_reasonableness, export_eskd

generate_balance_report, generate_result_report, generate_general_ledger, generate_account_analysis, generate_customer_subledger, generate_supplier_subledger, generate_journal_compilation, list_cost_centers, export_sie (SIE 4-fil)

list_lock_periods, toggle_lock_period, create_financial_year, create_year_end_adjustment / reverse_year_end_adjustment (årsomföring för kontantmetoden enligt BFN)

list_customers, get_customer, search_customers, create_customer, update_customer, delete_customer, list_items, get_item, search_items, create_item, update_item, list_price_lists

get_chart_of_accounts (BAS med företagsanpassningar), get_account, search_accounts

list_assets, get_asset, create_asset, dispose_asset, book_asset_depreciations_due, list_accruals, get_accrual, create_accrual, book_accrual_postings_due

list_subscription_contracts, get_subscription_contract, list_subscription_runs, get_subscription_run

list_tax_deductions, get_person_deduction_usage, get_invoice_tax_deduction (typ, underlag, bostad, frist och varje köpares läge hos Skatteverket), build_tax_deduction_request (begäran om utbetalning, skattered/begaran/1.0), register_tax_deduction_skv_payment, register_tax_deduction_skv_denial (nekat beslut per köpare, 1513 → 1510). Avdraget läggs på fakturan med create_invoice (taxDeduction + klassade rader) och hushållets uppgifter sparas på kunden med create_customer / update_customer.

search_help_center, get_help_article, list_help_categories — assistenten kan slå upp svenska bokföringsregler och appens funktioner

Bokföringsmetoder

Servern hanterar både fakturametoden och kontantmetoden automatiskt — den läser företagets inställning och bokför enligt samma regler som webbappen (t.ex. skapar kontantmetoden ingen verifikation förrän betalningen registreras, och delbetalningar proportioneras över intäkt och moms).

Säkerhet & data

• Inloggning sker via webbläsaren mot BaaS Bokförings ordinarie inloggning. Sessionen sparas lokalt på din dator med filrättigheter som bara ger dig åtkomst. Inga lösenord lagras.
• Behörighet styrs helt på serversidan: du kommer bara åt företag du är medlem i, och ett aktivt abonnemang krävs.
• Din AI-klient ser din bokföringsdata. När du använder t.ex. Claude eller ChatGPT skickas de uppgifter assistenten läser (fakturor, saldon, rapporter) till den AI-leverantör du själv valt. Använd en leverantör du litar på.
• Granska bokslut och moms. AI-assistenter kan missförstå — kontrollera verifikationer och godkänn momsrapporter först när du sett underlaget. Du ansvarar för din bokföring; verktygen skapar alltid spårbara verifikationer som kan rättas med rättelseverifikat.

Avancerat

Miljövariabler (behövs normalt inte — produktionsmiljön är förvald):

| Variabel | Beskrivning | |---|---| | APP_URL | Webbappens URL (för inloggning via webbläsare) | | SUPABASE_URL / SUPABASE_ANON_KEY | Backend-miljö | | BAAS_MCP_STAGING | off stänger av godkännandesteget: skrivande verktyg utförs direkt (automation) | | BAAS_MCP_CONFIG_DIR | Katalog för session och väntande åtgärder (default ~/.config/baas-mcp; en äldre ~/.config/ekonomi-mcp flyttas automatiskt) |

Servern exponerar också resurser (baas://attention, baas://ledger/context, baas://company/current, baas://pending-operations, baas://capabilities, baas://skill/<slug>) och prompter (att_gora, forfallna_fakturor, saldo_idag, resultat_forra_manaden, moms_att_betala, oavstamda_transaktioner, bokfor, manadsavslut) för klienter som stöder dem.

Support

• Hjälpcenter och feedback: direkt i appen (Feedback-knappen)
• Assistenten kan själv svara på de flesta frågor via search_help_center

Licens

MIT

BaaS Bokföring MCP — official MCP server for the Swedish bookkeeping service BaaS Bokföring. It gives AI assistants (Claude, ChatGPT, Cursor, …) full access to invoicing, supplier invoices, receipts, bank reconciliation, VAT, reports and SIE export, using the exact same accounting engine and permission model as the web app. Every ledger write is staged for the user's approval with a preview; the server ships a session briefing, an attention list, per-counterparty booking patterns, loadable Swedish bookkeeping skills and structured, retryable-flagged errors. Requires a BaaS Bokföring account. Quick start: npx -y @baasbokforing/mcp.