MCP-server for utviklere
Dobl er et regnskapssystem for små norske aksjeselskap. MCP-serveren gir en AI-klient tilgang til regnskapet gjennom de samme verktøyene som Dobl AI bruker i appen, innenfor tilgangene brukeren gir.
https://staging.dobl.no/api/mcpServer
Serveren er en fjernserver over Streamable HTTP med OAuth 2.1. Klienten trenger bare URL-en: resten finner den selv gjennom metadataene under Autentisering.
Full server
https://staging.dobl.no/api/mcpHele verktøyflaten. Brukes av Claude, Claude Code, Gemini CLI og egne klienter.
Katalogvariant
https://staging.dobl.no/api/mcp/katalogDe samme verktøyene, men feltene som tar imot et fullt fødselsnummer er fjernet fra inputskjemaet. Fødselsnummeret legges da inn i appen. Brukes av oppføringen i ChatGPT. Varianten er en egen OAuth-ressurs: et token for den ene serveren virker ikke på den andre.
Verktøybeskrivelser, feilmeldinger og data er på norsk bokmål. Beløp er number i kroner med to desimaler, og datoer er YYYY-MM-DD.
Autentisering
Et kall uten gyldig token gir 401 med WWW-Authenticate: Bearer … resource_metadata=…. Derfra gjør klienten oppdagelse, registrering og innlogging selv.
- Metadata for autorisasjonsserveren (RFC 8414) og for den beskyttede ressursen (RFC 9728) ligger på adressene i tabellen. Katalogvarianten har sin egen ressursmetadata med stisuffiks.
- Dynamisk klientregistrering (RFC 7591). Offentlige klienter (
token_endpoint_auth_method: none) støttes, i tillegg tilclient_secret_basicogclient_secret_post. - Bare autorisasjonskode-flyten (
response_type=code), og PKCE er påkrevd.code_challenge_methodmå væreS256;plainavvises. resource(RFC 8707) er valgfri. Uten den gjelder tokenet den fulle serveren. Med den må verdien være en av de to MCP-URL-ene, ellers svarer servereninvalid_target. Tokenetsaudblir ressursen klienten ba om.- Autorisasjonssvaret har
iss(RFC 9207), og metadataene sier det medauthorization_response_iss_parameter_supported. - Access-tokenet er en JWT signert med RS256 og varer i 1 time. Autorisasjonskoden varer i 1 minutt og kan brukes én gang.
- Refresh-tokenet varer i 30 dager og roteres ved hver bruk: det gamle trekkes tilbake, og svaret har et nytt refresh-token med ny levetid. Ved refresh kan klienten be om færre scopes, ikke flere.
- Tilbakekalling (RFC 7009) på revokeringsendepunktet.
| Endepunkter | URL |
|---|---|
| Metadata for autorisasjonsserverenRFC 8414 | https://staging.dobl.no/.well-known/oauth-authorization-server |
| Ressursmetadata, full serverRFC 9728 | https://staging.dobl.no/.well-known/oauth-protected-resource |
| Ressursmetadata, katalogvariantRFC 9728 | https://staging.dobl.no/.well-known/oauth-protected-resource/api/mcp/katalog |
| KlientregistreringRFC 7591 | https://staging.dobl.no/oauth/register |
| Autorisering | https://staging.dobl.no/oauth/authorize |
| Token | https://staging.dobl.no/oauth/token |
| TilbakekallingRFC 7009 | https://staging.dobl.no/oauth/revoke |
| JWKS | https://staging.dobl.no/.well-known/jwks.json |
Innloggingen skjer i nettleseren. Brukeren logger inn i Dobl, velger hvilke selskap koblingen skal dekke og krysser av for scopes. Klienten kan ikke fullføre innloggingen på vegne av brukeren.
Tilgang
To porter avgjør hva en agent får gjøre, og begge må åpne: scopene brukeren ga koblingen, og automasjonsnivået selskapet har valgt. Mangler scopet, svarer verktøyet insufficient_scope med required_scope.
Uten skrivetilgang viser serveren bare leseverktøyene.
Scopes
Trygge scopes er forhåndsvalgt på samtykkeskjermen, bortsett fra lønn. Farlige scopes gir irreversible eller utgående effekter, og brukeren må krysse av for dem selv.
| Scope | Gir | Type |
|---|---|---|
vouchers:read | Lese bilagene dineSe bilag, bilagslinjer og vedlegg. | TryggForhåndsvalgt |
vouchers:write | Opprette bilag som utkastOpprette bilagsutkast og laste opp dokumenter til innboksen — alt venter på godkjenning. | TryggForhåndsvalgt |
vouchers:post | Postere og reversere bilagPostere utkastbilag til hovedboken og reversere posterte bilag. Posterte bilag er immutable og synes i hovedboken. | Farlig |
invoices:read | Lese fakturaene dineSe fakturaer, kredittnotaer og tilhørende linjer. | TryggForhåndsvalgt |
invoices:write | Opprette fakturaer som utkastOpprette og endre fakturautkast, kreditnota-utkast og gjentakende fakturaer. Ingenting sendes til kunde uten egen tillatelse. | TryggForhåndsvalgt |
invoices:send | Bokføre og sende fakturaerBokføre, sende (EHF eller e-post) og kreditere fakturaer, og merke dem som betalte. Det som bokføres kan ikke angres, bare krediteres. | FarligUtgående |
reports:read | Lese regnskapsrapporterHente resultat, balanse, saldobalanse, hovedbok, MVA-oppgave og dashboard-tall. | TryggForhåndsvalgt |
annual:generate | Generere årsoppgjør og SAF-T-eksportKjøre årsoppgjør og eksportere SAF-T-filer. Gir tilgang til hele regnskapets historikk. | FarligUtgående |
accounts:read | Lese stamdataSe kontoplan, kunder, leverandører, produkter, prosjekter, bankkontoer og MVA-koder. | TryggForhåndsvalgt |
accounts:write | Endre stamdata og registreOpprette og endre kunder, leverandører, produkter, prosjekter, timeføring, bankkontoer, aksjonærer og MVA-meldingsstatus. Berører ikke hovedboken. | TryggUtgåendeForhåndsvalgt |
bank:pay | Sende betalinger til bankenOpprette betalinger som sendes rett til banken. Den endelige utbetalingen godkjennes av et menneske i bankappen. | FarligUtgående |
bank:reconcile | Avstemme og låse bankperioderLukke bankavstemmingen for en periode. Avstemmingen er balansedokumentasjon, og lukkingen låser perioden for videre bilagsføring mot kontoen — bare en admin kan gjenåpne den. | FarligUtgående |
filings:submit | Sende pliktige oppgaver til SkatteetatenSende aksjonærregisteroppgaven og MVA-meldingen på vegne av selskapet. En levert oppgave kan ikke trekkes tilbake — en feil må rettes med en ny oppgave. | FarligUtgående |
feedback:read | Lese tilbakemeldingene dineSe tilbakemeldingene du selv har sendt inn, og hvor de står i triagen. Gir ikke tilgang til andres tilbakemeldinger. | TryggForhåndsvalgt |
feedback:write | Sende tilbakemelding til DoblMelde fra om feil, foreslå funksjonalitet eller sende en kommentar på dine vegne. Går til Dobls produktteam, aldri til kundene dine, og berører ikke regnskapet. | TryggForhåndsvalgt |
payroll:read | Lese lønn og ansatteSe ansatte, arbeidsforhold, lønnskjøringer og a-meldingsstatus. Fødselsnummer vises alltid maskert. | Trygg |
payroll:write | Forberede lønnRegistrere og endre ansatte og arbeidsforhold, hente skattekort fra Skatteetaten og beregne lønnskjøringer som utkast. Ingenting posteres eller sendes inn med dette alene. | TryggUtgående |
payroll:submit | Sende a-meldingen til SkatteetatenLevere a-meldingen for en måned på vegne av selskapet. Meldingen gjelder hele måneden og erstatter en tidligere levert melding — en feil må rettes med en ny melding. | FarligUtgående |
me:read | Lese dine egne reiser, utlegg, timer og ansattinfoSe dine egne reiseregninger, utlegg og timer, ansattinfoen din og lønnsslippene dine, og regne ut diett og kjøregodtgjørelse. Gir ikke tilgang til selskapets regnskap eller andres data. | TryggForhåndsvalgt |
me:expenses:write | Lage utkast til egne reiseregninger og utleggLage og endre utkast til dine egne reiseregninger og utlegg. Du leverer selv i Dobl — agenten kan ikke levere eller godkjenne. | TryggForhåndsvalgt |
me:time:write | Føre dine egne timerFøre, endre og slette dine egne timer så lenge de ikke er fakturert. Agenten setter aldri timepris og ser ikke andres timer. | TryggForhåndsvalgt |
Automasjonsnivå
Hvert selskap har ett automasjonsnivå, satt av en admin eller eier under «AI-agenter» i appen. Det gjelder alle agenter i selskapet.
Lese NONE
Agenten kan lese og foreslå, men ikke opprette noe.
Foreslå DRAFT
Standard. Agenten oppretter utkast som et menneske godkjenner. Postering av bilag går bare etter at brukeren har bekreftet i chatten.
Gjøre FULL
Agenten kan postere, lukke bankavstemminger og levere pliktige oppgaver selv.
| Scope | Lese | Foreslå | Gjøre |
|---|---|---|---|
vouchers:write | avvises | virker | virker |
vouchers:post | avvises | kun etter bekreftelse i chatten | virker |
invoices:send | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) |
annual:generate | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) |
bank:pay | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) | virker (ikke styrt av nivået) |
bank:reconcile | avvises | avvises | virker |
filings:submit | avvises | avvises | virker |
payroll:submit | avvises | avvises | virker |
Scopes som ikke står i tabellen, påvirkes ikke av nivået. En avvisning fra nivået kommer som en feil som begynner med «Autonomi-nivå er …».
Verktøy 217
Listen er generert fra de samme modulene som serveren bruker, og viser det tekniske navnet, den norske tittelen (title), scopet verktøyet krever og annotasjonene klienten får. tools/list er alltid fasit.
Lese89 verktøy
Endrer ingenting. readOnlyHint: true, openWorldHint: false.
| Verktøy | Scope | Merking |
|---|---|---|
generate_annual_reportGenerer årsregnskap | annual:generate | Leser |
generate_saft_exportEksporter SAF-T | annual:generate | Leser |
generate_shareholder_register_reportLag aksjonærregisteroppgave | reports:read | Leser |
get_account_balanceVis kontosaldo | reports:read | Leser |
get_accrualVis periodisering | vouchers:read | Leser |
get_annual_accounts_submission_statusStatus for årsregnskapsinnsending | reports:read | Leser |
get_assetVis driftsmiddel | accounts:read | Leser |
get_balance_sheetVis balanse | reports:read | Leser |
get_bank_account_ledgerVis bankkontobevegelser | reports:read | Leser |
get_bank_reconciliationVis bankavstemming | reports:read | Leser |
get_contextHent selskapsoversikt | Ingen | Leser |
get_customerVis kunde | accounts:read | Leser |
get_customer_ledgerVis kundereskontro | reports:read | Leser |
get_distributable_equityVis utbytteramme | accounts:read | Leser |
get_distribution_prudenceVis forsvarlighetsvurdering | accounts:read | Leser |
get_employeeVis ansatt | payroll:read | Leser |
get_fileHent dokument | vouchers:read | Leser |
get_general_ledgerVis hovedbok | reports:read | Leser |
get_inbox_itemVis innbokselement | accounts:read | Leser |
get_income_statementVis resultatregnskap | reports:read | Leser |
get_investment_tax_checkAvstem investeringer mot skattemelding | accounts:read | Leser |
get_invoiceVis faktura | invoices:read | Leser |
get_invoice_recipientsMottakere for faktura | invoices:read | Leser |
get_my_contextVis meg som ansatt | me:read | Leser |
get_my_profileVis min ansattinfo og lønnsslipper | me:read | Leser |
get_payroll_preflightSjekk før lønnskjøring | payroll:read | Leser |
get_payroll_runVis lønnskjøring | payroll:read | Leser |
get_project_accountingVis prosjektregnskap | reports:read | Leser |
get_purchaseVis kjøpsdetaljer | vouchers:read | Leser |
get_purchase_reinvoiceVis viderefakturering på kjøp | invoices:read | Leser |
get_register_reconciliationAvstem registre mot hovedbok | accounts:read | Leser |
get_sales_documentHent tilbud/ordrebekreftelse | invoices:read | Leser |
get_shareholder_register_openingVis åpningsbalanse for aksjeeierboka | reports:read | Leser |
get_supplierVis leverandør | accounts:read | Leser |
get_trial_balanceVis saldobalanse | reports:read | Leser |
get_uninvoiced_timeVis ufakturerte timer | accounts:read | Leser |
get_vat_reportVis MVA-rapport | reports:read | Leser |
get_vendor_ledgerVis leverandørreskontro | reports:read | Leser |
get_voucherVis bilag | vouchers:read | Leser |
list_accountsVis kontoplan | accounts:read | Leser |
list_accrualsVis periodiseringer | vouchers:read | Leser |
list_activitiesVis aktiviteter | accounts:read | Leser |
list_assetsVis driftsmidler | accounts:read | Leser |
list_bank_accountsVis bankkontoer | accounts:read | Leser |
list_bank_paymentsVis kommende betalinger | reports:read | Leser |
list_bank_transactionsVis banktransaksjoner | reports:read | Leser |
list_capital_eventsVis kapitalhendelser | accounts:read | Leser |
list_customersVis kunder | accounts:read | Leser |
list_employeesVis ansatte | payroll:read | Leser |
list_expense_claimsVis utlegg til godkjenning | payroll:read | Leser |
list_feedbackVis dine tilbakemeldinger | feedback:read | Leser |
list_inbox_itemsVis innboks | accounts:read | Leser |
list_interim_balancesVis mellombalanser | accounts:read | Leser |
list_investmentsVis investeringer | accounts:read | Leser |
list_invoicesVis fakturaer | invoices:read | Leser |
list_loansVis lån | accounts:read | Leser |
list_my_claimsVis mine reiser og utlegg | me:read | Leser |
list_my_timeVis mine timer | me:read | Leser |
list_payroll_runsVis lønnskjøringer | payroll:read | Leser |
list_pending_workVis hva som venter | accounts:read | Leser |
list_productsVis produkter | accounts:read | Leser |
list_projectsVis prosjekter | accounts:read | Leser |
list_purchasesVis kjøp | vouchers:read | Leser |
list_recurring_invoicesVis repeterende fakturaer | invoices:read | Leser |
list_recurring_wage_linesList faste lønnslinjer | payroll:read | Leser |
list_reinvoice_itemsVis viderefakturering | invoices:read | Leser |
list_sales_documentsTilbud og ordrebekreftelser | invoices:read | Leser |
list_shareholdersVis aksjonærer | accounts:read | Leser |
list_suppliersVis leverandører | accounts:read | Leser |
list_time_entriesVis timeføringer | accounts:read | Leser |
list_travel_claimsVis reiseregninger til godkjenning | payroll:read | Leser |
list_vat_codesVis MVA-koder | accounts:read | Leser |
list_vat_returnsVis MVA-meldinger | reports:read | Leser |
list_voucher_templatesVis bilagsmaler | vouchers:read | Leser |
list_workplacesList arbeidssteder | payroll:read | Leser |
preview_accrualForhåndsvis periodisering | vouchers:read | Leser |
preview_invoice_reminderForhåndsvis purring | invoices:read | Leser |
preview_reverse_charge_vatForhåndsvis omvendt avgiftsplikt | reports:read | Leser |
preview_shareholder_registerForhåndsvis aksjonærregisteroppgave | reports:read | Leser |
preview_travel_allowanceRegn ut diett og kjøregodtgjørelse | me:read | Leser |
preview_vat_deduction_adjustmentForhåndsvis fradragsjustering | reports:read | Leser |
preview_year_end_closeForhåndsvis årsavslutning | reports:read | Leser |
preview_year_end_dispositionForhåndsvis disponering | reports:read | Leser |
preview_year_roll_forwardForhåndsvis årsrulling | reports:read | Leser |
review_period_evidenceHent kontrollgrunnlag for periode | vouchers:read | Leser |
search_helpSøk i hjelpesenteret | Ingen | Leser |
search_rettskilderSøk i Skatteetatens håndbøker | Ingen | Leser |
search_vouchersSøk i bilag | vouchers:read | Leser |
suggest_accountForeslå konto | accounts:read | Leser |
Endre i Dobl104 verktøy
Endrer data i Dobl, men treffer ingen systemer utenfor. «Legger til» betyr at verktøyet bare oppretter nye rader, som utkast og stamdata (destructiveHint: false). «Destruktiv» betyr at det endrer, sletter, posterer eller godkjenner (destructiveHint: true).
| Verktøy | Scope | Merking |
|---|---|---|
advance_interim_balanceOppdater mellombalanse | accounts:write | Destruktiv |
approve_accrualGodkjenn periodisering | vouchers:post | Destruktiv |
approve_expense_claimGodkjenn eller avvis utlegg | vouchers:post | Destruktiv |
approve_invoiceGodkjenn faktura | invoices:send | Destruktiv |
approve_travel_claimGodkjenn eller avvis reiseregning | vouchers:post | Destruktiv |
approve_voucherGodkjenn bilag | vouchers:post | Destruktiv |
cancel_accrualAvslutt periodisering | vouchers:post | Destruktiv |
cancel_reinvoice_itemFjern viderefakturering | invoices:write | Destruktiv |
close_fiscal_yearAvslutt regnskapsåret | vouchers:post | Destruktiv |
commit_bank_matchBokfør banktransaksjon | vouchers:post | Destruktiv |
convert_sales_documentGjør om til faktura eller ordre | invoices:write | Destruktiv |
create_accrualOpprett periodisering | vouchers:post | Destruktiv |
create_activityOpprett aktivitet | accounts:write | Legger til |
create_assetRegistrer driftsmiddel | accounts:write | Legger til |
create_bank_accountOpprett bankkonto | accounts:write | Legger til |
create_capital_eventOpprett kapitalhendelse | vouchers:write | Legger til |
create_customerOpprett kunde | accounts:write | Legger til |
create_employeeRegistrer ansatt | payroll:write | Legger til |
create_employment_contractRegistrer arbeidsforhold | payroll:write | Legger til |
create_expense_claimLag utkast til utlegg | me:expenses:write | Legger til |
create_interim_balanceRegistrer mellombalanse | accounts:write | Legger til |
create_investmentRegistrer investering | vouchers:write | Legger til |
create_invoiceOpprett faktura | invoices:write | Destruktiv |
create_loanRegistrer lån | vouchers:write | Destruktiv |
create_my_time_entryFør mine timer | me:time:write | Legger til |
create_payroll_runBeregn lønnskjøring | payroll:write | Legger til |
create_productOpprett produkt | accounts:write | Legger til |
create_projectOpprett prosjekt | accounts:write | Legger til |
create_purchaseRegistrer kjøp | vouchers:write | Legger til |
create_recurring_invoiceOpprett repeterende faktura | invoices:write | Legger til |
create_recurring_wage_lineLegg til fast lønnslinje | payroll:write | Legger til |
create_reverse_charge_vat_returnBokfør omvendt avgiftsplikt | vouchers:post | Destruktiv |
create_sales_documentOpprett tilbud/ordrebekreftelse | invoices:write | Legger til |
create_shareholderRegistrer aksjonær | accounts:write | Legger til |
create_supplierOpprett leverandør | accounts:write | Legger til |
create_time_entryFør timer | accounts:write | Legger til |
create_travel_claimLag utkast til reiseregning | me:expenses:write | Legger til |
create_voucherOpprett bilag | vouchers:write | Legger til |
create_workplaceRegistrer arbeidssted | payroll:write | Destruktiv |
credit_invoiceKrediter faktura | invoices:send | Destruktiv |
decide_sales_documentRegistrer svar på tilbud | invoices:write | Destruktiv |
delete_draft_invoiceSlett fakturautkast | invoices:write | Destruktiv |
delete_draft_payroll_runSlett lønnskjøring | payroll:write | Destruktiv |
delete_draft_purchaseSlett kjøpsutkast | vouchers:write | Destruktiv |
delete_draft_voucherSlett bilagsutkast | vouchers:write | Destruktiv |
delete_my_time_entrySlett mine timer | me:time:write | Destruktiv |
depreciate_assetKjør avskrivning | vouchers:post | Destruktiv |
dispose_fiscal_yearDisponer årsresultatet | vouchers:post | Destruktiv |
end_recurring_wage_lineAvslutt fast lønnslinje | payroll:write | Destruktiv |
explain_reconciliation_differenceForklar avstemmingsdifferanse | vouchers:write | Destruktiv |
extract_purchase_documentLes kvittering eller faktura | vouchers:write | Legger til |
ignore_bank_transactionIgnorer banklinje | vouchers:write | Destruktiv |
import_bank_statementImporter kontoutskrift | accounts:write | Destruktiv |
invoice_time_entriesFakturer timer | invoices:write | Destruktiv |
issue_invoiceBokfør faktura | invoices:send | Destruktiv |
mark_invoice_as_paidMerk faktura som betalt | invoices:send | Destruktiv |
mark_purchase_for_reinvoiceViderefakturer kjøp | invoices:write | Legger til |
mark_vat_return_previous_systemMarker MVA-termin som levert av forrige system | accounts:write | Destruktiv |
match_payment_to_invoiceKoble betaling mot faktura | invoices:write | Destruktiv |
pay_dividendUtbetal utbytte | vouchers:write | Destruktiv |
post_correction_voucherPostér korreksjonsbilag | vouchers:post | Destruktiv |
post_payroll_runPostér lønnskjøring | vouchers:post | Destruktiv |
post_vat_deduction_adjustmentFør fradragsjustering | vouchers:post | Destruktiv |
prepare_inbox_uploadForbered filopplasting til innboksen | vouchers:write | Legger til |
prepare_my_receipt_uploadForbered opplasting av kvittering | me:expenses:write | Legger til |
record_investment_bankruptcyRegistrer konkurs | vouchers:write | Legger til |
record_investment_capital_changeRegistrer kapitalendring | vouchers:write | Legger til |
record_investment_dividendRegistrer utbytte på investering | vouchers:write | Legger til |
record_investment_foundingRegistrer stiftelse | vouchers:write | Legger til |
record_investment_purchaseRegistrer aksjekjøp | vouchers:write | Legger til |
record_investment_revaluationRegistrer verdijustering | vouchers:write | Legger til |
record_investment_saleRegistrer aksjesalg | vouchers:write | Legger til |
record_investment_share_issueRegistrer emisjon | vouchers:write | Legger til |
record_investment_splitRegistrer splitt/spleis | vouchers:write | Legger til |
register_capital_increaseRegistrer kapitalforhøyelse | vouchers:write | Destruktiv |
register_inbox_uploadRegistrer fil i innboksen | vouchers:write | Legger til |
register_my_receiptRegistrer opplastet kvittering | me:expenses:write | Legger til |
request_missing_documentBe om manglende bilag | vouchers:write | Destruktiv |
reverse_accrualAngre periodisering | vouchers:post | Destruktiv |
reverse_capital_eventReverser kapitalhendelse | vouchers:write | Destruktiv |
reverse_investment_eventReverser investeringshendelse | vouchers:write | Destruktiv |
roll_forward_yearRull balansen til nytt år | vouchers:post | Destruktiv |
set_investment_agreementKoble avtale til investering | accounts:write | Destruktiv |
set_loan_agreementKoble låneavtale til lån | accounts:write | Destruktiv |
set_share_valuationSett formuesverdi per aksje | accounts:write | Destruktiv |
set_shareholder_register_openingRegistrer åpningsbalanse for aksjeeierboka | accounts:write | Destruktiv |
set_tax_cardLegg inn skattekort manuelt | payroll:write | Destruktiv |
set_tax_loss_carryforwardRegistrer fremførbart underskudd | accounts:write | Destruktiv |
submit_feedbackSend tilbakemelding | feedback:write | Legger til |
transfer_sharesOverdra aksjer | accounts:write | Destruktiv |
update_activityOppdater aktivitet | accounts:write | Destruktiv |
update_customerOppdater kunde | accounts:write | Destruktiv |
update_draft_invoiceEndre fakturautkast | invoices:write | Destruktiv |
update_draft_voucherEndre bilagsutkast | vouchers:write | Destruktiv |
update_employeeEndre ansatt | payroll:write | Destruktiv |
update_employment_contractEndre arbeidsforhold | payroll:write | Destruktiv |
update_investmentOppdater investering | accounts:write | Destruktiv |
update_productOppdater produkt | accounts:write | Destruktiv |
update_projectOppdater prosjekt | accounts:write | Destruktiv |
update_shareholderOppdater aksjonær | accounts:write | Destruktiv |
update_supplierOppdater leverandør | accounts:write | Destruktiv |
update_travel_claimEndre utkast til reiseregning | me:expenses:write | Destruktiv |
upsert_vat_returnLagre MVA-melding | vouchers:post | Destruktiv |
withdraw_my_claimSlett utkast til reise eller utlegg | me:expenses:write | Destruktiv |
Oppslag utenfor Dobl9 verktøy
Leser fra eksterne registre som Brønnøysundregistrene, Peppol-katalogen, Skatteetaten og Altinn, uten å endre noe. readOnlyHint: true, openWorldHint: true.
| Verktøy | Scope | Merking |
|---|---|---|
get_rettskildeHent punkt fra Skatteetatens håndbøker | Ingen | LeserUtenfor Dobl |
get_shareholder_register_receiptKvittering for aksjonærregisteroppgave | reports:read | LeserUtenfor Dobl |
get_shareholder_register_statusStatus for aksjonærregisteroppgave | reports:read | LeserUtenfor Dobl |
get_vat_return_statusStatus for MVA-melding | reports:read | LeserUtenfor Dobl |
lookup_brregSøk i Brønnøysundregistrene | accounts:read | LeserUtenfor Dobl |
lookup_brreg_annual_accountsHent årsregnskap fra Brønnøysund | accounts:read | LeserUtenfor Dobl |
lookup_brreg_rolesHent roller fra Brønnøysund | accounts:read | LeserUtenfor Dobl |
lookup_peppol_recipientSjekk EHF-mottaker | accounts:read | LeserUtenfor Dobl |
preview_previous_system_vat_returnsFinn MVA-meldinger levert av forrige system | reports:read | LeserUtenfor Dobl |
Utgående15 verktøy
Når noen utenfor Dobl og kan ikke tas tilbake: sender faktura eller purring, leverer til Skatteetaten eller Altinn, eller legger betalinger til godkjenning i banken. openWorldHint: true.
| Verktøy | Scope | Merking |
|---|---|---|
check_a_melding_feedbackHent tilbakemelding på a-melding | payroll:write | DestruktivUtenfor Dobl |
close_bank_reconciliationLukk bankavstemming | bank:reconcile | DestruktivUtenfor Dobl |
create_bank_paymentSend betaling | bank:pay | DestruktivUtenfor Dobl |
create_payroll_paymentsBetal lønn | bank:pay | DestruktivUtenfor Dobl |
deliver_invoiceLever faktura | invoices:send | DestruktivUtenfor Dobl |
fetch_tax_cardsHent skattekort | payroll:write | DestruktivUtenfor Dobl |
import_employees_from_a_ordningenHent ansatte fra a-ordningen | payroll:write | DestruktivUtenfor Dobl |
import_previous_system_vat_returnsRegistrer MVA-meldinger levert av forrige system | accounts:write | DestruktivUtenfor Dobl |
prepare_annual_accounts_submissionKlargjør årsregnskap for innsending | annual:generate | DestruktivUtenfor Dobl |
send_invoiceSend faktura | invoices:send | DestruktivUtenfor Dobl |
send_invoice_reminderSend purring | invoices:send | DestruktivUtenfor Dobl |
send_sales_documentSend tilbud/ordrebekreftelse | invoices:send | DestruktivUtenfor Dobl |
submit_a_meldingSend a-melding | payroll:submit | DestruktivUtenfor Dobl |
submit_shareholder_registerSend aksjonærregisteroppgave | filings:submit | DestruktivUtenfor Dobl |
submit_vat_returnSend MVA-melding | filings:submit | DestruktivUtenfor Dobl |
For holdingselskaper er salgs- og lønnsverktøyene slått av. Er brukeren bare ansatt i et selskap, får agenten bare verktøyene for egne reiser, utlegg, timer og lønnsslipper.
Sikkerhet og data
Posterte bilag endres aldri
Et postert bilag kan verken endres eller slettes, heller ikke over MCP. Feil rettes med et korreksjonsbilag. På nivåene «Lese» og «Foreslå» posterer agenten ingenting selv: det den fører, lagres som utkast som et menneske godkjenner, i Dobl eller ved å bekrefte i chatten. Bare på «Gjøre» kan agenten postere selv. Unntaket er fakturaene: verktøyene som utsteder, sender eller krediterer en faktura, bokfører den uansett nivå. De styres av scopene invoices:write og invoices:send, ikke av automasjonsnivået.
Betalinger godkjennes i banken
create_bank_payment og create_payroll_payments legger betalinger til godkjenning i banken. Verktøyene kan ikke gjennomføre betalingen: pengene flyttes først når en person godkjenner og signerer betalingen i banken med BankID. Begge krever det farlige scopet bank:pay, som brukeren må krysse av for selv. Automasjonsnivået styrer ikke dette scopet.
Fødselsnummer
Felt med fødselsnummer i verktøysvarene er maskert som DDMMÅÅ***** på begge serverne. Den fulle serveren tar imot et fullt fødselsnummer i feltene under, og lagrer det kryptert. På katalogvarianten er de fjernet fra inputskjemaet, og sender en klient dem likevel, fjernes de fra kallet:
create_employee:nationalIdNumberupdate_employee:nationalIdNumbercreate_shareholder:personNumber
Dobl mottar verktøykall, ikke samtalen
Klienten sender verktøynavnet og argumentene. Dobl ser ikke resten av samtalen, andre koblinger i klienten eller filer som ikke lastes opp gjennom et verktøy. Endringer agenten gjør, logges i revisjonssporet med agenten som aktør.
Bare dine selskap
Agenten får bare tilgang til selskapene brukeren er medlem av og velger på samtykkeskjermen, og bare scopene brukeren krysser av for. Verktøyene kjører som brukeren, under de samme tilgangsreglene i databasen som appen. Samtykket leses på nytt ved hvert kall, så en endring slår gjennom med en gang.
Slik trekker du tilbake tilgangen
Velg «AI-agenter» i menyen i Dobl. Der står hver tilkobling med selskapene og scopene den har. «Trekk tilbake» kobler den fra: refresh-tokenene slutter å virke, og serveren avviser tilkoblingens access-token fra neste kall. Samme sted kan du snevre inn scopes og selskap.
Klientoppsett
Claude
claude.ai og Claude Desktop: Innstillinger → Koblinger. Legg til Dobl som egendefinert kobling med URL-en til den fulle serveren, og logg inn.
https://staging.dobl.no/api/mcpSteg for steg i hjelpesenteret →Claude Code
Legg til serveren med kommandoen under, start Claude Code på nytt og kjør /mcp for å logge inn. Pluginen pakker serveren og arbeidsflyt-skillene sammen.
claude mcp add --transport http dobl https://staging.dobl.no/api/mcpMed pluginclaude plugin marketplace add dobl-no/plugins
claude plugin install dobbel@dobbelChatGPT
Legg til en egendefinert kobling med URL-en. Dobl er ikke i ChatGPT-katalogen ennå; når innsendingen er godkjent, bruker oppføringen katalogvarianten.
https://staging.dobl.no/api/mcpSteg for steg i hjelpesenteret →Gemini CLI
Legg til serveren med kommandoen under, og logg inn når Gemini CLI ber om det.
gemini mcp add --transport http dobl https://staging.dobl.no/api/mcpSteg for steg i hjelpesenteret →Andre MCP-klienter
Legg til serveren som HTTP-transport med URL-en. Klienten må støtte OAuth 2.1 med oppdagelse og dynamisk registrering.
https://staging.dobl.no/api/mcpSteg for steg i hjelpesenteret →Lenker
Spørsmål om integrasjonen: hjelp@dobl.no