# LinkedIn API og AI-assistenter (MCP)

Alt, hvad du gør på LinkedIn-siderne, kan også gøres fra et script eller en AI-assistent: dine leads, køen af forbindelsesanmodninger, dine ICP-regler (inklusive hvilke lande du accepterer, og hvor stort et leads netværk skal være), din indbakke, dine AI-agenter og dine indstillinger.

Der er ikke noget nyt, der skal konfigureres. Den bruger den **samme API-nøgle som resten af <span data-t="appName">DM Champ</span>**, så hvis du allerede kalder vores API eller har en AI-assistent tilsluttet, er du klar.

## Hvor du finder din nøgle

Indstillinger → Integrationer → API-nøgle. Hvis du ikke har en endnu, skal du klikke på **Generer API-nøgle**. De fulde trin findes i [API-adgang](api-access.md).

Der er ingen separat LinkedIn-nøgle, der skal oprettes, roteres eller tilbagekaldes. Nøglen fungerer som dig, med de samme tilladelser, som du har i appen, så behandl den som en adgangskode. Hvis du tilbagekalder den i Indstillinger, afbrydes alle tilsluttede scripts og assistenter øjeblikkeligt.

## Kald af API'et direkte

- **Base-URL:** `https://app.sdrpilot.ai/api/v1`
- **Header:** `X-API-Key: YOUR_API_KEY`
- **Maskinlæsbar beskrivelse:** `https://app.sdrpilot.ai/api/v1/docs/openapi.yaml`
  (også tilgængelig som `.json`)

OpenAPI-dokumentet er offentligt og beskriver hver rute, så de fleste API-værktøjer og kodegeneratorer kan importere det direkte uden en nøgle.

`Authorization: Bearer YOUR_API_KEY` fungerer også. Hvad du ikke kan gøre, er at sende en forkert nøgle og håbe på, at den bliver godkendt af noget andet: Når en nøgle er præsenteret, baseres svaret på den nøgle.

Hvad der returneres, når noget er galt:

| Svar | Hvad det betyder |
|---|---|
| `401` | Nøglen mangler, er forkert formateret eller accepteres ikke. |
| `403` | Nøglen er gyldig, men den konto har intet LinkedIn-arbejdsområde eller har endnu ikke fået adgang. |
| `429` | For mange afviste forsøg på et minut for den nøgle. Sæt farten ned. |
| `502` `dmchamp_unreachable` | Vi kunne ikke tjekke din nøgle lige nu. Det betragtes aldrig som en godkendelse. Prøv igen. |

## Tilslutning af en AI-assistent

LinkedIn-værktøjerne findes på det samme MCP-endepunkt som <span data-t="appName">DM Champ</span>'s, med den samme API-nøgle, så en assistent, du allerede har tilsluttet, finder dem automatisk. Hvis du ikke har tilsluttet en endnu, skal du følge [Tilslut AI-assistenter (MCP)](connect-ai-clients.md) og bruge det endepunkt, der er angivet der.

::: master-only
Endepunktet er `https://mcp.youraiconnector.com/mcp`, godkendt med `X-API-Key`-headeren, præcis som beskrevet i Tilslut AI-assistenter (MCP).
:::

LinkedIn-værktøjerne har alle præfikset **`linkedin_`**, så de er nemme at få øje på i din assistents værktøjsliste og nemme at bede om ved navn ("brug LinkedIn-værktøjerne til at vise mig, hvad der ligger i kø"). Der er ingen tilladelser pr. værktøj: et værktøj kan gøre alt det, du selv kan gøre i appen.

## Eksempel 1 — acceptér kun leads fra bestemte lande

Din ICP-profil indeholder de regler, som leads skal overholde. Dette opretter en tilladelsesliste med Holland og Belgien. Landekoder er to bogstaver med store bogstaver.

```bash
curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'
```

To ting du skal vide. Brødteksten er det **komplette** regelsæt, ikke en rettelse: en regel, du udelader, bliver slået fra. Og svaret indeholder en `impact_on_queue`-blok, der fortæller dig, hvor mange allerede køede forbindelsesanmodninger der ikke ville overholde de nye regler, for eksempel `{"examined": 389, "would_withdraw": 155}`.
At gemme regler trækker ikke automatisk noget tilbage.

I en assistent ville du blot sige: "Indstil min ICP til kun at acceptere Holland og Belgien, og fortæl mig, hvad det ville betyde for min kø."

## Eksempel 2 — se hvad der ligger i kø

Forbindelsesanmodninger, der er blevet godkendt, men endnu ikke sendt:

```bash
curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"
```

Hver række indeholder personens navn, overskrift, virksomhed, lokation, land, antal forbindelser og følgere samt scoren. Du kan indsnævre listen med `country`, `min_score`, `max_score` og `source`, og bladre igennem den med `limit` og `cursor`. Kun køede anmodninger og anmodninger, der afventer godkendelse, vises her. Anmodninger, der allerede er sendt, er historik og kan ikke ændres.

## Eksempel 3 — træk alle uden for dine lande tilbage

Når du har ændret dine regler, skal du tjekke køen igen i forhold til dem. Uden `apply=true` er dette en forhåndsvisning, der ikke ændrer noget:

```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
  -H "X-API-Key: YOUR_API_KEY"
```

Du får svar på, hvor mange der blev undersøgt, hvor mange der ville blive trukket tilbage, og en opdeling pr. regel, såsom `country` og `network_too_small` (leadets netværk var mindre end dit minimum). Er du tilfreds? Kør det igen med `?apply=true`, så bliver disse anmodninger trukket tilbage.

```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
  -H "X-API-Key: YOUR_API_KEY"
```

Hvis du hellere vil trække et specifikt sæt tilbage, skal du i stedet indsende id'erne eller et filter såsom `{"filter":{"status":"queued","country":"NG"}}` for at tømme alt, der matcher. Send enten id'er eller et filter, ikke begge dele.

## Fejlfinding

- **`401` ved hvert kald** — nøglen mangler eller er forkert. Kopiér den igen fra Indstillinger → Integrationer → API-nøgle.
- **`403` selvom nøglen virker andre steder** — den konto er ikke knyttet til et LinkedIn-arbejdsområde, eller LinkedIn er endnu ikke aktiveret for den.
- **`502 dmchamp_unreachable`** — en midlertidig fejl ved tjek af din nøgle. Intet blev gennemført; prøv igen.
- **En regel matcher intet** — landekoder skal være med to store bogstaver (`NL`, ikke `Netherlands` eller `nl`), og sprogkoder skal være med små bogstaver.
- **Assistenten viser ingen LinkedIn-værktøjer** — genopret forbindelsen, så den genindlæser værktøjslisten, og tjek, at du bruger den samme API-nøgle.

---

## Næste skridt

- [Forbind AI-assistenter (MCP)](connect-ai-clients.md) — opsæt Claude, ChatGPT eller Cursor med din nøgle.
- [API-adgang](api-access.md) — generér eller roter den nøgle, dette bruger.