# LinkedIn-API und KI-Assistenten (MCP)

Alles, was Sie auf den LinkedIn-Seiten tun können, lässt sich auch über ein Skript oder einen KI-Assistenten erledigen: Ihre Leads, die Warteschlange für Kontaktanfragen, Ihre ICP-Regeln (einschließlich der akzeptierten Länder und der erforderlichen Größe des Netzwerks eines Leads), Ihr Posteingang, Ihre KI-Agenten und Ihre Einstellungen.

Es muss nichts Neues eingerichtet werden. Es wird der **gleiche API-Schlüssel wie für den Rest von <span data-t="appName">DM Champ</span>** verwendet. Wenn Sie unsere API also bereits aufrufen oder einen KI-Assistenten verbunden haben, sind Sie startklar.

## Wo Sie Ihren Schlüssel finden

Einstellungen → Integrationen → API-Schlüssel. Falls Sie noch keinen haben, klicken Sie auf **API-Schlüssel generieren**. Die vollständigen Schritte finden Sie unter [API-Zugriff](api-access.md).

Es gibt keinen separaten LinkedIn-Schlüssel, der erstellt, rotiert oder widerrufen werden muss. Der Schlüssel agiert als Sie selbst mit denselben Berechtigungen, die Sie in der App haben. Behandeln Sie ihn daher wie ein Passwort. Ein Widerruf in den Einstellungen trennt sofort alle verbundenen Skripte und Assistenten.

## Direkter Aufruf der API

- **Basis-URL:** `https://app.sdrpilot.ai/api/v1`
- **Header:** `X-API-Key: YOUR_API_KEY`
- **Maschinenlesbare Beschreibung:** `https://app.sdrpilot.ai/api/v1/docs/openapi.yaml`
  (auch verfügbar als `.json`)

Das OpenAPI-Dokument ist öffentlich und beschreibt jede Route, sodass die meisten API-Tools und Codegeneratoren es direkt ohne Schlüssel importieren können.

`Authorization: Bearer YOUR_API_KEY` funktioniert ebenfalls. Was Sie nicht tun können, ist einen falschen Schlüssel zu senden und darauf zu hoffen, dass er auf etwas anderes zurückgreift: Sobald ein Schlüssel präsentiert wird, basiert die Antwort auf diesem Schlüssel.

Was passiert, wenn etwas schiefgeht:

| Antwort | Bedeutung |
|---|---|
| `401` | Der Schlüssel fehlt, ist fehlerhaft oder wird nicht akzeptiert. |
| `403` | Der Schlüssel ist gültig, aber das Konto hat keinen LinkedIn-Arbeitsbereich oder ist noch nicht zugelassen. |
| `429` | Zu viele abgelehnte Versuche innerhalb einer Minute für diesen Schlüssel. Bitte langsamer vorgehen. |
| `502` `dmchamp_unreachable` | Ihr Schlüssel konnte in diesem Moment nicht überprüft werden. Dies wird niemals als Erfolg gewertet. Bitte versuchen Sie es erneut. |

## Verbinden eines KI-Assistenten

Die LinkedIn-Tools befinden sich auf demselben MCP-Endpunkt wie die von <span data-t="appName">DM Champ</span> und verwenden denselben API-Schlüssel. Ein Assistent, den Sie bereits verbunden haben, erkennt sie daher automatisch. Falls Sie noch keinen verbunden haben, folgen Sie der Anleitung [KI-Assistenten verbinden (MCP)](connect-ai-clients.md) und verwenden Sie den dort aufgeführten Endpunkt.

::: master-only
Der Endpunkt lautet `https://mcp.youraiconnector.com/mcp` und wird mit dem Header `X-API-Key` authentifiziert, genau wie unter „KI-Assistenten verbinden (MCP)“ beschrieben.
:::

Die LinkedIn-Tools haben alle das Präfix **`linkedin_`**, sodass sie in der Tool-Liste Ihres Assistenten leicht zu erkennen sind und einfach namentlich angefordert werden können („Verwende die LinkedIn-Tools, um mir zu zeigen, was in der Warteschlange steht“). Es gibt keine Berechtigungen pro Tool: Ein Tool kann alles tun, was Sie auch in der App tun können.

## Beispiel 1 — Leads nur aus bestimmten Ländern akzeptieren

Ihr ICP-Profil enthält die Regeln, die Leads erfüllen müssen. Dies legt eine Positivliste für die Niederlande und Belgien fest. Ländercodes sind zweistellig und in Großbuchstaben.

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

Zwei Dinge, die Sie wissen sollten: Der Body ist der **vollständige** Regelsatz, kein Patch: Eine Regel, die Sie weglassen, wird deaktiviert. Die Antwort enthält einen `impact_on_queue`-Block, der Ihnen mitteilt, wie viele bereits in der Warteschlange befindliche Verbindungsanfragen die neuen Regeln nicht erfüllen würden, zum Beispiel `{"examined": 389, "would_withdraw": 155}`.
Das Speichern von Regeln zieht von sich aus nichts zurück.

In einem Assistenten würden Sie einfach sagen: „Setze mein ICP so, dass nur die Niederlande und Belgien akzeptiert werden, und sag mir, wie sich das auf meine Warteschlange auswirken würde.“

## Beispiel 2 — sehen, was in der Warteschlange steht

Verbindungsanfragen, die genehmigt, aber noch nicht gesendet wurden:

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

Jede Zeile enthält den Namen der Person, die Schlagzeile, das Unternehmen, den Standort, das Land, die Anzahl der Verbindungen und Follower sowie den Score. Sie können die Liste mit `country`, `min_score`, `max_score` und `source` eingrenzen und mit `limit` und `cursor` durchblättern. Hier erscheinen nur Anfragen, die in der Warteschlange stehen oder auf Genehmigung warten. Bereits gesendete Anfragen sind Historie und können nicht mehr geändert werden.

## Beispiel 3 — alle Personen außerhalb Ihrer Länder zurückziehen

Überprüfen Sie nach dem Ändern Ihrer Regeln die Warteschlange erneut anhand dieser Regeln. Ohne `apply=true` ist dies eine Vorschau und ändert nichts:

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

Sie erhalten eine Rückmeldung darüber, wie viele geprüft wurden, wie viele zurückgezogen würden, sowie eine Aufschlüsselung pro Regel, wie z. B. `country` und `network_too_small` (das Netzwerk des Leads war kleiner als Ihr Minimum). Zufrieden damit? Führen Sie es erneut mit `?apply=true` aus, und diese Anfragen werden zurückgezogen.

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

Wenn Sie lieber eine bestimmte Gruppe zurückziehen möchten, posten Sie stattdessen die IDs oder einen Filter wie `{"filter":{"status":"queued","country":"NG"}}`, um alles zu entfernen, was übereinstimmt. Senden Sie entweder IDs oder einen Filter, nicht beides.

## Fehlerbehebung

- **`401` bei jedem Aufruf** — der Schlüssel fehlt oder ist falsch. Kopieren Sie ihn erneut unter Einstellungen → Integrationen → API-Schlüssel.
- **`403`, obwohl der Schlüssel anderswo funktioniert** — dieses Konto ist nicht mit einem LinkedIn-Arbeitsbereich verknüpft oder LinkedIn ist dafür noch nicht aktiviert.
- **`502 dmchamp_unreachable`** — ein vorübergehendes Problem bei der Überprüfung Ihres Schlüssels. Es wurde nichts durchgelassen; versuchen Sie es erneut.
- **Eine Regel stimmt mit nichts überein** — Ländercodes müssen die zweistellige Großbuchstabenform haben (`NL`, nicht `Netherlands` oder `nl`), und Sprachcodes müssen kleingeschrieben sein.
- **Der Assistent zeigt keine LinkedIn-Tools an** — verbinden Sie ihn erneut, damit die Tool-Liste neu geladen wird, und stellen Sie sicher, dass Sie denselben API-Schlüssel verwenden.

---

## Nächste Schritte

- [KI-Assistenten verbinden (MCP)](connect-ai-clients.md) — richten Sie Claude, ChatGPT oder Cursor mit Ihrem Schlüssel ein.
- [API-Zugriff](api-access.md) — generieren oder rotieren Sie den Schlüssel, der hierfür verwendet wird.