MCP-ENDPUNKT

FlatFlash über MCP

Ein Endpunkt für jeden MCP-Client: Angebote durchsuchen, deine gespeicherte Suche lesen und einen Best-Effort-Digest abrufen. Das ChatGPT-Plugin ist der Consumer-Weg; diese Seite ist für deinen eigenen Client.

Endpunkt

POSThttps://mcp.flatflash.com/mcp

Streamable HTTP, ein POST, Bearer-Auth. Kein GET-Stream, keine Sitzungen, keine Wiederaufnahme.

Verbundene Apps öffnen

Zwei Zugangsdaten, ein Konto

Beide Türen führen zum selben Abonnenten, zur selben gespeicherten Suche und zur selben Digest-Historie. Nimm die Variante, die dein Client unterstützt.

OAuth 2.1 für das ChatGPT-Plugin

Das veröffentlichte Plugin verbindet sich über den FlatFlash-Autorisierungsserver mit OAuth 2.1 und PKCE. Installation und Einwilligung sind zwei manuelle Schritte in ChatGPT; ein Prompt kann beides nicht.

Zur Plugin-Anleitung

Persönliches Zugriffstoken für einen generischen MCP-Client

Erstelle ein Token in „Verbundene Apps“ und sende es als Bearer-Token. Der Klartext wird einmal angezeigt; FlatFlash speichert nur seinen Hash.

Token erstellen

Eigenschaften persönlicher Zugriffstoken

  • Läuft 90 Tage nach Erstellung ab; die Laufzeit setzt der Server.
  • Wird als SHA-256-Hash gespeichert. Der Klartext erscheint einmal und ist später nicht abrufbar.
  • Jederzeit pro Token widerrufbar.
  • Jeder erfolgreiche Aufruf schreibt last_used_at, sodass „Verbundene Apps“ die letzte Nutzung zeigt.

Was ein PAT kann und was nicht

Angebote lesen, deine gespeicherte Suche lesen sowie erstellen oder aktualisieren, deinen Anspruch lesen und einen Digest abrufen.

Kein Löschen oder Pausieren einer gespeicherten Suche, keine Kündigung, keine Abrechnungsänderung und kein Zugriff auf ein anderes Konto.

Für alles darüber gibt es kein Tool: Der Endpunkt bietet keine solche Operation an.

Tools

Sieben Tools, zwei Berechtigungen. Kein Tool nimmt eine Nutzer-ID entgegen: Die Identität kommt aus dem Bearer-Token.

search_listings
lesen listings:read

Durchsucht aktuelle Angebote nach Stadt, Bezirken, Budget, Zimmern, WBS und Ausstattung. Liefert kompakte Treffer mit FlatFlash- und Original-Links.

get_listing
lesen listings:read

Volle Details zu einem Angebot, inklusive Link zur Originalanzeige.

get_saved_searches
lesen alerts:write

Listet deine gespeicherten Suchen.

create_saved_search
schreiben alerts:write

Legt deine gespeicherte Suche an; startet die 10-Tage-Testphase, wenn sie noch verfügbar ist. Idempotent: ein erneuter Aufruf liefert die bestehende Suche.

update_saved_search
schreiben alerts:write

Aktualisiert Kriterien, Batch-Größe oder maximale Wartezeit. Idempotent.

get_entitlement
lesen alerts:write

Abo-Status, Feature-Verfügbarkeit und der informative Plan-Link.

get_digest
lesen alerts:write

Neue Treffer seit dem letzten Digest, begrenzt; der Cursor rückt nur nach einem erfolgreichen Aufruf vor.

Berechtigungen

Eine Berechtigung wird bei jeder Anfrage geprüft; fehlt sie dem Zugangsdatum, wird die Anfrage abgelehnt und kein Tool läuft.

listings:read

Angebote durchsuchen und ein Angebot lesen. Diese Tools brauchen keinen Abo-Anspruch.

alerts:write

Gespeicherte Suchen, Anspruch und Digest lesen und schreiben.

Öffentliche Tools brauchen keinen Abo-Anspruch, aber sehr wohl ein Token: Jeder POST /mcp trägt ein Bearer-Token.

Aufruf im Terminal

Exportiere den Endpunkt und dein PAT und sende einen JSON-RPC-POST. Der Platzhalter steht für dein eigenes Token; füge ein Token nie in einen Prompt, ein Tool-Argument oder eine URL ein.

export FLATFLASH_MCP_ENDPOINT="https://mcp.flatflash.com/mcp"
export FLATFLASH_PAT="<your-personal-access-token>"

curl -sS "$FLATFLASH_MCP_ENDPOINT" \
  -H "Authorization: Bearer $FLATFLASH_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search_listings",
      "arguments": {"city": "berlin", "max_budget_eur": 1200, "min_rooms": 2}
    }
  }'

Die Antwort ist ein JSON-RPC-Ergebnis mit einem Textblock für das Modell und structuredContent für deinen Client.

Erstellen und widerrufen

„Verbundene Apps“ listet jede MCP-Freigabe und jedes Token mit Berechtigungen und letzter Nutzung.

Der Widerruf eines Tokens oder einer OAuth-Verbindung beendet den Zugriff bei der nächsten Anfrage: Der Endpunkt antwortet mit 401 und kein Tool läuft. Deine Web-Sitzung und deine gespeicherte Suche bleiben.

Verbundene Apps öffnen

Das Plugin in ChatGPT zu deinstallieren oder zu trennen widerruft die OAuth-Freigabe auf demselben Weg.

Sicherheitshinweise

Publikumsgebundene Token: Ein Zugriffstoken gilt nur für diese MCP-Ressource, nie als allgemeines FlatFlash-Zugangsdatum.

Nur im Bearer-Header: Token in einem Prompt, einem Tool-Argument, einem Query-String oder einem Log werden nicht akzeptiert.

Kein Passthrough: FlatFlash leitet dein Token nie an einen anderen Dienst weiter.

Nur öffentliche Anzeigendaten: Tool-Ausgaben enthalten keine Vermieterkontakte, internen IDs oder Sitzungskennungen.

Best Effort, nur auf Abruf

Dein Client entscheidet, wann der Digest läuft. FlatFlash plant den Aufruf nicht und pusht nicht in deinen Client; Telegram und die Web-App bleiben die zuverlässigen Alert-Kanäle.

Behalte die zuverlässigen Alerts

Der MCP-Digest ist Best-Effort und hängt von deinem Client ab. Telegram und die Web-App liefern Alerts unabhängig von jedem KI-Client.

ChatGPT-Plugin-Anleitung lesen
Loslegen