Forbind AI via MCP-server (fuld API-kontrol)

Salesbase eksponerer en Model Context Protocol (MCP)-server på https://app.salesbase.dk/api/mcp. I stedet for hundredvis af enkelte værktøjer får AI-klienten ca. 10 meta-værktøjer, der kan finde og kalde hele integrations-API'et (/api/v1) med din workspace API-nøgle.

Produktoversigt: MCP-server · Udviklerguide: AI-agenter

Forudsætninger

1. Gå til Indstillinger → API & Webhooks → API-nøgler
2. Opret en nøgle (fuld adgang som standard)
3. På gamle begrænsede nøgler: klik Fuld adgang (eller Scopes)
4. Kopiér MCP-URL under fanen Dokumentation (https://app.salesbase.dk/api/mcp)

Claude.ai (anbefalet)

Claude.ai custom connectors bruger OAuth (ikke en limet API-nøgle i connector-feltet):

1. Kopiér MCP-URL (https://app.salesbase.dk/api/mcp)
2. I Claude: Settings → Connectors → Add custom connector
3. Name: Salesbase, Remote MCP server URL: lim MCP-URL'en
4. Lad OAuth Client ID / Secret være tomme → Add → Connect
5. Log ind i Salesbase og vælg hvilken API-nøgle Claude må bruge

Cursor / Claude Desktop

Brug Streamable HTTP og Bearer-auth. Tilføj i MCP-config (fx .cursor/mcp.json eller Cursor Settings → MCP):

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

Erstat sb_DIN_NØGLE med jeres workspace API-nøgle. Gem aldrig nøglen i git.

Sådan arbejder agenten

1. salesbase_api_whoami — bekræft workspace og scopes
2. salesbase_search_api_endpoints / salesbase_list_api_endpoints — find ruter
3. salesbase_get_api_endpoint_schema — se parametre og required scope
4. salesbase_invoke_api_get — læs data
5. salesbase_invoke_api_write — skriv kun med confirm: true efter du har godkendt plan

Øvrige tools: docs-sektion, fuld markdown, workspace-søgning og batch-GET (op til 10 parallelle GETs).

Resultat

Agenten kan læse og (med jeres godkendelse) opdatere CRM-data under samme rettigheder som REST API. JWT-only mobil- og UI-ruter er skjult og blokeret.

Sikkerhed

• Skrivninger kræver bekræftelse i værktøjet (confirm: true)
• JWT-only mobil-ruter kan ikke kaldes via MCP
• Scopes og adgangskontrol er de samme som REST API
• Gem aldrig API-nøglen i git eller chatlogs
• Brug dedikerede nøgler til agenter og tilbagekald dem efter brug

Fejlsøgning

Problem	Løsning
401 Unauthorized	Tjek Bearer-nøgle eller genforbind Claude OAuth og vælg nøgle igen
Tools mangler / tom katalog	Bekræft at nøglen har integrations-scopes (fuld adgang)
Write afvist	Send confirm: true først efter bruger har godkendt planen
Endpoint ikke fundet	Brug search/list. Kun integrations-API er synlig (ikke mobil/UI)
Rate limit	Respekter 120/min og 50.000/dag pr. nøgle

Relateret

• Styr Salesbase med AI-agenter
• API og webhooks overblik
• Markdown API-reference
• Udvikler AI-agenter
• MCP-server produktside