LinkedIn Jobs MCP-Server

Selbstgehosteter MCP-Server, der LinkedIn-Stellenanzeigen mit Ihren authentifizierten Session-Cookies scrapt. Läuft in Docker. Kein Apify, keine Kosten pro Ausführung.

Einrichtung

1. Cookies abrufen

1. Installieren Sie die Chrome-Erweiterung Cookie-Editor

2. Melden Sie sich bei LinkedIn an (verwenden Sie ein Zweitkonto)

3. Klicken Sie auf Cookie-Editor → Export (JSON)

4. Suchen und kopieren Sie zwei Werte:

   • li_at — Ihr Session-Cookie

   • JSESSIONID — wird als CSRF-Token verwendet (der Wert sieht aus wie ajax:1234...)

2. Konfiguration

cp .env.example .env
# Edit .env and paste your cookie values

3. Erstellen und testen

# Build the Docker image
docker build -t linkedin-mcp .

# Quick smoke test — should print the MCP server startup log
docker run --rm --env-file .env linkedin-mcp
# Ctrl+C to stop

4. In Claude Desktop einbinden

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "linkedin-jobs": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--env-file", "/ABSOLUTE/PATH/TO/linkedin-mcp/.env",
        "linkedin-mcp"
      ]
    }
  }
}

⚠️ Verwenden Sie den absoluten Pfad zu Ihrer .env-Datei. ~/ wird hier nicht erweitert.

5. Claude Desktop neu starten

Nachdem Sie die Konfiguration gespeichert haben, beenden Sie Claude Desktop vollständig und öffnen Sie es erneut. Sie sehen ein 🔧 Werkzeug-Symbol in der Chat-Leiste — klicken Sie darauf, um zu bestätigen, dass scrape_jobs, get_job_details, check_cookie und update_cookies aufgelistet sind.

6. Erstes Gespräch

You: Check if my LinkedIn cookie is valid
Claude: [calls check_cookie] ✓ Authenticated as John Doe

You: Scrape 20 AI Engineer or ML Engineer jobs posted in the last 3 days in the US
Claude: [calls scrape_jobs] ...returns full job list with descriptions

Cookie-Aktualisierung (alle 30–60 Tage)

Wenn Cookies ablaufen, exportieren Sie diese erneut aus dem Cookie-Editor und sagen Sie Claude:

Update my LinkedIn cookies: li_at is "new_value" and jsessionid is "new_value"

Claude wird update_cookies aufrufen — ein Neustart des Containers ist nicht erforderlich.

Entwicklung

# Run with live source reloading
docker compose up

# Inspect MCP tools without Claude Desktop
npx @modelcontextprotocol/inspector docker run --rm -i --env-file .env linkedin-mcp

Projektstruktur

linkedin-mcp/
├── src/
│   ├── server.py        # MCP server — tool definitions and handlers
│   ├── scraper.py       # LinkedIn Voyager API calls (httpx)
│   ├── models.py        # Pydantic models for Job data
│   └── __init__.py
├── Dockerfile
├── docker-compose.yml
├── requirements.txt
├── .env.example
└── .gitignore