Styr Salesbase med AI-agenter (Claude, Cursor m.fl.)

Salesbase kan styres af AI-klienter på to måder: MCP-server (anbefalet, tools der kalder API'et) eller Markdown API-reference + scripts (uden MCP).

Anbefalet: MCP-server

Forbind Claude.ai, Cursor eller Claude Desktop til https://app.salesbase.dk/api/mcp. Agenten får meta-værktøjer der finder endpoints, henter schemas og kalder GET/skriv under samme API-nøgle og scopes som REST.

Fuld setup: Forbind AI via MCP-server · Produktside: MCP-server · Udvikler: AI-agenter

Alternativ: Markdown-reference (scripts / uden MCP)

Når I bygger scripts, CI eller agenter uden MCP, skal agenten have:

1. Markdown-referencen (anbefalet) eller JSON-docs
2. API-nøgle i miljøvariabel (aldrig i git eller delte chats)
3. Projektregler der peger på referencen og kræver read-only test først

Hvor finder jeg Markdown-filen?

Kilde	URL / handling
Download i appen	Indstillinger → API & Webhooks → Forbind AI → Markdown → Download
Direkte URL	https://app.salesbase.dk/api/v1/docs/markdown
Download-link	https://app.salesbase.dk/api/v1/docs/markdown?download=true
JSON (alternativ)	https://app.salesbase.dk/api/v1/docs?full=true

Filen opdateres løbende fra samme registry som API-dokumentationen i appen. Den dækker integrations-endpoints (API-nøgle). Mobilapp-endpoints er ikke med.

Sektionerne Automations og Sequences i Markdown-filen dokumenterer alle triggers, actions, lookup-noder og sequence-steps med config-felter, så agenter kan bygge komplette flows via API.

Opret API-nøgle

1. Gå til Indstillinger → API & Webhooks
2. Fanen Nøgler
3. Klik Opret API-nøgle, giv den et navn (fx "Cursor agent")
4. Kopiér nøglen med det samme (vises kun én gang)
5. Gem i miljøvariabel, fx SALESBASE_API_KEY=sb_...

Cursor uden MCP

1. Download Markdown eller brug URL ovenfor
2. Tilføj Project Rules med:
   • Link til MD-URL
   • Base URL: https://app.salesbase.dk/api/v1
   • Auth: Authorization: Bearer <API_KEY> fra miljø
   • Regel: læs referencen før nye endpoints bruges
3. Bed agenten starte med GET-kald (fx /api/v1/companies) før POST/PUT/DELETE

For MCP-setup i Cursor, se MCP-server-guiden.

Claude Code

1. Opret CLAUDE.md i repo-roden med MD-URL og sikkerhedsregler
2. Sæt SALESBASE_API_KEY i .env (tilføj .env til .gitignore)
3. Bed Claude hente referencen ved opstart eller inkluder downloadet salesbase-api-docs.md i projektet

Claude Desktop og andre agenter

1. Foretræk MCP med Bearer-header (se MCP-guiden)
2. Eller download salesbase-api-docs.md og upload som projektviden
3. Gentag upload når API'et får nye endpoints
4. Kør API-kald via scripts med nøglen i miljøvariabler, ikke i chatten

Eksempel på agent-opgave (uden MCP)

Læs https://app.salesbase.dk/api/v1/docs/markdown
Find åbne deals uden aktivitet i 14 dage.
Brug kun GET først. Vis plan før ændringer.

Sikkerhed

• Brug dedikerede nøgler til agenter og tilbagekald dem efter brug
• Del aldrig nøgler i prompts, screenshots eller offentlige repos
• Bed agenten bekræfte destructive handlinger (sletning, bulk, import)
• Respekter rate limits: 120 requests/minut og 50.000/dag pr. nøgle
• Via MCP kræver skrivninger confirm: true i værktøjet

Relateret

• Forbind AI via MCP-server
• API og webhooks overblik
• API-reference på web
• Udvikler-hub AI-agenter
• MCP-server produktside