# LinkedIn-API och AI-assistenter (MCP)

Allt du gör på LinkedIn-sidorna kan även göras från ett skript eller en AI-assistent: dina leads, kön för anslutningsförfrågningar, dina ICP-regler (inklusive vilka länder du accepterar och hur stort ett leads nätverk måste vara), din inkorg, dina AI-agenter och dina inställningar.

Det finns inget nytt att konfigurera. Den använder **samma API-nyckel som resten av <span data-t="appName">DM Champ</span>**, så om du redan anropar vårt API eller har en AI-assistent ansluten är du redo.

## Var du hittar din nyckel

Inställningar → Integrationer → API-nyckel. Om du inte har en ännu, klicka på **Generera API-nyckel**. De fullständiga stegen finns i [API-åtkomst](api-access.md).

Det finns ingen separat LinkedIn-nyckel att skapa, rotera eller återkalla. Nyckeln agerar som du, med samma behörigheter som du har i appen, så behandla den som ett lösenord. Att återkalla den i Inställningar bryter omedelbart anslutningen för alla anslutna skript och assistenter.

## Anropa API:et direkt

- **Bas-URL:** `https://app.sdrpilot.ai/api/v1`
- **Rubrik:** `X-API-Key: YOUR_API_KEY`
- **Maskinläsbar beskrivning:** `https://app.sdrpilot.ai/api/v1/docs/openapi.yaml`
  (finns även som `.json`)

OpenAPI-dokumentet är offentligt och beskriver varje rutt, så de flesta API-verktyg och kodgeneratorer kan importera det direkt utan en nyckel.

`Authorization: Bearer YOUR_API_KEY` fungerar också. Vad du inte kan göra är att skicka en felaktig nyckel och hoppas att den går igenom till något annat: när en nyckel väl har presenterats baseras svaret på den nyckeln.

Vad som returneras när något är fel:

| Svar | Vad det betyder |
|---|---|
| `401` | Nyckeln saknas, är felaktigt formaterad eller accepteras inte. |
| `403` | Nyckeln är giltig, men det kontot har ingen LinkedIn-arbetsyta eller är ännu inte tillåtet. |
| `429` | För många avvisade försök på en minut för den nyckeln. Sakta ner. |
| `502` `dmchamp_unreachable` | Vi kunde inte kontrollera din nyckel just då. Det behandlas aldrig som ett godkännande. Försök igen. |

## Ansluta en AI-assistent

LinkedIn-verktygen finns på samma MCP-slutpunkt som <span data-t="appName">DM Champ</span>:s, med samma API-nyckel, så en assistent du redan har anslutit hittar dem automatiskt. Om du inte har anslutit någon ännu, följ [Anslut AI-assistenter (MCP)](connect-ai-clients.md) och använd slutpunkten som anges där.

::: master-only
Slutpunkten är `https://mcp.youraiconnector.com/mcp`, autentiserad med `X-API-Key`-rubriken, precis som beskrivs i Anslut AI-assistenter (MCP).
:::

LinkedIn-verktygen har prefixet **`linkedin_`**, så de är lätta att identifiera i din assistents verktygslista och lätta att efterfråga vid namn ("använd LinkedIn-verktygen för att visa mig vad som ligger i kö"). Det finns inga behörigheter per verktyg: ett verktyg kan göra vad du än kan göra i appen.

## Exempel 1 — acceptera endast leads från vissa länder

Din ICP-profil innehåller reglerna som leads måste uppfylla. Detta skapar en tillåten lista för Nederländerna och Belgien. Landskoder består av två bokstäver med versaler.

```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"]}}'
```

Två saker att känna till. Brödtexten är den **kompletta** uppsättningen regler, inte en korrigering: en regel som du utelämnar stängs av. Svaret innehåller också ett `impact_on_queue`-block som berättar hur många redan köade anslutningsförfrågningar som inte skulle uppfylla de nya reglerna, till exempel `{"examined": 389, "would_withdraw": 155}`.
Att spara regler drar inte tillbaka någonting i sig självt.

I en assistent skulle du helt enkelt säga: "Ställ in min ICP till att endast acceptera Nederländerna och Belgien, och berätta för mig vad det skulle innebära för min kö."

## Exempel 2 — se vad som ligger i kö

Anslutningsförfrågningar som har godkänts men ännu inte skickats:

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

Varje rad innehåller personens namn, rubrik, företag, plats, land, antal anslutningar och följare, samt poäng. Du kan begränsa listan med `country`, `min_score`, `max_score` och `source`, och bläddra igenom den med `limit` och `cursor`. Endast köade och väntande förfrågningar visas här. Förfrågningar som redan har skickats är historik och kan inte ändras.

## Exempel 3 — dra tillbaka alla utanför dina länder

Efter att ha ändrat dina regler, kontrollera kön mot dem igen. Utan `apply=true` är detta en förhandsgranskning och ändrar ingenting:

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

Du får tillbaka information om hur många som granskades, hur många som skulle dras tillbaka, och en uppdelning per regel, såsom `country` och `network_too_small` (leadets nätverk var mindre än ditt minimum). Nöjd med resultatet? Kör det igen med `?apply=true` så dras dessa förfrågningar tillbaka.

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

Om du hellre vill dra tillbaka en specifik uppsättning, skicka id-numren istället, eller ett filter såsom `{"filter":{"status":"queued","country":"NG"}}` för att rensa allt som matchar. Skicka id-nummer eller ett filter, inte båda.

## Felsökning

- **`401` vid varje anrop** — nyckeln saknas eller är felaktig. Kopiera den igen från Inställningar → Integrationer → API-nyckel.
- **`403` trots att nyckeln fungerar på andra ställen** — det kontot är inte kopplat till en LinkedIn-arbetsyta, eller så är LinkedIn inte aktiverat för det ännu.
- **`502 dmchamp_unreachable`** — ett tillfälligt problem vid kontroll av din nyckel. Ingenting släpptes igenom; försök igen.
- **En regel matchar ingenting** — landskoder måste vara i formatet med två versala bokstäver (`NL`, inte `Netherlands` eller `nl`), och språkkoder måste vara med gemener.
- **Assistenten visar inga LinkedIn-verktyg** — återanslut den så att den laddar om verktygslistan, och kontrollera att du använder samma API-nyckel.

---

## Nästa steg

- [Anslut AI-assistenter (MCP)](connect-ai-clients.md) — konfigurera Claude, ChatGPT eller Cursor med din nyckel.
- [API-åtkomst](api-access.md) — generera eller rotera nyckeln som används här.