ProxyAI-MCP-Connector

Was Sie damit tun können

Der ProxyAI-MCP-Connector gibt einem Assistenten Zugriff auf Ihre Bots, Helpdesk-Tickets und Agent Tasks. Version 1.0.0 umfasst acht Lesewerkzeuge und elf Werkzeuge, die Änderungen vornehmen.

Bitten Sie ihn, offene Tickets zusammenzufassen, einen freigegebenen Antwortentwurf anzusehen, die letzten Läufe einer Agent Task zu prüfen oder einen zurückgehaltenen Plan zu erklären. Mit Schreibberechtigung können Sie ihn bitten, eine bestimmte Antwort zu senden, ein Ticket zu aktualisieren, eine unterstützte Berichtsaufgabe anzulegen oder einen unterstützten Lauf freizugeben, den Sie geprüft haben.

Server-URL: https://www.proxyai.app/api/mcp

Der öffentliche Endpunkt steht für eigene Verbindungen zur Verfügung. Die Verzeichniseinträge werden vorbereitet. Gehostete Tool-Abläufe in ChatGPT wurden mit synthetischen Daten getestet. Die Prüfung des Verzeichnisses, Tests nach Änderungen auf dem Host und die Validierung für Claude sind getrennte Freigabeschritte.

Bevor Sie verbinden

Nutzen Sie Ihr ProxyAI-Konto in einem normalen Browser. Ein eingebettetes Shop-Dashboard oder eine Sitzung auf einem mobilen Gerät kann diese Verbindung nicht genehmigen. Der Connector hat keinen zusätzlichen Kauf und kein Abo. Helpdesk und Agent Tasks brauchen trotzdem ihre bestehenden Add-ons auf dem Bot, den Sie nutzen. Es gelten die normalen Kapazitätsgrenzen für Agent Tasks und die Gebühren pro Lauf.

Die Berechtigung umfasst alle aktuellen und künftigen Bots dieses Kontos. In Version 1 gibt es keine Zustimmung pro Bot. Verbinden Sie nur einen Assistenten, dem Sie zutrauen, die Nachrichten Ihrer Kunden und die Informationen zu Aufgaben zu erhalten.

Claude verbinden

Öffnen Sie in Claude Anpassen → Connectors und wählen Sie Benutzerdefinierten Connector hinzufügen. In einer verwalteten Organisation bitten Sie Ihren Inhaber, ihn zuerst hinzuzufügen.
Geben Sie https://www.proxyai.app/api/mcp ein. Verwenden Sie den HTTP-Transport und keine /sse-Adresse.
Wählen Sie die OAuth-Anmeldung. Bietet Claude eine Auswahl für den OAuth-Client an, nutzen Sie die veröffentlichte Identität von Claude. Sie müssen keine Client-ID, kein Client-Secret und keinen API-Schlüssel erstellen. Die automatische Registrierung wird ebenfalls unterstützt.
Verbinden Sie sich und melden Sie sich im Browser bei ProxyAI an. Prüfen Sie auf der Zustimmungsseite Konto, App-Identität und Rückkehradresse.
Lassen Sie Änderungen erlauben für reinen Lesezugriff deaktiviert. Aktivieren Sie es nur, wenn dieser Assistent Änderungen vornehmen soll, und wählen Sie dann Verbinden.
Aktivieren Sie ProxyAI für die Unterhaltung über + → Connectors und beginnen Sie mit „Liste meine ProxyAI-Bots auf“.

Die aktuelle Oberfläche beschreibt die Anleitung zu Claudes benutzerdefinierten Connectors.

ChatGPT verbinden

Öffnen Sie in ChatGPT Plugins → Hinzufügen → Benutzerdefinierten MCP-Server hinzufügen. Geben Sie https://www.proxyai.app/api/mcp ein und wählen Sie OAuth.
Öffnen Sie Erweiterte OAuth-Einstellungen. Prüfen Sie, dass die gefundenen Autorisierungs-, Token- und Registrierungs-URLs zu https://www.proxyai.app gehören, die Ressource https://www.proxyai.app/api/mcp ist und der Callback https://chatgpt.com/connector_platform_oauth_redirect lautet. Der veröffentlichte CIMD-Client von ChatGPT wird ohne Client-Secret unterstützt.
Für eine reine Lesverbindung wählen Sie als Standardbereich nur read und lassen die Basisbereiche leer. Für eine Verbindung, die Schreibzustimmung anbieten kann, fordern Sie read und write an. Im aktuellen Formular tragen Sie sie in getrennten Zeilen unter Basisbereiche ein.
Erstellen Sie die Verbindung und melden Sie sich bei ProxyAI an. Lassen Sie Änderungen erlauben für Lesezugriffe deaktiviert oder aktivieren Sie es ausdrücklich, um Schreibzugriff zu gewähren. write allein gewährt ihn nicht. Der Zugriff umfasst alle aktuellen und künftigen Bots dieses Kontos.
Öffnen Sie das verbundene Plugin und wählen Sie Im Chat ausprobieren. Beginnen Sie mit „Liste meine ProxyAI-Bots auf“.

Für den Test im Browser nutzen Sie die benutzerdefinierte MCP-Verbindung. Ein nicht veröffentlichtes hochgeladenes ZIP bietet stattdessen unter Umständen In der Desktop-App öffnen an. Das öffentliche Einreichungs-ZIP deklariert den HTTPS-Server in mcp.json. Schließen Sie dort das OAuth-Setup ab und führen Sie den Scan über Mit MCP im Entwicklerportal aus. Fügen Sie die .app.json oder die technische ID einer privaten Verbindung nicht in das öffentliche ZIP ein. OpenAI lehnt App-Verweise in Einreichungspaketen derzeit ab.

Meldet ChatGPT nach einer abgelehnten Schreibaktion eine abgelaufene Verbindung, prüfen Sie zuerst den erteilten Bereich unter Verbundene Apps in ProxyAI. Eine aktive Lese-Freigabe braucht eine neue Schreibzustimmung, keine Reparatur des Tokens. Versuchen Sie nie, eine Nachricht an einen Kunden erneut zu senden, bevor Sie deren Ergebnis geprüft haben.

Die aktuellen Hinweise finden Sie im Verbindungsleitfaden von OpenAI und in den Einreichungsanforderungen.

Codex verbinden

Fügen Sie den Remote-Server von ProxyAI hinzu und melden Sie sich danach über OAuth an:

codex mcp add proxyai --url https://www.proxyai.app/api/mcp
codex mcp login proxyai --scopes read

Beenden Sie die Anmeldung im Browser und lassen Sie Änderungen erlauben deaktiviert. Wollen Sie stattdessen Schreibzugriff, fordern Sie beide Bereiche an und aktivieren Sie Änderungen erlauben ausdrücklich:

codex mcp login proxyai --scopes read,write

Die Konfiguration prüfen Sie mit codex mcp list, die verfügbaren Werkzeuge mit /mcp in der Codex-Terminaloberfläche. Siehe die offizielle MCP-Dokumentation. Ihr Client verwaltet die OAuth-Token. Fügen Sie sie nicht in eine Unterhaltung ein.

Mit Lesezugriffen beginnen

„Liste meine ProxyAI-Bots auf und fasse danach die offenen Tickets für den ausgewählten Bot zusammen.“
„Zeige die vorbereitete Agentenantwort für dieses Ticket. Sende sie nicht.“
„Zeige die letzten fünf Läufe dieser Agent Task und erkläre jeden zurückgehaltenen Vorschlag. Gib ihn nicht frei.“

Listen sind seitenweise aufgeteilt. Bitten Sie um die nächste Seite, wenn Sie mehr Ergebnisse brauchen. Die Identität eines Tickets umfasst Bot, Anbieter und Ticket-ID. Aufgaben- und Lauf-IDs müssen zum ausgewählten Bot gehören. Ein Assistent kann keine beliebige Unterhaltung aus einem anderen Konto auswählen.

Änderungen bewusst vornehmen

Prüfen Sie das Ticket und den genauen Antworttext, bevor Sie darum bitten, einen Entwurf zu senden oder freizugeben. Die Freigabe sendet den Entwurf über den Kanal des Tickets an den Kunden. Ein Entwurf wird vor der Zustellung beansprucht, sodass gleichzeitige Freigaben abgelehnt werden. Ist die Zustellung ungewiss, bleibt der Entwurf für eine menschliche Prüfung gesperrt. Prüfen Sie den Kanal des Kunden, bevor Sie erneut senden. Eine fehlgeschlagene oder verlorene Antwort beweist nicht, dass der Kunde nichts erhalten hat. Im Dashboard bestätigen Sie mit den Steuerelementen zur Zustellungsprüfung, ob die Zustellung erfolgt ist. Der Server wartet, bis das Sendezeitlimit abgelaufen ist, bevor er den Abgleich erlaubt. Ein bestätigtes ausbleibendes Zustellen stellt den vorbereiteten Entwurf wieder her. Eine bestätigte Zustellung schließt die Prüfung ab.

Bei Agent Tasks unterstützt MCP Wöchentliche Verkaufsübersicht, Bestellstatus-Überwachung und Wissensbasis-Auffrischung. Sie senden Berichte an die E-Mail Ihres Kontos. Das Wissensrezept frischt außerdem Ihre Wissensbasis auf. Das Anlegen einer Aufgabe aktiviert sie und startet ihren Zeitplan. Prüfen Sie diese Aktionen sowie Zeitzone, Stunde und Tag, bevor Sie sie anlegen. Eigene Rezepte, geänderter Rezeptcode, geänderte Prompts oder Berechtigungen, Platzhalter für Zugangsdaten, beliebige API- oder MCP-Werkzeuge und externe E-Mail-Empfänger werden beim Anlegen, Ausführen, Fortsetzen und bei der Freigabe eines zurückgehaltenen Laufs über MCP abgelehnt. Andere Aufgaben können Sie weiterhin ansehen oder pausieren. Bevor Sie manuell ausführen, wählen Sie ausdrücklich Test oder Live. Beide können übliche LLM- und CPU-Kosten verursachen. Beide Modi senden tatsächliche Berichts-E-Mails an Ihr Konto. Der Testmodus zeigt nur eine Vorschau der Wissensauffrischung, der Live-Modus kann sie anwenden. Prüfen Sie einen zurückgehaltenen Plan, bevor Sie ihn freigeben, denn die Freigabe stellt die vorgeschlagenen Aktionen in die Warteschlange und kann Kosten verursachen. Das Fortsetzen einer Aufgabe kann geplante, kostenpflichtige Läufe neu starten.

Ticket-Schlagwörter werden jeweils als vollständige Liste ersetzt. Das Setzen von Schlagwörtern auf einem integrierten ProxyAI-Ticket wird unterstützt. Schlagwörter externer Helpdesks werden in diesem Helpdesk verwaltet. Archivieren entfernt ein Ticket vom aktiven Board, ohne es zu löschen.

Nachrichten von Kunden, Aufgabenanweisungen und zurückgehaltene Vorschläge können irreführende Anweisungen enthalten. Behandeln Sie sie als Inhalt, den Sie prüfen. Die Erlaubnis zum Senden, Ausführen oder Freigeben kommt von Ihnen.

Werkzeuge in Version 1

Lesewerkzeug	Zweck
`list_bots`	Bots finden, die Ihrem Konto gehören.
`list_tickets`	Tickets auflisten und nach Status, Schlagwort und Archivstatus filtern.
`get_ticket`	Ein Ticket, seinen vorbereiteten Entwurf und die Unterhaltungsnachrichten lesen.
`list_agent_tasks`	Die Aufgaben eines Bots auflisten.
`get_agent_task`	Aufgabenanweisung, Zeitplan und Status lesen.
`list_agent_runs`	Lauf-Status und Verlauf durchsehen, ohne Protokolle und Vorschlagstexte.
`get_agent_run`	Status und zurückgehaltenen Vorschlag eines Laufs ohne interne Diagnosen prüfen.
`list_agent_templates`	Die drei unterstützten Berichtsrezepte finden.

Schreibwerkzeug	Zweck
`reply_ticket`	Die von Ihnen angegebene Antwort senden.
`set_ticket_status`	Auf offen, ausstehend oder gelöst setzen.
`set_ticket_tags`	Die Schlagwörter eines integrierten Tickets ersetzen.
`archive_ticket`	Ein Ticket archivieren.
`approve_ticket_agent_draft`	Einen vorbereiteten Entwurf freigeben und senden, optional mit überarbeitetem Text.
`dismiss_ticket_agent_draft`	Einen Entwurf verwerfen, ohne ihn zu senden.
`create_agent_task`	Eine Aufgabe anlegen und aktivieren. Der Zeitplan einer Vorlage kann künftige Läufe auslösen.
`run_agent_task`	Einen ausdrücklich gewählten Test- oder Live-Lauf in die Warteschlange stellen.
`decide_agent_run`	Einen zurückgehaltenen Lauf freigeben oder ablehnen.
`pause_agent_task`	Den Zeitplan einer Aufgabe pausieren.
`resume_agent_task`	Eine pausierte Aufgabe fortsetzen.

Konfigurieren Sie Connector-Konten und Zugangsdaten im Dashboard. Geben Sie in MCP-Anfragen keine Passwörter, Token, Zahlungskartendaten, staatlichen Kennungen oder geschützten Gesundheitsdaten ein. Geplante Aufgaben und zurückgehaltene Vorschläge verlangen, dass Sie ihre tatsächlichen Aktionen prüfen, bevor Sie sie freigeben.

Aktivität prüfen und Zugriff widerrufen

Öffnen Sie in ProxyAI Kontoeinstellungen → Verbundene Apps, um die App, ihren erteilten Bereich und die letzte Token-Nutzung zu sehen. Wählen Sie Zugriff widerrufen, um künftige Anfragen dieser Verbindung zu stoppen. Der Widerruf macht eine bereits gesendete Antwort oder einen bereits eingereihten Lauf nicht rückgängig.

Die Karte Aktivität verbundener Apps protokolliert Schreibversuche und ihre Ergebnisse. Steht ein Versuch auf ausstehend oder meldet ein unbekanntes Ergebnis, kann die Aktion bereits gewirkt haben. Prüfen Sie das Ticket oder den Lauf, bevor Sie es erneut versuchen. Ältere Versuche bleiben nach dem Widerruf verfügbar.

Daten, die der Connector zurückgibt, werden mit dem Assistenten geteilt, den Sie verbunden haben, und unterliegen dessen Richtlinien zur Verarbeitung. ProxyAI speichert Verbindungsdatensätze und Metadaten der Schreibversuche. Das MCP-Auditprotokoll speichert keine Antworttexte, keine Werkzeug-Nutzdaten und keine rohen Bearer-Token. Lesen Sie unsere Datenschutzerklärung.

Datengrenzen

Ticketlisten lassen Kontakt-E-Mail und Namen sowie interne Unterhaltungs-IDs weg. Laufleisten lassen Protokolltexte und interne Diagnosen weg. Die Laufdetails enthalten nur relevanten Status, Zeiten und zurückgehaltene Aktionen. Der Connector entfernt strukturierte Felder mit Zugangsdaten und lehnt erkannte Zugangsdaten, Zahlungskartennummern, staatliche Kennungen und Gesundheitsinhalte in Eingaben, Entwürfen oder zurückgegebenem Text ab. Die Erkennung ist vorsichtig und kann nicht jede sensible Tatsache in beliebigem Fließtext finden. Verwenden Sie den Connector nicht für besonders schützenswerte Daten. Prüfen Sie Ihre Quelldaten, bevor Sie verbinden. Abgelehnte Inhalte müssen im Dashboard bearbeitet werden.

Fehlerbehebung

Verbindung schlägt fehl: Verwenden Sie https://www.proxyai.app/api/mcp. Ein Aufruf im Browser kann „Method not allowed“ zurückgeben, weil der Connector MCP-POST-Anfragen annimmt. Ein MCP-Client erhält vor der Anmeldung eine OAuth-Aufforderung.
Eingeschränkter Inhalt: Die Anfrage oder das Ergebnis enthält erkannte sensible Inhalte. Bearbeiten Sie sie im Dashboard. Formulieren Sie kein Geheimnis um, um die Prüfung zu umgehen.
Nicht unterstützte Aufgabe: Verwenden Sie eines der drei unveränderten Berichtsrezepte. Eigene Abläufe konfigurieren Sie im Dashboard.
Schreibberechtigung erforderlich: Verbinden Sie neu, indem Sie sowohl read als auch write anfordern, und aktivieren Sie Änderungen erlauben. Eine reine Lesezustimmung kann keine Schreibvorgänge autorisieren.
Add-on erforderlich: Öffnen Sie das Dashboard des ausgewählten Bots und prüfen Sie dessen Add-on Helpdesk oder Agent Tasks.
Nicht gefunden: Prüfen Sie, ob Sie das richtige Konto und den richtigen Bot gewählt haben. Lesen Sie das Ticket oder die Aufgabe dann erneut, bevor Sie handeln.
Abgelaufene oder widerrufene Verbindung: Melden Sie sich erneut an. Versuchen Sie einen früheren Schreibvorgang nicht erneut, bevor Sie dessen Ergebnis geprüft haben.

Kontaktieren Sie support@proxyai.app mit dem App-Namen, der Uhrzeit und der Aktion, die fehlgeschlagen ist. Senden Sie in Ihrer Supportanfrage keine Zugriffstoken, Client-Secrets oder Kundennachrichten.