# AI-App verbinden > Verbinden Sie Claude, ChatGPT, Cursor, VS Code oder einen beliebigen MCP-Client mit TradeCatalog mit Ihrem eigenen Login. TradeCatalog führt einen remote [Model Context Protocol](https://modelcontextprotocol.io) (MCP) Server aus. Verbinden Sie ihn mit Ihrer KI-App und fragen Sie beispielsweise: - „Wie viel zahlt Oakfield Joinery für 20 Kartons HX-8510?“ - „Gibt es heute neue Aufträge?“ - „Wer hat den Rabatt bei Brookside geändert und wann?“ - „Finden Sie mir einen Zinkhexenbolzen, M10, und meinen Preis dafür.“ (als Käufer) ## So funktioniert es | Einstellung | Wert | | --------------- | -------------------------------------------------------------------------------------------------------------- | | Server-URL | `https://tradecatalog.app/mcp` | | Transport | Streambarer HTTP | | Anmeldung | OAuth 2.1: Sie melden sich mit Ihrem normalen TradeCatalog-Anmeldeinformationen an und wählen Sie **Erlauben** | | Zugriff | Leserechte, optional Schreibzugriff mit überprüftem Review für konsequente Änderungen. | | Wer es ausführt | Sie. Es sieht genau das, was Sie in TradeCatalog sehen können. | - **Mitarbeiter** sehen die Daten, die ihrer Rolle und Kundenbereich erlauben. Verkaufsmitarbeiter können nur bestimmte Kunden oder Regionen abdecken; Katalog, Preise, Aufträge und Teamänderungen erfordern jeweils die entsprechende Berechtigung. - **Käufer** sehen die Lieferanten, von denen sie einkaufen, mit ihren eigenen Preisen und nur ihren eigenen Aufträgen. Team-Einladungen, Arbeitsbereichseinstellungen und API-Zugriff folgen den aktuellen Mitarbeiterberechtigungen des Lieferanten. Das Löschen von Arbeitsbereichen bleibt nur dem Eigentümer vorbehalten. Käufer wählen für jeden Auftrag ihr eigenes Kundenkonto aus. Bestehende Verbindungen bleiben bis zur erneuten Autorisierung schreibgeschützt. Jeder Toolaufruf wird mit denselben Regeln überprüft wie die App. Siehe [MCP-Tools](/docs/mcp/tools), was jeder Tool macht. ## Workflow-Fähigkeiten Das TradeCatalog-Plugin enthält zehn spezialisierte Fähigkeiten mit seiner MCP-Verbindung. Jede Fähigkeitsbeschreibung sagt der KI-App, wann der Workflow gilt; ihre Anweisungen erklären, welche Tools verwendet werden sollen, was zuerst gelesen werden soll und wie Bestätigungen und unvollständige Ergebnisse behandelt werden. | Fähigkeit | Wann sie verwenden | | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `tradecatalog` | Verbinden, ein Lieferanten-Arbeitsbereich erstellen oder einen Lieferanten und Kundenkonten auswählen. | | `tradecatalog-catalogue` | Produkte erstellen, bearbeiten, verstecken, anzeigen und organisieren oder Produktmedien hochladen. | | `tradecatalog-pricing` | Erklären Sie vereinbarte Preise und passen Sie die Bedingungen an oder entwerfen und veröffentlichen Sie Preisänderungen. | | `tradecatalog-imports` | Überprüfen und Importieren von Produktzeilen, Kundenkonten oder vereinbarten Preisen. | | `tradecatalog-customers` | Kunden einrichten, Käufer einladen und Zugriff oder genehmigte Produktlisten verwalten. | | `tradecatalog-orders` | Preisinformationen für Käufer abrufen, Aufträge vorbereiten oder wiederholen, erlaubte Preislisten herunterladen oder Aufträge verfolgen. | | `tradecatalog-fulfilment` | Lieferantenaufträge überprüfen und bestätigen, versenden, abschließen oder stornieren. | | `tradecatalog-updates` | Käuferaktualisierungen lesen oder Lieferantennachrichten mit expliziter Zeitplanung und E-Mail-Optionen veröffentlichen. | | `tradecatalog-workspace` | Geschäftseinstellungen verwalten, Mitarbeiter einladen und autorisierte Export- oder API-Übergaben durchführen. | | `tradecatalog-support` | Lesen, vorbereiten oder senden Sie eine Lieferantensupportanfrage oder Folgeanfrage an Happy Webs. | Andere Agenten können die gleichen Leitfäden aus [dem öffentlichen Fähigkeitsindex](https://tradecatalog.app/.well-known/agent-skills/index.json) entdecken. Fähigkeiten leiten den Workflow; der Server überprüft immer noch den Kontozugriff und erfordert eine angemeldete Bestätigung für konsequente Änderungen. ## Registrieren und bezahlen mit einem Agenten Sie können sich vor dem Erstellen eines Arbeitsbereichs verbinden. Die Verbindung öffnet die Anmeldeseite von TradeCatalog, wo eine neue E-Mail-Adresse nach der Bestätigung Ihre Anmeldung erstellt. Bestätigen Sie dies dort, dann kehren Sie zu Ihrer KI-App zurück. Teilen Sie niemals Anmeldecodes oder Zahlungsdetails in Chats. Fordern Sie den Agenten auf, Ihren Lieferanten-Arbeitsbereich zu erstellen. Er fragt nach Ihrem Firmennamen, Währung, Zeitzone und Land, dann verwendet er `create_workspace` für Ihre Bestätigung. Ihr Arbeitsbereich startet einen 14-tägigen Pro-Test mit keiner Karte. Es ist kein Abonnement. Wenn der Test endet, kehrt es zu Free zurück, bis zu 100 Produkte, es sei denn, Sie upgraden. Für Agenten, deren Host die Software-Abonnements-Buchung erlaubt, verbinden Sie sich mit **`https://tradecatalog.app/mcp/account`**. Es verwendet denselben TradeCatalog-Anmelde-Login, OAuth-Bereiche und Arbeitsbereichsmitgliedschaften, mit allen gewöhnlichen Tools plus `open_billing`. Wenn Sie eine Zahlung oder das Verwalten Ihres Abonnements anfordern, öffnet dieses Eigentümer-Tool die sichere Rechnungsseite des Arbeitsbereichs. Wählen Sie monatliche oder jährliche Abrechnung und bestätigen Sie die Zahlung über Stripe. Bestehende Abonnenten können ihr Abonnement dort verwalten. Der Agent kann danach `get_settings` prüfen; das Öffnen eines Links ist kein Beweis dafür, dass die Zahlung abgeschlossen wurde. ChatGPT-Plugins verwenden **`https://tradecatalog.app/mcp`**, das keine Buchungstools offenlegt. OpenAI's [Plugin-Richtlinien](https://developers.openai.com/plugins/plugin-guidelines) schließen derzeit das Verkaufen von Software-Abonnements und das Bewerben von Upgrades aus. Kostenlose Anmeldung und Arbeitsbereichserstellung sind über diese Verbindung möglich. Agenten können Handelsauftragsanfragen vorbereiten. Optionale Kundenzahlungen erfordern, dass der Käufer die angemeldete Bestellseite öffnet, die genaue, von dem Lieferanten bestätigte Gebühr genehmigt und Stripe Checkout abschließt. Die Genehmigung eines Auftrags durch den Agenten ist niemals eine Zahlungsgenehmigung. ## Claude (Web, Desktop und Mobil) 1. Öffnen Sie **Einstellungen**, dann **Verbindungen**, und wählen Sie **Benutzerdefinierte Verbindung hinzufügen**. 2. Nennen Sie sie „TradeCatalog“ und fügen Sie `https://tradecatalog.app/mcp` ein. 3. Wählen Sie **Verbinden**. Melden Sie sich bei TradeCatalog mit Ihrem E-Mail-Code an und wählen Sie **Erlauben**. Verbindungen, die Sie auf der Web-Version hinzufügen, erscheinen auch in Claude Desktop und den mobilen Apps. Bei Team- und Enterprise-Plänen muss ein Eigentümer möglicherweise zuerst die Verbindung für die Organisation hinzufügen. ## Claude Code ```bash claude mcp add --transport http tradecatalog https://tradecatalog.app/mcp ``` Führen Sie dann `/mcp` in Claude Code aus und wählen Sie **tradecatalog**, um sich anzumelden. ## ChatGPT 1. Öffnen Sie **Einstellungen**, dann **Apps & Verbindungen**. Wenn Ihre Planung dies erfordert, schalten Sie unter **Erweitert** **Entwicklermodus** ein. 2. Erstellen Sie eine Verbindung mit der URL `https://tradecatalog.app/mcp` und OAuth-Authentifizierung. 3. Melden Sie sich bei TradeCatalog an und wählen Sie **Erlauben**. ## Cursor Fügen Sie dies zu `~/.cursor/mcp.json` (oder `.cursor/mcp.json` in einem Projekt) hinzu: ```json { "mcpServers": { "tradecatalog": { "url": "https://tradecatalog.app/mcp" } } } ``` Cursor öffnet die TradeCatalog-Anmelde-Seite, wenn Sie es das erste Mal verwenden. ## VS Code Fügen Sie dies zu `.vscode/mcp.json` hinzu: ```json { "servers": { "tradecatalog": { "type": "http", "url": "https://tradecatalog.app/mcp" } } } ``` ## Andere Clients Jeder Client, der Remote-MCP über Streamable HTTP mit OAuth unterstützt, funktioniert. Für Clients, die nur lokale (stdio) Server ausführen, verwenden Sie die `mcp-remote`-Brücke: ```json { "mcpServers": { "tradecatalog": { "command": "npx", "args": ["-y", "mcp-remote", "https://tradecatalog.app/mcp"] } } } ``` Möchten Sie Ihren eigenen Client erstellen? Siehe [OAuth für MCP-Clients](/docs/mcp/oauth). ## Verbindung eines Apps trennen Sehen Sie sich alle AI-Apps an, die Sie genehmigt haben, und trennen Sie jede davon unter [tradecatalog.app/oauth/connections](/oauth/connections). Das Entfernen der Verbindung in Ihrer AI-App verhindert, dass diese App sie verwendet. Das Trennen hier widerruft auch deren Zugriff auf unserer Seite sofort. ## MCP oder die REST API? | | MCP | REST API | | -------------------------- | ------------------------------------------------------ | --------------------------------------------------------- | | Für | Menschen, die in einer AI-App chatten | Ihre eigenen Systeme und Skripte | | Anmeldung als | Jeder einzelne, mit eigener Anmeldung | Der Arbeitsbereich, mit dem API-Schlüssel des Eigentümers | | Käufer können es verwenden | Ja, mit ihren eigenen Preisen | Nein | | Kann Daten ändern | Ja, mit Schreibberechtigung und überprüften Änderungen | Ja, mit einem Lese- und Schreibschlüssel | | Einrichtung durch | Jeder einzelne, in ihrer AI-App | Der Eigentümer, in den Einstellungen | | Dokumentation | [Tools](/docs/mcp/tools) | [REST API](/docs/api) |