MCP-guide: koble Companybook til agenten din

Oppsett uten å dele nøkler i chatten

MCP er standarden som lar agenten kalle Companybooks verktøy. Start i installasjonsveiledningen og velg klienten din. OAuth åpner Companybook i nettleseren, der du logger inn og godkjenner tilgangen. Egne skript kan bruke en API-nøkkel fra tilgangsoversikten. En nøkkel skal lagres i klientens sikre oppsett eller en miljøvariabel, aldri i en samtale eller et kodearkiv.

Codex, Claude Code og Cursor har ulike kommandoer og konfigurasjonsfiler. En egendefinert tilkobling er heller ikke det samme som en publisert katalogapp. Klientens plan, region og administrator kan begrense hvilke tilkoblinger du kan bruke.

Prompt til agenten som hjelper med oppsettet

Koble dette prosjektet til Companybook med MCP. Les https://companybook.co/mcp/install og bruk oppsettet for klienten jeg bruker. Serveren er https://companybook.co/api/mcp. Jeg oppretter konto, logger inn og godkjenner tilgangen i nettleseren selv. Ikke be meg lime inn passord eller tokens i samtalen, og ikke legg hemmeligheter i prosjektfiler. Behold eksisterende tilkoblinger. Hent tools/list etter tilkobling og bruk bare verktøy som faktisk er tilgjengelige. Test med cb_resolve for Equinor, types=["org"], limit=3. Vis kilde og eventuelle mangler. Ikke start betalt research eller gjenta kall for å omgå en grense.

REST for apper og skript

Velg REST når du vil styre kallene fra egen kode. OpenAPI-dokumentet beskriver operasjoner og parametere. REST krever Plus (personlig) eller Business Plus (team); MCP er åpent for alle planer. All bruk måles, og REST og MCP deler kontoens grenser, så en ekstra nøkkel gir ikke en ekstra kvote. Vi tilbyr ikke et eget GraphQL-grensesnitt.

La agenten kontrollere dokumentet før den lager integrasjonen. Hvis det ikke er tilgjengelig, er det ikke et signal om å prøve udokumenterte endepunkter. Start med ett avgrenset oppslag og behold kilder, tidsstempler og forbehold i resultatet.

Koble dette prosjektet til Companybook REST API. Les først https://companybook.co/api/v1/openapi.json og bruk bare operasjonene som finnes der. Hvis dokumentet ikke er tilgjengelig, stopp og forklar det; ikke gjett endepunkter eller bruk eldre GraphQL-eksempler. Jeg oppretter Companybook-konto med Plus (REST krever Plus) og en API-nøkkel i https://companybook.co/dashboard/mcp selv. For masseoppslag, følg https://companybook.co/no/guide/api.md. Les nøkkelen fra en sikker miljøvariabel på serveren; ikke be meg lime den inn i chatten, ikke logg den og ikke legg den i nettleserkode eller git. Behold eksisterende konfigurasjon. Test med ett GET-kall til https://companybook.co/api/v1/resolve?query=Equinor&types=%5B%22org%22%5D&limit=3, med Authorization: Bearer fra miljøvariabelen. Vis kilde, as_of, coverage og eventuell truncated-status fra svaret. Ingen automatisk paginering eller masseeksport. Ved 429: følg Retry-After og avslutt hvis grensen fortsatt gjelder; ikke roter nøkler. Ikke start research eller andre kall som bruker credits uten at jeg har godkjent kostnadsrammen. Vis hvordan jeg kan følge forbruk og tilbakekalle nøkkelen i Companybook.

Skal du hente mange selskaper inn i et eget system, følg API-guiden: batch-oppslag med regnskapshistorikk og underenheter, grenser, feilhåndtering og nattlig synk.

Et første oppslag

Be agenten finne Equinor med cb_resolve, og deretter bruke den returnerte ID-en i cb_get. Oppgi hvilke opplysninger du trenger og hvor mange selskaper du vil sammenligne.

«Finn Equinor ASA. Vis organisasjonsnummer, tilgjengelige selskapsfakta og direkte eierskap. Oppgi kildene, og si fra hvis noe mangler eller resultatet er avkortet.»

{
  "method": "tools/call",
  "params": {
    "name": "cb_resolve",
    "arguments": {
      "query": "Equinor",
      "types": [
        "org"
      ],
      "limit": 3
    }
  }
}

Grafverktøyene

Hent tools/list fra tilkoblingen for gjeldende verktøy og parametere. Agenten skal bruke denne listen, ikke gjette verktøynavn fra eldre eksempler.

cb_resolve: Finn riktig selskap eller annen enhet og bruk ID-en i videre oppslag.
cb_get: Hent tilgjengelige fakta og relasjoner for valgte ID-er. include velger relasjonstyper, ikke antall regnskapsår.
cb_search: Finn et avgrenset utvalg selskaper med strukturerte filtre.
cb_traverse: Følg bestemte relasjoner, for eksempel eierskap. Begrens antall hopp og noder.
cb_signals: Les daterte observasjoner for valgte selskaper.
cb_explain: Hent kildene bak en relasjon eller et signal. Bruk en ID fra et tidligere svar.
cb_watch: Fortsett lesing av signaler med en cursor. Dette oppretter ikke varsling eller en lagret overvåking.

Hva svaret faktisk dekker

Grafverktøyene svarer med cb/v1. Se coverage for mangler, warnings for forbehold og as_of for tidspunkt. truncated betyr at resultatet er avkortet. En cursor kan hente neste side med samme filtre, men er ingen tillatelse til å kopiere hele databasen.

Et tomt svar beviser ikke at en hendelse aldri har skjedd. Dekning og oppdateringstid varierer mellom kildene. cost.units er målt datamengde, ikke en pris i kroner eller brukerens creditsaldo. Vis kildelenkene sammen med konklusjonen, og skill registrerte fakta fra agentens tolkning.

Tilgang og forbruk

Du kan se og tilbakekalle tilkoblinger i tilgangsoversikten og følge oppslag i bruksoversikten. Respekter tilgangsgrenser og vent før et begrenset kall prøves igjen. Ikke opprett flere nøkler for å omgå grensene. Nye researchfunksjoner skal ikke brukes før de er tilgjengelige i tilkoblingen og har et godkjent budsjett.

Command Palette