Koble en AI-agent til Bedrifty (MCP)

Bedrifty støtter Model Context Protocol (MCP), en åpen standard som lar AI-agenter snakke direkte med CRM-et ditt. Når du har koblet til en agent, kan den søke bedrifter, hente personer, opprette oppgaver og notater — alt arbeidsområde-scopet, alt logget, og opphevbart når som helst.

Hva kan agenten gjøre?

Seks verktøy er tilgjengelige i v1:

• bedrifter_search — søk i bedrifter på navn, organisasjonsnummer, kommune eller aktivitet
• bedrifter_get — hent én bedrift med siste 10 aktiviteter og åpne oppgaver
• personer_search — søk personer på navn eller e-post, eventuelt scopet til én bedrift
• personer_get — hent én person med detaljer
• oppgaver_create — opprett en oppgave knyttet til en bedrift eller person
• notater_create — legg til et notat på en bedrift eller person

Alle skrivekall krever en idempotency_key slik at agenter som prøver på nytt ikke dupliserer oppgaver eller notater.

Eksempler — fem ting du kan be agenten om

1. «Finn bedrifter i porteføljen min uten aktivitet de siste 30 dagene.» Agenten kjører bedrifter_search med no_activity_since_days: 30 og lister opp inntil 20 treff.

2. «Opprett en oppfølgingsoppgave på Söderberg & Partners til torsdag.» Agenten finner bedriften via bedrifter_search, så oppgaver_create med due_date: "2026-04-30".

3. «Skriv et notat på Ola Nordmann om at vi snakket om Q3-resultater.» personer_search → notater_create med innholdet ditt.

4. «Hva er status på Acme AS? Vis meg de siste aktivitetene og åpne oppgaver.» bedrifter_get returnerer bedriftsdetaljer, siste 10 aktiviteter og inntil 10 åpne oppgaver i én respons.

5. «List opp alle personer hos Söderberg som jeg har kontaktinformasjon for.» bedrifter_search → personer_search med company_id.

Slik kobler du til (30 sekunder)

Steg 1: Velg klient

Bedrifty støtter alle klienter som snakker MCP over HTTP. Vanligst:

• Claude Code (CLI fra Anthropic) — anbefalt for utviklere og power users
• Cursor — for de som koder i Cursor
• Claude Desktop — venter på remote-MCP-støtte (kommer i 2026)

Steg 2: Kjør tilkoblingskommandoen

Gå til Innstillinger → AI-agenter (MCP) i Bedrifty. Der finner du ferdige kommandoer du bare kan kopiere. For Claude Code:

claude mcp add --transport http bedrifty https://app.bedrifty.no/api/mcp

For Cursor — lim inn i ~/.cursor/mcp.json (eller via Settings → MCP):

{
  "mcpServers": {
    "bedrifty": {
      "url": "https://app.bedrifty.no/api/mcp",
      "transport": "http"
    }
  }
}

Steg 3: Godkjenn på /device

Klienten viser deg en URL og en kode (f.eks. WDJB-MJHT). Åpne URL-en, eller gå direkte til /device og lim inn koden. Du logger inn i Bedrifty (om du ikke allerede er det), velger arbeidsområdet du vil gi tilgang til, og klikker Godkjenn.

Steg 4: Test tilkoblingen

Be agenten om noe enkelt: «Finn de siste fem bedriftene jeg har lagt til.» Den skal svare med en liste i løpet av sekunder. Tilkoblingen dukker opp under Aktive tilkoblinger i Innstillinger → AI-agenter (MCP).

Sikkerhet og kontroll

• Arbeidsområde-scopet på token-nivå. En tilkobling gir tilgang til ett arbeidsområde — ikke alle dine arbeidsområder. Vil agenten din se Codenord-data, må du koble den til på nytt og velge Codenord på godkjenningssiden.
• Audit-logget. Hvert tool-kall lagres i crm_mcp_audit med tidspunkt, IP, user-agent og resultat. Kan eksporteres for compliance.
• Opphev når som helst. I Innstillinger → AI-agenter (MCP) klikker du Opphev ved siden av en tilkobling — neste tool-kall fra den klienten avvises umiddelbart.
• Én klient om gangen. Per nå er flyten optimalisert for å koble til én klient ad gangen. Ønsker du flere agenter, koble dem til etter tur (f.eks. Claude Code først, så Cursor).
• Idempotente skriv. Skrivekall (oppgaver, notater) krever en idempotency_key. Det samme nøkkel + samme argumenter = samme resultat (cached). Samme nøkkel + andre argumenter = IDEMPOTENCY_CONFLICT. Forhindrer at en agent som prøver på nytt dupliserer arbeid.

Vanlige problemer

«Klienten henger på godkjenning.» Sjekk at du faktisk fullførte godkjenningen i nettleseren (klikket Godkjenn, ikke bare lukket fanen). Klienten poller hvert 5. sekund — kan ta opp til 10 sekunder etter du klikker.

«Device code is invalid, expired, or already used.» Kodene utløper etter 30 minutter. Generer en ny ved å kjøre claude mcp add på nytt.

«MCP er ikke tilgjengelig på din plan.» Du er på Gratis, Pro eller Trial. Oppgrader til Business eller høyere for å aktivere agent-tilgang.

Glemt hvilke klienter du har koblet til? Innstillinger → AI-agenter (MCP) viser alle aktive tilkoblinger med IP, user-agent og siste bruk.