Entwickler

Mit SanDeals entwickeln

Verbinden Sie Ihren KI-Agenten oder Ihre App mit dem Angebotskatalog von SanDeals. Diese Seite beschreibt die Einrichtung über MCP, die REST-API und ChatGPT Actions, gefolgt von der vollständigen Referenz.

claude mcp add --transport http sandeals https://www.sandeals.net/mcp

Server-URL

https://www.sandeals.net/mcp

Streamable HTTP
Auth: None
Schreibgeschützt

Funktioniert mitClaude Code ChatGPT Cursor

Integrationen

Integrationsweg wählen

Wählen Sie die Schnittstelle, die zu Ihrem Client passt. Alle drei lesen denselben Katalog.

MCP

Für KI-Assistenten und Agenten. Einmal verbinden, dann ruft Ihr Modell search_deals und list_deals als Tools auf.

Schnellstart
Referenz
MCP-Server

REST API

Für Apps, Skripte und Backends. Senden Sie eine HTTP-Anfrage und erhalten Sie strukturiertes JSON.

ChatGPT Actions

Für benutzerdefinierte GPTs. Importieren Sie die OpenAPI-Spezifikation und rufen Sie die Operation searchDeals auf.

Erste Schritte

Schnellstart

Dieser Schnellstart verbindet SanDeals mit Claude Code und führt Ihre erste Suche aus. Die Schritte für ChatGPT, Cursor und andere Clients folgen danach.

Voraussetzungen

Ein MCP-Client wie Claude Code, ChatGPT oder Cursor
Oder ein beliebiger HTTP-Client wie curl für die REST-API
Kein Konto und kein API-Schlüssel: Der Server ist öffentlich und schreibgeschützt

Claude Code

Server hinzufügen
Führen Sie diesen Befehl in Ihrem Terminal aus. Er registriert SanDeals als Streamable-HTTP-Server mit dem Namen sandeals.
Terminal
```
claude mcp add --transport http sandeals https://www.sandeals.net/mcp
```
Verbindung prüfen
Listen Sie Ihre Server auf. Bei einer funktionierenden Verbindung steht ✓ Connected neben sandeals. Wenn Sie Failed to connect sehen, prüfen Sie Ihre Netzwerkverbindung und führen Sie den Befehl zum Hinzufügen erneut aus. In einer Claude-Sitzung zeigt /mcp denselben Status.
Terminal
```
claude mcp list
```
Ausgabe
```
Checking MCP server health...

sandeals: https://www.sandeals.net/mcp (HTTP) - ✓ Connected
```

Angebote suchen

Fragen Sie in natürlicher Sprache. Claude ruft search_deals auf und antwortet mit Titeln und Links aus dem Katalog.

Claude Code

Suche mit SanDeals nach Kaffee-Angeboten und gib Titel und Link jedes Angebots zurück.

Ausgabe

Hier sind Kaffee-Angebote von SanDeals:

1. Gemahlener Kaffee 500 g — https://slink.sandeals.net/AbC123
2. Instantkaffee 3-in-1, 20 Beutel — https://slink.sandeals.net/XyZ789

Prüfen Sie die Bedingungen auf der Website des Shops, bevor Sie kaufen.

Um den Server mit Ihrem Team zu teilen, fügen Sie --scope project hinzu. Claude Code speichert ihn in der .mcp.json Ihres Repositorys.

claude mcp add --scope project --transport http sandeals https://www.sandeals.net/mcp

ChatGPT

Fügen Sie in ChatGPT Connectors einen custom MCP server hinzu.
Fügen Sie die Server-URL ein und wählen Sie No authentication.
Server-URL
```
https://www.sandeals.net/mcp
```
Installieren Sie ihn. Geben Sie in einem neuen Chat @ ein und wählen Sie SanDeals.

Die Verfügbarkeit hängt von den Berechtigungen Ihres Workspace ab. ChatGPT Actions weiter unten ist eine separate REST-Integration.

Cursor und andere Clients

Jeder Client, der Remote-MCP über Streamable HTTP unterstützt, verbindet sich über die Server-URL. In Cursor fügen Sie sie zu mcp.json hinzu:

~/.cursor/mcp.json

{
  "mcpServers": {
    "sandeals": {
      "url": "https://www.sandeals.net/mcp"
    }
  }
}

ChatGPT Actions

Erstellen Sie in ChatGPT einen benutzerdefinierten GPT, öffnen Sie Actions und wählen Sie Import from URL. Fügen Sie die URL unten ein und setzen Sie Authentication auf None. Der GPT ruft dann die Operation searchDeals auf.

OpenAPI

https://www.sandeals.net/openapi.json

Agenten-Prompt

Richten Sie den Agenten auf www.sandeals.net/for-agents.md oder verwenden Sie diesen Prompt:

Agenten-Prompt

Mit https://www.sandeals.net/mcp verbinden. search_deals aufrufen. Titel und Link jedes Angebots aus der Antwort zurückgeben.

Referenz

MCP-Server

Der MCP-Server verwendet Streamable HTTP und speichert zwischen Anfragen keinen Sitzungszustand. Seine URL lautet www.sandeals.net/mcp.

Endpoint	POST `/mcp`
Alias	POST `/api/mcp`
Auth	None
Transport	Streamable HTTP · JSON-RPC 2.0
Protocol	2025-03-26 · 2025-06-18 · 2025-11-25
Methods	initialize · tools/list · tools/call

Tools

search_dealsSchreibgeschützt

Sucht Angebote nach Stichwort. Jedes Ergebnis enthält Titel, Link und Kategorie.

Feld	Typ	Hinweise
`query`Erforderlich	string	1–512 chars
`limit`	integer	1–50 · default 10

list_dealsSchreibgeschützt

Listet den Katalog, optional gefiltert nach Kategorie oder Stichwort.

Feld	Typ	Hinweise
`category`	enum	all · food · travel · shopping · tech · books · lifestyle · education
`search`	string	≤ 512 chars
`limit`	integer	1–100 · default 20

tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_deals",
    "arguments": {
      "query": "coffee",
      "limit": 5
    }
  }
}

REST API

Die REST-API führt dieselbe Suche aus wie das MCP-Tool search_deals. Übergeben Sie Ihre Anfrage in q. limit ist optional, Standardwert 10, Maximum 50. Bei POST-Anfragen senden Sie mode: "agent" , um strukturiertes JSON zu erhalten.

GETPOST/api/search-advanced

curl "https://www.sandeals.net/api/search-advanced?q=coffee&limit=5"

Katalog: GET /api/deals listet den Katalog. Filtern Sie mit category, search (oder dem Alias q) und limit.
HTML-Fallback: GET /search?q=coffee liefert eine HTML-Ergebnisseite, die ohne JavaScript funktioniert. Verwenden Sie sie nur, wenn Ihr Client kein JSON lesen kann.

Antwort

Jedes Ergebnis enthält title und href.

response.json

{
  "ok": true,
  "query": "coffee",
  "total": 1,
  "results": [
    {
      "title": "Example Cafe",
      "href": "https://slink.sandeals.net/example",
      "category": "food",
      "summary": "Example cafe — coffee and tea.",
      "score": 13,
      "source": "deals"
    }
  ],
  "response": "Found 1 deal for \"coffee\": 1. Example Cafe — https://slink.sandeals.net/example",
  "meta": {
    "mode": "agent",
    "matched": true
  }
}

Feld	Typ	Hinweise
`results[].title`	string	Name des Händlers oder Angebots
`results[].href`	string	Angebots-URL
`results[].category`	string	food (Essen), travel (Reisen), shopping (Einkaufen), tech (Technik), books (Bücher), lifestyle (Lifestyle)
`meta.matched`	boolean	false bedeutet Fallback-Vorschläge

Pfad	Format
/llms.txt	Markdown
/for-agents.md	Markdown
/api/llms	JSON
/.well-known/ai.txt	Text
/openapi.json	OpenAPI 3
GET /mcp	JSON

Nächste Schritte

SanDeals ist verbunden. Sehen Sie sich jetzt die vollständige Referenz und die anderen Integrationswege an.

API-ReferenzAlle Endpunkte, Parameter und Antwortschemata.MCP-ServerServerdetails, Tools und Verbindungsschritte auf einer Seite.OpenAPI-SpezifikationIn ChatGPT Actions importieren oder einen Client generieren.Leitfaden für AgentenDie Dokumentation in Markdown, für Coding-Agenten und Crawler.

Mit SanDeals entwickeln

Integrationsweg wählen

Schnellstart

Claude Code

ChatGPT

Cursor und andere Clients

ChatGPT Actions

Agenten-Prompt

MCP-Server

Tools

REST API

Antwort

Einschränkung

Ausprobieren

Indizes

Nächste Schritte