Salesbase
← Udvikler-hub

AI-AGENTER

Styr Salesbase
med Claude, Cursor m.fl.

Anbefalet: forbind AI-klienten til Salesbase MCP-server på https://app.salesbase.dk/api/mcp. Agenten får tools der finder endpoints og kalder hele integrations-API'et. Markdown-referencen er fallback til scripts og agenter uden MCP.

Se MCP-serverDownload API Markdown

MCP (anbefalet)

https://app.salesbase.dk/api/mcp

Markdown

https://app.salesbase.dk/api/v1/docs/markdown

JSON

https://app.salesbase.dk/api/v1/docs?full=true

MCP

Forbind AI med tools
fuld API-kontrol

Cirka 10 meta-værktøjer lister, søger, schema'er og kalder /api/v1. Samme API-nøgle og scopes som REST. Skrivninger kræver confirm: true.

Hele integrations-API'et

Companies, people, leads, deals, sequences, automations, webhooks, tilbud, custom objects, SMS, import/export m.m. under API-nøglens scopes.

Én tool-flade

Ca. 10 meta-værktøjer i stedet for ét tool pr. endpoint. Agenten lærer ruter via list/search/schema.

Sikre skrivninger

Write kræver confirm: true. Samme rate limits og adgangskontrol som REST. Mobil/UI-ruter er blokeret.

De 10 MCP-tools

ToolHvad det gør
salesbase_list_api_endpointsKompakt katalog over method + path for hele integrations-API'et
salesbase_search_api_endpointsSøg i kataloget med keyword eller naturligt sprog
salesbase_get_api_endpoint_schemaParams, body, required scope og docs for ét endpoint
salesbase_invoke_api_getProxy for GET/HEAD (læs data)
salesbase_invoke_api_writePOST/PUT/PATCH/DELETE. Kræver confirm: true
salesbase_api_docs_sectionHent en docs-sektion (fx deals, webhooks)
salesbase_api_docs_markdownFuld Markdown-reference (stor payload)
salesbase_api_whoamiWorkspace, bruger og effektive scopes
salesbase_api_searchGenvej til GET /api/v1/search i workspace
salesbase_api_batch_getOp til 10 parallelle GET-kald
1

Opret API-nøgle

Gå til Indstillinger → API & Webhooks → Nøgler. Kopiér MCP-URL under Forbind AI.

2

Forbind klienten

Cursor/Desktop: Bearer-header. Claude.ai: custom connector med OAuth (tom Client ID/Secret).

3

Discover → schema → invoke

Start med whoami, list/search endpoints, hent schema, kør GET. Write kun med confirm: true.

4

Sikkerhed

Samme scopes som REST. JWT-only mobilruter er blokeret. Brug dedikerede nøgler til agenter.

Cursor / Claude Desktop (Bearer)

Tilføj i MCP-config. Erstat nøglen. Se også hjælpecenter-guiden.

json
{
  "mcpServers": {
    "salesbase": {
      "url": "https://app.salesbase.dk/api/mcp",
      "headers": {
        "Authorization": "Bearer sb_DIN_NØGLE"
      }
    }
  }
}

Claude.ai (OAuth)

  1. Kopiér MCP-URL under Indstillinger → API & Webhooks → Forbind AI
  2. Settings → Connectors → Add custom connector · Name: Salesbase
  3. Lim MCP-URL. Lad OAuth Client ID/Secret være tomme → Add → Connect
  4. Log ind i Salesbase og vælg hvilken API-nøgle Claude må bruge

UDEN MCP

Markdown-reference
til scripts og prompts

Filen genereres live fra Salesbase API-registry. Den indeholder autentifikation, rate limits, alle integrations-endpoints, webhook-events og eksempler. Mobilapp-endpoints er filtreret fra.

1

Hent MD-referencen

Download eller peg agenten mod den offentlige Markdown-fil. Den opdateres fra samme registry som API-dokumentationen i appen.

2

Giv agenten en API-nøgle

Opret en nøgle under Indstillinger → API & Webhooks. Gem nøglen i miljøvariabel, aldrig i repo eller prompts der deles.

3

Bind regler til projektet

Tilføj MD-URL og sikkerhedsregler i Cursor Rules, CLAUDE.md eller tilsvarende, så agenten kender endpoints før den handler.

4

Test read-only først

Start med GET (companies, leads, deals). Når flowet virker, kan agenten oprette/opdatere via POST og PUT.

OPSÆTNING

Per værktøj
uden MCP

Samme MD-kilde til alle. Forskel er kun hvordan du injecter den i agentens kontekst. Foretræk MCP når klienten understøtter det.

Cursor (uden MCP)

  1. Download MD: brug Download-knappen i appen under Forbind AI → Markdown, eller hent fra MD-URL.
  2. Project Rules: indsæt regler med MD-URL og auth-krav (se eksempel nedenfor).
  3. Docs: tilføj https://app.salesbase.dk/api/v1/docs/markdown som ekstern doc-kilde hvis dit setup understøtter det.
  4. Bed agenten læse referencen før den skriver integrationskode.

Claude Code

  1. Opret CLAUDE.md i repo-roden med MD-URL og API-base (se eksempel).
  2. Sæt SALESBASE_API_KEY i miljø (.env) og load det i terminal-session.
  3. Bed Claude hente MD ved opstart: curl eller @web fetch mod MD-URL.
  4. Brug eksplicit read-only prompts indtil du stoler på flowet.

Claude Desktop & andre agenter

  1. Foretræk MCP med Bearer-header (se sektionen ovenfor).
  2. Eller upload salesbase-api-docs.md som projektviden.
  3. Alternativt: peg agenten på JSON-URL for struktureret parsing.
  4. Del aldrig API-nøglen i chat; brug lokale scripts med env vars.

EKSEMPLER

Kopiér direkte
til dit projekt

Tilpas navne og stier. Hold API-nøglen ude af git. Til MCP, se config ovenfor.

Cursor Project Rules

markdown
# Salesbase API

Før du kalder Salesbase API, læs den officielle reference:
https://app.salesbase.dk/api/v1/docs/markdown

- Base URL: https://app.salesbase.dk/api/v1
- Auth: Authorization: Bearer sb_<API_KEY> (aldrig i git)
- Rate limit: 120/min, 50.000/dag
- Kun integrations-endpoints (mobil/JWT-endpoints er uden for scope)

Når du bygger integrationer: brug GET/POST/PUT/DELETE mod /api/v1/* og respekter workspace isolation.

CLAUDE.md (Claude Code)

markdown
# Salesbase CRM API

## Reference
Hent og følg API-dokumentationen her (opdateres løbende):
https://app.salesbase.dk/api/v1/docs/markdown

## Autentifikation
- Header: Authorization: Bearer $SALESBASE_API_KEY
- Opret nøgle: Indstillinger → API & Webhooks i appen

## Arbejdsregler for agenten
1. Læs MD-referencen før nye endpoints bruges
2. Brug kun dokumenterede /api/v1 integrations-endpoints
3. Bekræft destructive handlinger (DELETE, bulk) med brugeren
4. Log fejl fra API (status + error body) og foreslå fix

Miljøvariabler

env
# Lokalt (.env - aldrig commit)
SALESBASE_API_KEY=sb_din_nøgle_her
SALESBASE_API_BASE=https://app.salesbase.dk/api/v1

Testforbindelse

bash
curl -s 'https://app.salesbase.dk/api/v1/companies?limit=1' \
  -H "Authorization: Bearer $SALESBASE_API_KEY"

Eksempel-prompt til agent

text
Du har adgang til Salesbase CRM via REST API.
Læs https://app.salesbase.dk/api/v1/docs/markdown for endpoints, felter og eksempler.

Opgave: Find alle åbne deals over 50.000 kr uden aktivitet i 14 dage.
Brug kun GET-kald først. Vis mig planen før du laver ændringer.

SIKKERHED

Gode vaner
når agenter har API-adgang

  • Brug dedikerede API-nøgler til agenter. Tilbagekald dem når opgaven er færdig.
  • Gem nøgler i miljøvariabler eller hemmelighedslager. Aldrig i Markdown, git eller delte chats.
  • Via MCP kræver skrivninger confirm: true. Bekræft også DELETE, bulk SMS og import uden MCP.
  • Start read-only. Giv write-adgang først når du har set korrekte GET-resultater fra dit workspace.

Klar til at give agenten adgang?

Forbind MCP-serveren, eller download Markdown-referencen og opret en API-nøgle.

Se MCP-serverSe API-reference