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.
POSThttps://mcp.flatflash.com/mcp
Streamable HTTP, ein POST, Bearer-Auth. Kein GET-Stream, keine Sitzungen, keine Wiederaufnahme.
Verbundene Apps öffnenZwei 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-AnleitungPersö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 erstellenEigenschaften 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
listings:read
Durchsucht aktuelle Angebote nach Stadt, Bezirken, Budget, Zimmern, WBS und Ausstattung. Liefert kompakte Treffer mit FlatFlash- und Original-Links.
get_listing
listings:read
Volle Details zu einem Angebot, inklusive Link zur Originalanzeige.
get_saved_searches
alerts:write
Listet deine gespeicherten Suchen.
create_saved_search
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
alerts:write
Aktualisiert Kriterien, Batch-Größe oder maximale Wartezeit. Idempotent.
get_entitlement
alerts:write
Abo-Status, Feature-Verfügbarkeit und der informative Plan-Link.
get_digest
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.
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