Tripletex MCP Server

En open source MCP-server som lar AI-assistenter (Claude, Cursor, osv.) jobbe direkte mot Tripletex sitt regnskapssystem. Se hvordan du installerer repo og kobler på under.

Foretrekker du en ferdigkonfigurert MCP-løsning? Prøv: Regnskapsagent.no

Bygd og vedlikeholdt av CWV Ventures AS.

Trenger du hjelp til implementering?

Kontakt meg på carl@cwv.no.

I korte trekk

56 MCP-verktøy dekker ordre, faktura, leverandørfaktura, bilag, hovedbok, rapporter, prosjekt, timer, HR og reiseregning.
18 regnskapsflyter (skills) — norsk-språklige steg-for-steg-guider som aktiveres via MCP-prompts.
Tynn, presis proxy over Tripletex v2 — feltnavn matcher API-ets DTO-er verbatim, slik at LLM-en får riktig feedback og kan selvkorrigere.
Automatisk autentisering — consumer + employee token byttes til kortlevd session token, caches til midnatt CET og fornyes ved 401.
Stdio transport per MCP-spesifikasjonen; kan kobles på Claude Desktop, Cursor, eller andre MCP-klienter.

Arkitektur

MCP-serveren er delt i tre lag: tynn proxy (tripletex-client.ts), body-byggere (tripletex-transform.ts) og 56 tool-registreringer + 18 skills (tripletex-tools.ts, skills/). LLM-klienten snakker med serveren over stdio; serveren snakker med Tripletex v2 over HTTPS.

flowchart LR
  Client["MCP-klient<br/>(Claude / Cursor / Regnskapsagent)"]

  subgraph Server["tripletex-mcp (stdio-server)"]
    direction TB
    Entry["index.ts<br/>bootstrap + McpServer"]
    Tools["tripletex-tools.ts<br/>56 server.tool(...)"]
    Skills["skills/*.ts<br/>18 MCP prompts"]
    Resource["Resource<br/>tripletex://skills"]
    Transform["tripletex-transform.ts<br/>body-byggere"]
    HttpClient["TripletexClient<br/>auth + HTTP + retry"]
  end

  API["Tripletex v2 REST<br/>tripletex.no/v2"]

  Client -- "stdio / JSON-RPC" --> Entry
  Entry --> Tools
  Entry --> Skills
  Skills --> Resource
  Tools --> Transform
  Tools --> HttpClient
  Transform --> HttpClient
  HttpClient -- "Basic Auth + session token" --> API

Hvor hver ting lever:

Fil	Ansvar
src/index.ts	Stdio-bootstrap, `McpServer`-instans, kobler klient til tools.
src/tripletex-tools.ts	Alle 56 `server.tool(...)`-registreringer med Zod-schemas og korte agent-instruksjoner.
src/tripletex-transform.ts	Rene funksjoner som bygger Tripletex-JSON fra MCP-input (f.eks. `buildOrderBody`, `buildSupplierInvoiceVoucherBody`).
src/tripletex-client.ts	Autentisering, session-caching, `fetch`-wrapper, 401-retry, multipart-opplasting.
src/skills/	18 regnskapsflyter som MCP prompts, pluss ressursen `tripletex://skills`.

Autentiseringsflyt

Tripletex bruker ikke én API-nøkkel — applikasjonen identifiseres med consumer token, brukeren med employee token, og hvert faktisk API-kall signeres med en kortlevd session token. MCP-serveren håndterer hele vekslingen transparent:

sequenceDiagram
  participant MCP as MCP-tool (f.eks. create_invoice)
  participant C as TripletexClient
  participant TT as Tripletex v2

  MCP->>C: client.post("/invoice", body)
  C->>C: ensureSession()

  alt Ingen gyldig session
    C->>TT: PUT /token/session/:create<br/>(consumer + employee token)
    TT-->>C: { token, expiresAt = i morgen }
    C->>C: cache session
  end

  C->>TT: POST /invoice<br/>Authorization: Basic 0:sessionToken
  alt 401 Unauthorized
    C->>C: session = null
    C->>TT: PUT /token/session/:create (ny)
    TT-->>C: ny session
    C->>TT: POST /invoice (retry)
  end
  TT-->>C: 200 OK + JSON
  C-->>MCP: parsed response

Hva kan den gjøre?

56 MCP-verktøy fordelt på 9 kategorier (per v2.4.0, synket med Regnskapsagent-MCP):

Kategori	Antall	Dekker
Ordrer & utgående faktura	7	Søk/opprett ordre, fakturering, søk fakturaer
Leverandørfaktura	8	Søk, godkjenning, oppdater posteringer, bilagsmottak
Kunder & leverandører	7	Søk, opprett, oppdater på begge sider
Produkter	2	Søk og opprett produkt
Bilag & hovedbok	10	Kontoplan, MVA, bilagstyper, bilag, vedlegg, hovedbok
Rapporter	1	Saldobalanse
Prosjekt, time & HR	7	Prosjekt, aktivitet, timer, ansatt, avdeling
Reise & kjøregodtgjørelse	12	Reiseregning, kjøring, km-satser, kostnader, approval
Utility	2	`whoami`, `search_employees`

Vis full liste over alle 56 verktøy

Kategori	Verktøy	Beskrivelse
Ordrer & utgående faktura	`search_orders`	Søk ordrer (åpne/lukkede, abonnement m.m.)
	`get_order`	Hent én ordre
	`create_order`	Opprett ordre
	`invoice_order`	Fakturer ordre
	`create_invoice`	Ordre + faktura i ett steg
	`search_invoices`	Søk utgående fakturaer (datointervall)
	`get_invoice`	Hent én faktura
Leverandørfaktura	`search_supplier_invoices`	Søk registrerte leverandørfakturaer
	`get_supplier_invoice`	Hent én leverandørfaktura
	`get_supplier_invoices_for_approval`	Liste til godkjenning
	`approve_supplier_invoice`	Godkjenn
	`reject_supplier_invoice`	Avvis
	`update_supplier_invoice_postings`	Oppdater posteringer på leverandørbilag
	`create_supplier_invoice`	Opprett leverandørbilag til bilagsmottak (`POST /ledger/voucher`, m.fl.)
	`get_voucher_inbox_count`	Antall i bilagsmottak
Kunder & leverandører	`search_customers`	Søk kunder
	`create_customer`	Opprett kunde
	`update_customer`	Oppdater kunde
	`search_suppliers`	Søk leverandører
	`create_supplier`	Opprett leverandør
	`get_supplier`	Hent leverandør
	`update_supplier`	Oppdater leverandør
Produkter	`search_products`	Søk produkter
	`create_product`	Opprett produkt
Bilag & hovedbok	`search_accounts`	Søk kontoplan
	`search_vat_types`	MVA-typer
	`search_voucher_types`	Bilagstyper
	`search_vouchers`	Søk bilag
	`get_voucher`	Hent bilag
	`create_voucher`	Opprett bilag
	`send_voucher_to_ledger`	Send bilag til bokføring
	`attach_voucher_document`	Vedlegg dokument (Base64) til bilag
	`import_ledger_voucher_document`	Importer bilag fra fil
	`search_ledger_postings`	Søk hovedboksposteringer
Rapporter	`get_balance_sheet`	Saldobalanse for periode
Prosjekt & time	`search_projects`	Søk prosjekter
	`search_activities`	Søk aktiviteter
	`search_time_entries`	Søk timeføringer
	`create_time_entry`	Logg timer
	`create_project`	Opprett prosjekt
	`create_department`	Opprett avdeling
HR	`create_employee`	Opprett ansatt
Reise & kjøregodtgjørelse	`search_travel_expenses`	Søk reiseregninger
	`get_travel_expense`	Hent reiseregning
	`create_travel_expense`	Opprett reiseregning
	`create_mileage_allowance`	Kjøregodtgjørelse
	`search_mileage_allowances`	Søk kjøregodtgjørelser
	`search_mileage_rates`	km-satser
	`search_mileage_rate_categories`	Satskategorier
	`deliver_travel_expense`	Lever til godkjenning
	`approve_travel_expense`	Godkjenn
	`create_travel_expense_cost`	Kostnad (parkering, bom, …)
	`search_travel_expense_cost_categories`	Kostnadskategorier
	`search_travel_expense_payment_types`	Betalingstyper
Utility	`whoami`	Sesjon / selskap
	`search_employees`	Søk ansatte

Skills (regnskapsflyter)

I tillegg til verktøyene eksponerer serveren 18 regnskapsflyter som MCP prompts — norsk-språklige playbooks som hjelper LLM-en å kjøre vanlige operasjoner i riktig rekkefølge, med korrekt MVA-håndtering og validering underveis. Flyter er indeksert som ressursen tripletex://skills slik at klienten kan slå opp triggere automatisk.

Tier	Skill-id	Flyt	Typiske triggere
Core	`create-invoice`	Opprett utgående faktura med korrekt MVA	faktura, invoice, fakturere, utgående faktura
Core	`post-voucher`	Bilagsføring med debet/kredit og NS 4102-kontoplan	bilag, voucher, bokføring, postering
Core	`register-supplier-invoice`	Registrer leverandørfaktura (inkl. bilagsmottak)	leverandørfaktura, inngående faktura, bilagsmottak
Core	`customer-management`	Søk, opprett og oppdater kunder	kunde, ny kunde, kundeoppslag
Common	`time-to-invoice`	Konverter loggede timer til faktura	timer til faktura, fakturere timer
Common	`credit-note`	Utsted kreditnota på eksisterende faktura	kreditnota, kreditere, tilbakebetaling faktura
Common	`balance-check`	Saldobalanse og kontooversikt for periode	saldobalanse, kontooversikt, periode avslutning
Common	`create-product`	Opprett produkt for ordre/faktura	produkt, vare, tjeneste
Common	`register-payment`	Registrer innbetaling/utbetaling	betaling, innbetaling, utbetaling
Common	`create-employee`	Onboard ansatt med norske krav	ansatt, ny ansatt, onboarding
Common	`create-project`	Opprett prosjekt for timer/fakturering	prosjekt, nytt prosjekt
Common	`create-departments`	Opprett avdeling/kostnadssted	avdeling, department, kostnadssted
Advanced	`run-payroll`	Lønnskjøring med skatt og arbeidsgiveravgift	lønn, payroll, lønnsberegning
Advanced	`year-end-closing`	Årsoppgjør etter norsk regnskapslov	årsoppgjør, årsregnskap, årsavslutning
Advanced	`month-end-closing`	Månedsslutt og MVA-oppgjør	månedsslutt, mva-oppgjør, terminoppgave
Advanced	`bank-reconciliation`	Bankavstemming mot konto 1920	bankavstemming, avstemming, bankbalanse
Advanced	`travel-expense`	Reiseregning og kjøregodtgjørelse	reiseregning, diett, kjøregodtgjørelse
Advanced	`receipt-expense`	Utlegg / kvittering mot konto 2930	utlegg, kvittering, refusjon

Full kildekode for hver flyt ligger i src/skills/. Registry og ressurs-definisjon: src/skills/registry.ts.

Kom i gang

1. Hent API-nøkler fra Tripletex

Du trenger to tokens:

Consumer token — søk om produksjonstilgang via developer.tripletex.no. Godkjenning tar typisk 2–3 uker. For testing kan du opprette en gratis testkonto med egne tokens.
Employee token — opprettes i Tripletex under Innstillinger → Integrasjoner → API-tilgang av en bruker med admin-rettigheter.

2. Installer

git clone https://github.com/cwv-ventures/tripletex-mcp.git
cd tripletex-mcp
npm install
npm run build

3. Koble til Claude Desktop

Legg til følgende i Claude Desktop sin konfigurasjonsfil:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/claude-desktop/claude_desktop_config.json

{
  "mcpServers": {
    "tripletex": {
      "command": "node",
      "args": ["/absolutt/sti/til/tripletex-mcp/dist/index.js"],
      "env": {
        "TRIPLETEX_CONSUMER_TOKEN": "din-consumer-token",
        "TRIPLETEX_EMPLOYEE_TOKEN": "din-employee-token"
      }
    }
  }
}

4. Testmiljø

For å bruke Tripletex sitt testmiljø (api-test.tripletex.tech) istedenfor produksjon, legg til:

"TRIPLETEX_ENV": "test"

i env-blokken.

Hvordan autentisering fungerer

Serveren håndterer alt automatisk:

Ved første kall opprettes en session token via PUT /v2/token/session/:create
Session token fornyes automatisk når den utløper (midnatt CET)
Alle API-kall bruker Basic Auth med brukernavn 0 og session token som passord

Du trenger ikke tenke på dette — bare sett consumer og employee token som miljøvariabler. Se autentiseringsflyten over for detaljer.

Eksempler på bruk

Når MCP-serveren er koblet til Claude, kan du si ting som:

"Logg 7.5 timer på prosjekt Konsulentbistand i dag"

Claude finner prosjektet, velger riktig aktivitet, og oppretter timeoppføringen.

"Vis alle fakturaer til Nordvik Bygg fra mars 2026"

Claude søker kunder, finner riktig ID, og henter fakturaene.

"Opprett ny kunde Havbruk Nord AS med org.nr 912 345 678"

Claude oppretter kunden direkte i Tripletex.

"Hvilke bilag ble ført forrige uke?"

Claude søker bilag med datofilter og viser en oversikt.

"Registrer kjøring fra Oslo til Drammen i dag, 42 km, personbil"

Claude slår opp satskategori for personbil, oppretter en reiseregning, legger til kjøregodtgjørelse med riktig sats, og rapporterer totalbeløp.

"Jeg kjørte til Ski i dag, 48 km. Hadde 85 kr i bompenger og 120 kr parkering"

Claude oppretter reiseregning med kjøregodtgjørelse pluss kostnadsrader for bompenger og parkering.

Kvalitetssikring

Dette er en fakta-orientert oversikt over hvordan serveren er bygget — tenkt som referanse for fagpersoner og ledelse.

PRD-samsvar mot Tripletex v2. Tynn proxy, ingen felt-aliaser: count (ikke quantity), unitPriceExcludingVatCurrency/unitPriceIncludingVatCurrency, isPrioritizeAmountsIncludingVat, vendorInvoiceNumber, amountGross/amountGrossCurrency, termOfPayment, og action-endepunkter med kolon-prefiks (:invoice, :sendToLedger, :deliver, :approve). Referanser wrappes til { id: N } i transform-laget — utad eksponeres bare customerId, vatTypeId, osv.
Eksklusive to-datoer er dokumentert i tool-beskrivelsene for search_supplier_invoices, search_vouchers m.fl. slik at LLM-en unngår den klassiske av-for-én-feilen.
Feilhåndtering for LLM self-correction. Alle Tripletex-feil returneres rått som JSON { httpStatus, tripletexResponse }, ikke som kastede exceptions. LLM-en ser validation-meldinger direkte og kan rette kallet uten menneskelig intervensjon.
Autentisering. Consumer + employee token byttes til en session token som caches til midnatt CET. 401 trigger automatisk fornyelse og én retry. Begge tokens leses fra miljøvariabler (TRIPLETEX_CONSUMER_TOKEN, TRIPLETEX_EMPLOYEE_TOKEN).
Domenekunnskap isolert fra tool-laget. Forretningsregler som «balanserende kredittpost på konto 2400 for leverandørfaktura» ligger i src/tripletex-transform.ts, ikke spredt utover tool-definisjonene.
Multi-tenant klar. TripletexClient har både env-basert konstruktør (stdio MCP) og TripletexClientOptions for programmatisk bruk — samme kodebase brukes av den hostede Regnskapsagent-MCP-en.
Typesikkerhet. TypeScript strict + Node16 modulmodus. Alle tool-inputs er definert med Zod-schemas og ender som typede argumenter i handlerne.
Multipart-opplasting (attach_voucher_document, import_ledger_voucher_document) validerer Base64 og håndhever 8 MB-grense før nettkall — beskytter både klient og Tripletex.
Optimistisk låsing på send_voucher_to_ledger via version-parameter, for å hindre race conditions ved parallell bokføring.
Versjon er pinnet til 2.4.0 i både src/index.ts og package.json.
Transport er stdio per MCP-spesifikasjonen; SDK @modelcontextprotocol/sdk ^1.12.1.

Kjent scope (roadmap)

Ingen automatiserte tester ennå — transform-funksjonene i src/tripletex-transform.ts er første kandidater for enhetstester.
Ingen eksplisitt 429/backoff-logikk (Tripletex har 5000 req/time; dagens retry dekker kun 401).
count-parameter cappes ikke eksplisitt mot Tripletex' maks (1000).
Ingen CHANGELOG.md — endringer spores i git-historikken.

Teknisk

Arkitektonisk referanse: docs/PRD-Tripletex-MCP-Rebuild.md — mål-API, DTO-tabeller, feltmapping mot Tripletex v2.
Tool-registreringer: src/tripletex-tools.ts — alle 56 server.tool(...), delt oppsett med Regnskapsagent via registerAllTools(server, client).
MCP skills (prompts): src/skills/ + ressursen tripletex://skills.
Runtime: Node.js 18+
Språk: TypeScript (strict)
Avhengigheter: @modelcontextprotocol/sdk ^1.12.1, zod ^4
Transport: stdio (standard MCP-protokoll)
API: Tripletex REST API v2 (tripletex.no/v2 / api-test.tripletex.tech/v2)

Bidra

Pull requests er velkomne! Åpne gjerne et issue hvis du har forslag til nye verktøy eller forbedringer.

Testing

Tests use Vitest and focus first on the pure transform functions in src/tripletex-transform.ts — request-body builders that mirror the Tripletex v2 DTO shapes exactly.

Commands

npm test — run the full test suite once
npm run test:watch — watch mode, re-run on file change
npm run test:coverage — run with coverage report (V8 provider, HTML + LCOV output in coverage/)

Scope

The current suite covers every exported function in src/tripletex-transform.ts:

transformOrderLine
buildOrderBody
transformVoucherPosting
buildSupplierInvoiceVoucherBody — including the balancing-credit invariant (sum of amountGross across all postings equals zero)
wrapPostingsForSupplierInvoiceUpdate

Client-level tests (auth, retries, HTTP transport) are intentionally deferred — those require mocking the Tripletex API and live in a follow-up. See tests/README.md for contributor conventions.

CI

GitHub Actions runs typecheck, tests, and build on every pull request and push to main. See .github/workflows/test.yml.

Lisens

MIT — se LICENSE for detaljer.

Name		Name	Last commit message	Last commit date
Latest commit History 21 Commits
.github/workflows		.github/workflows
docs		docs
src		src
tests		tests
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tsconfig.test.json		tsconfig.test.json
vitest.config.ts		vitest.config.ts

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Tripletex MCP Server

Trenger du hjelp til implementering?

I korte trekk

Arkitektur

Autentiseringsflyt

Hva kan den gjøre?

Skills (regnskapsflyter)

Kom i gang

1. Hent API-nøkler fra Tripletex

2. Installer

3. Koble til Claude Desktop

4. Testmiljø

Hvordan autentisering fungerer

Eksempler på bruk

Kvalitetssikring

Kjent scope (roadmap)

Teknisk

Bidra

Testing

Commands

Scope

CI

Lisens

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Tripletex MCP Server

Trenger du hjelp til implementering?

I korte trekk

Arkitektur

Autentiseringsflyt

Hva kan den gjøre?

Skills (regnskapsflyter)

Kom i gang

1. Hent API-nøkler fra Tripletex

2. Installer

3. Koble til Claude Desktop

4. Testmiljø

Hvordan autentisering fungerer

Eksempler på bruk

Kvalitetssikring

Kjent scope (roadmap)

Teknisk

Bidra

Testing

Commands

Scope

CI

Lisens

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages