MCP-Server für KI-Assistenten

Endpunkt

URL	`https://nego.deals/mcp`
Transport	Streamable HTTP, zustandslos — `POST` mit JSON-RPC; `GET` antwortet 405.
Auth	`Authorization: Bearer nego_…` (optional — ohne Header: nur Lesen)
Discovery	`GET https://nego.deals/mcp/info` liefert Name, Transport, URL und die Werkzeugliste als JSON.

Token bekommen

In der nego-App: Profil → KI-Assistent verbinden.
Token benennen (z. B. „Claude auf dem Laptop“) und erzeugen. Der Token (nego_ + 48 Hex-Zeichen) wird einmal angezeigt — kopieren.
In die Konfiguration deines Assistenten eintragen (siehe unten).

Bis zu zehn Token pro Konto. In der App siehst du für jeden Token die letzte Nutzung und kannst ihn widerrufen. Bei uns liegt nur ein Hash; ein verlorener Token lässt sich nicht wiederherstellen, nur ersetzen.

Die sieben Werkzeuge

search_listingsauch ohne Token

Durchsucht aktive Anzeigen: Suchwort, Kategorie, Höchstpreis (Cent), Zustand, Limit (≤ 25).

Beispiel: „Such auf nego nach einem Rennrad in Rahmenhöhe 56 unter 900 €.“

get_listingauch ohne Token

Alle Details einer Anzeige: Beschreibung, Attribute, Bild-URLs, Status und ob Angebote möglich sind.

Beispiel: „Zeig mir die Details der Anzeige mit der ID abc123 und sag mir, ob ich verhandeln kann.“

make_offerToken nötig

Gibt ein Angebot in Cent ab. Der volle Preis wird sofort angenommen und reserviert den Artikel.

Beispiel: „Biete 780 € auf das Rennrad und schreib dazu, dass ich am Samstag abholen kann.“

my_offersToken nötig

Laufende Verhandlungen als Käufer (buying) oder Verkäufer (selling), mit Status und wessen Zug es ist.

Beispiel: „Wo bin ich gerade am Zug? Fass meine offenen Verhandlungen zusammen.“

respond_to_offerToken nötig

Ein offenes Angebot annehmen, ablehnen oder mit einem Gegenangebot (Cent) beantworten — nur, wenn es dein Zug ist.

Beispiel: „Kontere das Angebot auf meine PlayStation mit 320 €.“

message_sellerToken nötig

Schickt dem Verkäufer einer Anzeige eine Chat-Nachricht, z. B. den Abholtermin.

Beispiel: „Frag den Verkäufer, ob das Rad noch da ist und ob Sonntag 11 Uhr passt.“

my_listingsToken nötig

Deine eigenen Anzeigen mit Status und Anzahl offener Angebote.

Beispiel: „Welche meiner Anzeigen haben offene Angebote?“

Alle Werkzeuge antworten mit JSON im Textfeld. Beträge sind Cent (amountCents); menschenlesbare Preise stehen daneben (price). Anzeigen mit example: true stammen vom nego-Team und sind nicht kaufbar.

Konfiguration

Claude Desktop

Einstellungen → Entwickler → Konfiguration bearbeiten (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "nego": {
      "url": "https://nego.deals/mcp",
      "headers": {
        "Authorization": "Bearer nego_…"
      }
    }
  }
}

Claude Code

Terminal

claude mcp add --transport http nego https://nego.deals/mcp \
  --header "Authorization: Bearer nego_…"

Cursor

.cursor/mcp.json im Projekt oder global — gleiche Form:

.cursor/mcp.json

{
  "mcpServers": {
    "nego": {
      "url": "https://nego.deals/mcp",
      "headers": {
        "Authorization": "Bearer nego_…"
      }
    }
  }
}

ChatGPT und andere Clients

Überall, wo ein Client einen Remote-MCP-Server annimmt (bei ChatGPT: Einstellungen → Connectors → Erweitert → Entwicklermodus), genügen zwei Angaben: die Server-URL https://nego.deals/mcp und der Header Authorization: Bearer nego_…. Ohne Header verbindet sich der Client im Nur-Lesen-Modus.

Zum Ausprobieren

Terminal

curl -s https://nego.deals/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Ratenbegrenzung

Mit Token: 240 Anfragen pro Minute und Token.
Ohne Token: 60 Anfragen pro Minute und IP-Adresse.
Darüber antwortet der Server mit 429 rate_limited. Ein ungültiger Token ergibt 401 invalid_token.

Anonyme Verbindungen

Ohne Authorization-Header liefern nur search_listings und get_listing Ergebnisse. Alle anderen Werkzeuge antworten mit auth_required und dem Hinweis, wo der Token entsteht. So kann ein Assistent stöbern, bevor sein Mensch ein Konto verbindet — aber nie handeln, ohne dass jemand dafür einsteht.

Was Assistenten wissen sollten

make_offer mit dem vollen Preis wird sofort angenommen und reserviert den Artikel — vorher rückfragen.
Jedes Angebot eines Assistenten ist im Verhandlungsverlauf als solches gekennzeichnet (by: "agent"). Der Verkäufer sieht das.
Angebote gelten 48 Stunden. Der volle Ablauf steht in den AGB, Ziffer 5.
nego wickelt keine Zahlungen ab. Bezahlt wird bei der Übergabe; der Käufer bekommt dafür einen sechsstelligen Code.
Nachrichten und Anzeigen werden auf verbotene Inhalte geprüft; abgelehnte Inhalte kommen als content_rejected zurück.

Fragen oder ein Client, der nicht will? Schreib uns.