linkedin-mcp

MCP-Server zum Bearbeiten deines eigenen LinkedIn-Profils aus Claude Code – mit einer strikten Propose-then-approve-Trennung: Das Modell kann eine Änderung entwerfen und dir den Diff zeigen, aber nur ein einziges Tool kann je schreiben, und das auch nur auf Grundlage eines Vorschlags, den du gesehen hast.

Partner-Gating: Die Profile-Edit-API von LinkedIn ist nur auf LinkedIn-freigegebene Partner-Entwickler beschränkt (w_compliance ist „eine private Berechtigung, und der Zugriff wird ausgewählten Entwicklern gewährt“ – siehe docs/api-notes.md). Bis die Partner-Freigabe vorliegt, gibt apply_proposal einen Fehler mit ungültigem Scope zurück. Das ist erwartet, kein Defekt. Alles andere (OAuth, Vorschläge, Diffs) funktioniert bereits.

Funktionsweise

Vorschläge werden unter ~/.config/linkedin-mcp/proposals/ gespeichert, damit eine Freigabe in einer späteren Sitzung erfolgen kann. Tokens und Client-Zugangsdaten liegen in ~/.config/linkedin-mcp/.env mit den Berechtigungen 600 – von dir eingetragen, niemals von einem Agenten, niemals committet (siehe .env.example).

Related MCP server: kaushik-linkedin-mcp

Installation

Benötigt Python ≥ 3.11.

{
  "mcpServers": {
    "linkedin": {
      "command": "bash",
      "args": ["/path/to/linkedin-mcp/run.sh"]
    }
  }
}

run.sh erzeugt beim ersten Start .venv/ und installiert die festgepinnten Abhängigkeiten (per Stempeldatei gesteuert; alle Bootstrap-Ausgaben gehen auf stderr, sodass der MCP-stdio-Kanal sauber bleibt).

Einrichtung

Folge der Anleitung in docs/SETUP-KYLE.md – sie führt dich durch das Erstellen der LinkedIn-Developer-App, das Registrieren der Redirect-URL, das Ausfüllen von ~/.config/linkedin-mcp/.env, das Ausführen von auth_start und die Bewerbung für das Partnerprogramm.

Entwicklung

bash run.sh --help                                # bootstraps the venv (runtime deps only)
.venv/bin/pip install -r requirements-dev.txt     # adds pytest + coverage tooling
.venv/bin/python -m pytest                        # offline — every test runs against a mock transport

Die Testsuite umfasst ein Fixture mit gewährtem Schreibzugriff: einen simulierten LinkedIn-Dienst, bei dem jeder dokumentierte Schreib-Endpunkt bereitgestellt 200 zurückgibt. Die Tests stellen sicher, dass propose_edit keine Nicht-GET-Anfragen im protokollierten Log hinterlässt, selbst wenn Schreibvorgänge erfolgreich wären, und als Positivkontrolle, dass apply_proposal im selben Fixture den dokumentierten Schreibaufruf aufzeichnet. --live-probe ist ein Diagnose-Flag (eine einzelne echte Anfrage), das „Endpunkt korrekt, aber Scope nicht gewährt“ von „Endpunkt falsch“ unterscheidet; es läuft niemals in Tests oder CI und erfordert LINKEDIN_MCP_LIVE_PROBE=1.

Die API-Schnittstelle ist auf datierte, wörtliche Auszüge aus der offiziellen Dokumentation in docs/api-notes.md fixiert.

Lizenz

MIT – siehe LICENSE.