Dokumentasjon

Flatene

Alt går gjennom samme kjerne og samme tilgang som appen. En API-nøkkel virker overalt.

API-nøkkel

Lag en nøkkel under Konto ▸ API-nøkler. Den begynner med dbk_ og vises bare én gang. Send den som Authorization: Bearer dbk_…. En nøkkel gjelder én avtalepart eller alle du er medlem av. Med en nøkkel for alle velger du avtalepart med headeren Dealbook-Workspace (id eller orgnr) i REST, eller argumentet workspace i hvert MCP-verktøy.

Grensen er 120 kall i minuttet per nøkkel. Over den svarer Dealbook 429 med Retry-After.

MCP

Claude Code

claude mcp add --transport http dealbook https://mcp.dealbook.no/mcp --header "Authorization: Bearer $DEALBOOK_API_KEY"

Cursor og andre klienter med headere

{
  "mcpServers": {
    "dealbook": {
      "url": "https://mcp.dealbook.no/mcp",
      "headers": { "Authorization": "Bearer dbk_…" }
    }
  }
}

claude.ai og ChatGPT

Legg til https://mcp.dealbook.no/mcp som connector og logg inn med 0-1 Kontoen din (OAuth). Du får katalogflaten under. Innloggingen gir foreløpig lesetilgang; for å lage utkast fra en agent bruker du en nøkkel.

To verktøysett

Med en nøkkel får du hele verktøysettet: avtaler, signering, aksjeeierboken, vedtektene, styret, styreprotokollen og innkallingen til styremøte. Verktøy som sender e-post, sier det i beskrivelsen og skal bare kalles etter at du har sagt ja.

Katalogflaten er verktøysettet for ChatGPT, Claude og andre kataloger. Den har ingen verktøy eller felter for fødselsnummer, sender ingen e-post eller signeringslenker og har ingen verktøy som fjerner, ugyldiggjør eller ruller tilbake. Agenten lager utkastet og gir deg lenken til appen, der du sender. Du kan prøve den med en nøkkel ved å sende headeren Dealbook-Surface: catalog.

Alle verktøy har tittel og annotasjonene readOnlyHint, destructiveHint og openWorldHint, så klienten kan be om bekreftelse før det som endrer, erstatter eller deler noe som finnes.

REST

curl https://api.dealbook.no/v1/me -H "Authorization: Bearer $DEALBOOK_API_KEY"
curl https://api.dealbook.no/v1/agreements -H "Authorization: Bearer $DEALBOOK_API_KEY"

Datalaget for avtaler er JSON Schema på api.dealbook.no/v1/schema (offentlig, uten nøkkel). Hvert smart dokument har sitt eget skjema, for eksempel /v1/share-registers/schema. Feil har alltid formen { "error": { "code", "message", "fields" } } med kodene invalid, unauthorized, forbidden, not_found, conflict, limit og rate_limited.

CLI

npx -y @companybook/dealbook login      # lim inn nøkkelen
dealbook send avtale.json --pdf avtale.pdf   # viser mottakerne, sender ingenting
dealbook send avtale.json --pdf avtale.pdf --yes
dealbook status 3fgfa34

dealbook --help viser alle kommandoene, og --json gir maskinlesbar utdata. Nøkkelen tas aldri som argument.