Kleinanzeigen MCP Server: Live-Daten als Tools für KI-Clients

MCP klingt erst einmal abstrakt. Model Context Protocol ist aber im Kern eine einfache Idee: Ein KI-Client bekommt Werkzeuge, die er kontrolliert aufrufen kann.

Für Kleinanzeigen-Daten ist das nützlich, weil viele Fragen nicht mit einer einzelnen Suche erledigt sind. Ein guter Recherche-Workflow sucht zuerst passende Inserate, lädt danach Details nach, prüft Verkäufer-Kontext, schärft Standort- oder Kategorie-Filter nach und baut am Ende eine Shortlist.

Ohne MCP müsstest du diesen Ablauf selbst bauen. Mit MCP kann ein kompatibler KI-Client die passenden Kleinanzeigen-Werkzeuge direkt verwenden.

Die Grundidee

Der Kleinanzeigen MCP Server ist eine zusätzliche Verbindung zu den bestehenden Live-Daten.

Die API ist gut für feste Abläufe in deiner eigenen Software. MCP ist gut, wenn ein KI-Client während einer Aufgabe selbst entscheiden soll, welche Kleinanzeigen-Daten er als Nächstes braucht. Er bekommt keine unübersichtliche Datenmenge, sondern klar benannte Werkzeuge wie Suche, Inseratdetails oder Verkäuferprofil.

Bei uns bedeutet das:

Der Client verbindet sich mit https://api.kleinanzeigen-agent.de/mcp.
Du meldest dich im Browser an oder nutzt bei älteren Setups deinen API-Key.
Er entdeckt Tools wie search_kleinanzeigen oder get_kleinanzeigen_ad.
Er nutzt diese Werkzeuge, wenn deine Aufgabe es braucht.
Die Werkzeuge verwenden dieselben Live-Daten, Credits und Antwortformate wie die API.

Der Server gibt dem Modell keinen freien Datenbankzugriff. Er stellt nur definierte Kleinanzeigen-Werkzeuge bereit.

Was der MCP Server kann

Der Server deckt die wichtigsten Live-Funktionen der API ab:

Tool	Zweck
`search_kleinanzeigen`	Live-Inserate suchen
`get_kleinanzeigen_ad`	Inseratdetails laden
`get_kleinanzeigen_ad_status`	Prüfen, ob ein Inserat noch aktiv ist
`get_kleinanzeigen_seller_profile`	Öffentliches Verkäuferprofil laden
`get_kleinanzeigen_seller_ads`	Weitere Inserate eines Verkäufers laden
`list_kleinanzeigen_categories`	Kategoriebaum laden
`get_kleinanzeigen_category_metadata`	Felder einer Kategorie ansehen
`get_kleinanzeigen_category_search_metadata`	Suchfilter einer Kategorie laden
`search_kleinanzeigen_locations`	Standorte suchen
`get_kleinanzeigen_location`	Standortdetails laden

Das ist bewusst keine zweite Datenwelt. Die Werkzeuge greifen auf dieselben Live-Funktionen zu wie die API. Dadurch bleiben Filter, Felder, Credits und Rückerstattungen konsistent.

Was im Hintergrund passiert

Bei einer Anfrage passiert ungefähr das:

Dein MCP-Client fragt den Server nach den verfügbaren Werkzeugen.
Du stellst eine Aufgabe, zum Beispiel eine Suche mit Preislimit und Standort.
Der Client wählt das passende Werkzeug aus.
Kleinanzeigen Agent prüft Login, Plan und Guthaben.
Die Live-Abfrage wird ausgeführt und mit Credits abgerechnet.
Das Ergebnis kommt zurück und kann vom Client zusammengefasst oder weiterverarbeitet werden.

Wichtig: Ungültige Angaben kosten keine Credits. Wenn eine Live-Abfrage bei Kleinanzeigen fehlschlägt, wird der Credit wie bei der API zurückerstattet.

Beispiel aus der Praxis

Angenommen, du suchst ein bestimmtes iPhone-Modell im Umkreis von Berlin. Du willst nicht nur die billigsten Treffer sehen, sondern eine kleine Einschätzung:

Welche Angebote wirken realistisch?
Welche Inserate bieten Versand?
Welche Verkäufer haben weitere ähnliche Artikel?
Welche Treffer sind privat oder gewerblich?
Welche Preise sind auffällig niedrig?

Mit der API würdest du diesen Ablauf selbst bauen: Suche ausführen, Treffer sortieren, Details abrufen, Verkäufer prüfen, Ergebnis formatieren.

Mit MCP kannst du dem Client eine Aufgabe geben:

Suche private iPhone 15 Angebote im Umkreis von 25 km um Berlin.
Lade Details für die 5 günstigsten Treffer nach und gib mir eine Tabelle mit Preis, Standort, Versand, Verkäufer und URL.

Ein guter MCP-Client kann daraus mehrere Schritte machen und die Ergebnisse danach verständlich zusammenfassen.

Authentifizierung

Empfohlen ist der Login im Browser: Dein MCP-Client öffnet einmal Kleinanzeigen Agent, du meldest dich an und erlaubst den Zugriff. Danach merkt sich der Client die Verbindung.

Für ältere Setups funktioniert weiterhin derselbe API-Key wie bei der normalen Kleinanzeigen Agent API. Verwende dafür:

Authorization: Bearer klaz_live_...

Aus Kompatibilitätsgründen funktioniert auch der bestehende Header:

klaz_key: klaz_live_...

Die Server-URL ist:

https://api.kleinanzeigen-agent.de/mcp

Ein API-Key gehört nur in die Secret-Verwaltung deines MCP-Clients, nicht in einen Prompt und nicht in eine URL. Wenn ein Key versehentlich geteilt wurde, rotierst du ihn im Dashboard.

Beispiel für ältere Clients mit API-Key

Viele MCP-Clients unterstützen den Login im Browser direkt. Wenn dein Client noch mit API-Key eingerichtet werden muss, sieht die Konfiguration sinngemäß so aus:

{
  "mcpServers": {
    "kleinanzeigen-agent": {
      "url": "https://api.kleinanzeigen-agent.de/mcp",
      "headers": {
        "Authorization": "Bearer klaz_live_..."
      }
    }
  }
}

Danach kann der Client die Werkzeuge selbst entdecken. Welche Oberfläche genau du dafür nutzt, hängt vom MCP-Client ab. Wichtig sind die Server-URL und, bei älteren Clients, dein API-Key.

Credits und Pläne

MCP-Anfragen kosten dieselben Credits wie die passenden API-Anfragen.

Aktion	Kosten
Suche	1 Credit
Inseratdetails	1 Credit
Inseratstatus	1 Credit
Verkäuferprofil	1 Credit
Verkäufer-Inserate	2 Credits
Views mit `include_views=true`	+1 Credit
Kategorien, Metadaten, Standorte	je 1 Credit

Ungültige Angaben verbrauchen keine Credits. Wenn eine Live-Abfrage bei Kleinanzeigen fehlschlägt, wird der Credit wie bei der API automatisch zurückerstattet.

Die Limits hängen weiter an deinem Plan. Der MCP Server umgeht also nichts; er ist nur eine andere Oberfläche für dieselbe Plattform.

MCP, REST API oder Webhook?

Alle drei Varianten haben ihren Platz:

Schnittstelle	Am besten für
API	Eigene Software, feste Jobs und eigene Oberflächen
MCP Server	KI-Clients, Recherche-Assistenten und interaktive Analyse
Webhooks	Dauerhaftes Monitoring gespeicherter Suchfilter und automatische Benachrichtigungen

Wenn du genau weißt, welche Anfragen dein System ausführen soll, nimm die API. Wenn ein KI-Client während der Aufgabe entscheiden soll, welche Daten er als Nächstes braucht, nimm MCP. Wenn du neue Inserate automatisch überwachen willst, nimm Webhooks.

Was dein MCP-Client können muss

Für die Verbindung brauchst du einen MCP-Client, der Online-MCP-Server verbinden kann. Am einfachsten ist ein Client mit Login im Browser. Wenn dein Client das noch nicht kann, muss er einen API-Key mitsenden können:

Authorization: Bearer klaz_live_...

Wenn dein Client weder Login noch API-Key für MCP Server erlaubt, kannst du den Server dort aktuell nicht direkt verbinden. Nutze dann die API oder einen MCP-Client, der eine der beiden Anmeldearten unterstützt.

Wo MCP besonders stark ist

MCP lohnt sich vor allem dort, wo Recherche mehrstufig ist:

Deal-Recherche: Der Client sucht Angebote, lädt Details nach, prüft Verkäufer-Kontext und fasst die besten Treffer zusammen.

Marktanalyse: Der Client sammelt Suchergebnisse für mehrere Kategorien oder Standorte und erstellt daraus Preisbereiche oder Auffälligkeiten.

Support und Teamarbeit: Du kannst mit einem internen KI-Client schneller nachvollziehen, welche Live-Daten ein Nutzer für eine bestimmte Suche sehen würde.

Automationen: Ein Agent kann abhängig vom Zwischenergebnis entscheiden, ob er weitere Details, Kategorien oder Standorte braucht.

Grenzen und Sicherheit

Der MCP Server speichert keine Inserate und ersetzt keinen Webhook. Wenn du dauerhaft neue Inserate überwachen willst, ist der Kleinanzeigen Webhook der bessere Weg. MCP ist ideal für interaktive Recherche und Analyse.

Beim Login im Browser muss dein API-Key nicht kopiert werden. Wenn du die API-Key-Variante nutzt, bleibt dein Key in deinem MCP-Client. Schreibe den Key nicht in Prompts, Chatnachrichten oder öffentliche Config-Dateien.

Außerdem gilt: KI kann Fehler machen. Für produktive Entscheidungen solltest du wichtige Ergebnisse immer mit IDs, Preisen, URLs und Zeitpunkten ausgeben lassen und bei Bedarf selbst prüfen.

Jetzt ausprobieren

Die vollständige Tool-Liste, Setup-Hinweise und häufige Fehler findest du in der MCP Dokumentation. Deinen API-Key verwaltest du im Dashboard; Account, Plan und Guthaben liegen wie gewohnt unter /app/abrechnung.

Wenn du einen interessanten MCP-Workflow mit Kleinanzeigen-Daten baust, melde dich gern unter [email protected].