Verbinden Sie Ihren KI-Assistenten (MCP)
Tabs
PlatoForms unterstützt das Model Context Protocol (MCP). Der offene Standard ermöglicht es KI-Assistenten wie ChatGPT, Claude, Cursor und OpenAI Codex, direkt mit Ihrem PlatoForms-Konto zu arbeiten. Sobald die Verbindung hergestellt ist, können Sie einfach Ihren Assistenten fragen:
- “Was hat die letzte Einsendung zu meinem Aufnahmeformular gesagt?” . er findet das Formular, liest die Antworten und kann Ihnen einen zeitlich begrenzten PDF-Download-Link bereitstellen.
- “Reiche diesen Testeintrag in meinem Feedback-Formular ein.”
- “Erstelle einen Link zu meinem Bestellformular mit der vorab ausgefüllten E-Mail des Kunden.”
- “Erstelle ein Anmeldeformular für unsere Community-Workshop.” . die KI erstellt ein komplett neues Formular (oder PDF-Dokument) aus Ihrer Beschreibung; öffnen Sie den zurückgegebenen Link und beobachten Sie, wie das Design erscheint.
Um MCP zu nutzen, benötigen Sie ein PlatoForms-Konto mit API-Zugriff. Neue Konten beinhalten API-Zugriff während der 15-tägigen kostenlosen Testphase. Assistentenaktionen nutzen Ihr verfügbares API-Kontingent und unterliegen zusätzlichen Ratenbeschränkungen.
Ihr Assistent erhält nur den Zugriff, den Sie gewähren. Jede Aktion durchläuft die gleichen Berechtigungs- und Planprüfungen wie die PlatoForms-App. Für Teams mit aktiviertem HIPAA-Compliance ist der Zugriff des KI-Assistenten standardmäßig deaktiviert. Ein Teamleiter kann ihn nach Überprüfung des Abschnitts Datenverwendung und eingeschränkte Daten unten aktivieren.
Die PlatoForms MCP-Serveradresse lautet:
https://mcp.platoforms.com
ChatGPT verbinden
-
Öffnen Sie Plugins in ChatGPT und suchen Sie nach PlatoForms, oder öffnen Sie die PlatoForms-Plugin-Seite.
-
Wählen Sie Installieren, dann melden Sie sich bei PlatoForms an.
-
Wählen Sie Lesezugriff oder Lese- und Schreibzugriff und klicken Sie auf Zulassen.
-
Geben Sie in einem Chat
@PlatoFormsein und fragen Sie etwas wie “Liste meine veröffentlichten Formulare und deren Einsendungszahlen auf.”
Ihr PlatoForms-Passwort wird nicht mit ChatGPT geteilt. Sie können die Verbindung jederzeit widerrufen.
Claude verbinden (ein Klick)
Funktioniert mit Claude im Web und Claude Desktop.
-
Öffnen Sie in Claude Einstellungen > Konnektoren und klicken Sie auf Benutzerdefinierten Konnektor hinzufügen.
-
Geben Sie
https://mcp.platoforms.comals Server-URL ein und bestätigen Sie. -
Claude öffnet eine PlatoForms-Anmeldeseite. Melden Sie sich an und klicken Sie auf Zulassen.
-
Fertig . fragen Sie Claude etwas wie “Liste meine PlatoForms-Formulare auf.”
Sie können die Verbindung jederzeit in den Konnektoreinstellungen von Claude trennen.
Mehrere Teams: MCP autorisiert das Konto, bei dem Sie zum Zeitpunkt der Verbindung angemeldet sind. nicht das Team, das derzeit im PlatoForms-Dashboard ausgewählt ist. Wenn Sie ein bestimmtes Team verbinden müssen, melden Sie sich zuerst von PlatoForms ab, melden Sie sich als Konto dieses Teams wieder an und starten Sie dann die Verbindung.
Claude Code verbinden
Führen Sie in einem Terminal aus:
claude mcp add --transport http platoforms https://mcp.platoforms.com
Starten Sie dann eine neue Claude Code-Sitzung, geben Sie /mcp ein, wählen Sie platoforms und wählen Sie Authentifizieren. Melden Sie sich im geöffneten Browserfenster bei PlatoForms an und klicken Sie auf Zulassen.
Um es auszuprobieren, fragen Sie etwas wie “Mit den PlatoForms-Tools, als wen bin ich angemeldet?” . Claude sollte mit Ihrer Konto-E-Mail und Ihrem Teamnamen antworten.
OpenAI Codex verbinden
Aktuelle Versionen von OpenAI Codex unterstützen OAuth-Anmeldung für entfernte MCP-Server. PlatoForms unterstützt OAuth-Erkennung, dynamische Client-Registrierung und PKCE, sodass Ihr Passwort und API-Schlüssel niemals mit Codex geteilt werden.
- Fügen Sie PlatoForms als MCP-Server hinzu:
codex mcp add platoforms --url https://mcp.platoforms.com
- Starten Sie die OAuth-Anmeldung:
codex mcp login platoforms
-
Codex öffnet eine PlatoForms-Anmeldeseite. Melden Sie sich an und klicken Sie auf Zulassen.
-
Starten Sie eine neue Codex-Sitzung und fragen Sie “Mit den PlatoForms-Tools, als wen bin ich angemeldet?”
Sie können das Konto mit codex mcp logout platoforms trennen.
PlatoForms veröffentlicht die OAuth-Metadaten und unterstützten Bereiche, die Codex benötigt, sodass die normale Einrichtung keinen festen Rückrufport, keine Client-ID, Ressource oder explizite Bereichsliste erfordert. Verwaltete Umgebungen mit speziellen Rückrufanforderungen können die optionalen OAuth-Einstellungen von Codex verwenden. Siehe OpenAI’s Codex MCP-Dokumentation.
Mit einem API-Schlüssel verbinden (Alternative)
OAuth wird für Claude und OpenAI Codex empfohlen. Cursor, Skripte, ältere Clients und andere MCP-kompatible Tools können stattdessen mit einem PlatoForms API-Schlüssel verbunden werden. Öffnen Sie in PlatoForms Konto > API und kopieren Sie Ihr API-Token, dann folgen Sie den Schritten für Ihr Tool unten.
Ihr API-Schlüssel trägt den vollen API-Zugriff des Teamleiters. behandeln Sie ihn wie ein Passwort. Bevorzugen Sie die Ein-Klick-Verbindung, wo sie verfügbar ist.
Cursor
Fügen Sie den Server zu ~/.cursor/mcp.json hinzu (erstellen Sie die Datei, wenn sie nicht existiert):
{
"mcpServers": {
"platoforms": {
"url": "https://mcp.platoforms.com",
"headers": {
"Authorization": "Bearer <Ihr API-Schlüssel>"
}
}
}
}
Starten Sie Cursor neu (oder laden Sie seine MCP-Server neu) und bitten Sie es, Ihre PlatoForms-Formulare aufzulisten.
OpenAI Codex (API-Schlüssel)
Verwenden Sie diese Methode für die Automatisierung oder wenn browserbasiertes OAuth nicht verfügbar ist. Wenn Sie die OAuth-Verbindung oben bereits konfiguriert haben, entfernen Sie sie zuerst mit codex mcp remove platoforms.
Fügen Sie den Server zu ~/.codex/config.toml hinzu (erstellen Sie die Datei, wenn sie nicht existiert):
[mcp_servers.platoforms]
url = "https://mcp.platoforms.com"
bearer_token_env_var = "PLATOFORMS_API_KEY"
Codex liest den API-Schlüssel aus der Umgebungsvariable, die durch bearer_token_env_var benannt ist, also machen Sie ihn verfügbar, bevor Sie Codex starten. zum Beispiel durch Hinzufügen dieser Zeile zu Ihrem Shell-Profil:
export PLATOFORMS_API_KEY="<Ihr API-Schlüssel>"
Starten Sie Codex neu und bitten Sie es, Ihre PlatoForms-Formulare aufzulisten.
Andere MCP-Tools
Jedes MCP-kompatible Tool, das entfernte (Streamable HTTP) Server unterstützt, kann verbunden werden. Verwenden Sie https://mcp.platoforms.com als Server-URL. Wenn das Tool PlatoForms OAuth unterstützt, verwenden Sie dessen Browser-Anmeldefluss; andernfalls senden Sie Ihren API-Schlüssel als Bearer-Authorization-Header.
Zugriff des KI-Assistenten ein- oder ausschalten
Teamleiter können den Zugriff des KI-Assistenten für das gesamte Team ein- oder ausschalten.
-
Öffnen Sie in PlatoForms Konto > API.
-
Finden Sie das KI-Assistenten-Zugriff (MCP)-Panel und klicken Sie auf Aktivieren oder Deaktivieren.
Für Teams ohne aktivierte HIPAA-Compliance ist der Zugriff des KI-Assistenten standardmäßig aktiviert. Für Teams mit aktivierter HIPAA-Compliance ist er standardmäßig deaktiviert und bleibt deaktiviert, bis ein Teamleiter ihn aktiviert. Sie müssen den HIPAA-Modus nicht deaktivieren, um MCP zu verwenden.
Bevor Sie dies für ein HIPAA-aktiviertes Team aktivieren, lesen Sie Datenverwendung und eingeschränkte Daten. Daten, die über MCP an einen Drittanbieter-KI-Anbieter gesendet werden, sind nicht durch die Business Associate Agreement (BAA) von PlatoForms abgedeckt.
Fehlerbehebung
Fehler 462
Das API-Kontingent Ihres Plans wurde erreicht. Entweder aktualisieren Sie Ihren Plan oder warten Sie, bis Ihr nächster Abrechnungszyklus das Kontingent zurücksetzt.
Fehler 403 . Berechtigung verweigert
Dieser Fehler tritt in zwei verschiedenen Situationen auf:
- Tatsächliches Berechtigungsproblem . das verbundene Konto hat keinen Zugriff auf die angeforderte Ressource (zum Beispiel ein Formular, das einem anderen Team gehört).
- Ressource nicht gefunden . die an das Tool übergebene Formular-ID oder Einsendungs-ID existiert nicht. Überprüfen Sie die ID und versuchen Sie es erneut.
Wenn Sie sicher sind, dass die ID korrekt ist und das Konto Zugriff hat, versuchen Sie, die Verbindung zu trennen und erneut zu verbinden, um sicherzustellen, dass die OAuth-Sitzung aktuell ist.
Was Ihr Assistent tun kann
- Lesen . Formulare auflisten und durchsuchen, Formulardefinitionen lesen, Einsendungen auflisten und lesen, ablaufende Download-Links für generierte PDFs und Anhänge erstellen.
- Schreiben . Formulareinträge einreichen und vorab ausgefüllte Einladungslinks erstellen. Nur Links: Assistenten können niemals E-Mails von Ihrem Konto senden.
- Erstellen . neue KI-gestaltete Webformulare und PDF-Dokumente aus einer Beschreibung.
Ratenbeschränkungen gelten zusätzlich zum API-Kontingent Ihres Plans, und jede vom Assistenten erstellte Einladung bleibt zur Überprüfung in Ihrer Einladungsliste sichtbar.
Für Beispielaufforderungen für jede dieser Aktionen, was zurückkommt und was Ihr Assistent nicht tun kann, siehe Was Sie Ihren KI-Assistenten fragen können.
Datenverwendung und eingeschränkte Daten
PlatoForms sendet dem verbundenen Assistenten nur die für die von Ihnen angeforderte Aktion benötigten Tool-Eingaben und Ergebnisse. Je nach Tool kann dies Ihre Kontoidentität, Formularnamen und Felddefinitionen, Einsendungsdaten, generierte Dokumentmetadaten und zeitlich begrenzte Dateilinks umfassen. Der MCP-Dienst ist ein zustandsloses Relais zur PlatoForms-API und speichert keine separate Kopie von Formular- oder Einsendungsinhalten nach Abschluss einer Anfrage. Es erhält nicht Ihren vollständigen KI-Chatverlauf.
Der von Ihnen verbundene KI-Anbieter erhält die Tool-Eingaben und Ergebnisse und verarbeitet sie gemäß seinen eigenen Bedingungen, Datenschutzrichtlinien, Aufbewahrungsregeln und Kontoeinstellungen. Überprüfen Sie diese Richtlinien, bevor Sie eine Verbindung herstellen:
- PlatoForms-Datenschutzrichtlinie
- PlatoForms-Nutzungsbedingungen
- Kontaktieren Sie den PlatoForms-Support
Verwenden Sie die MCP-Integration nicht, um Zahlungsdaten, die PCI DSS unterliegen, Regierungskennungen, Passwörter, API-Schlüssel, Authentifizierungsgeheimnisse oder MFA/Einmalcodes zu sammeln, einzureichen oder zu verarbeiten.
Geschützte Gesundheitsinformationen (PHI). MCP ist standardmäßig für Teams mit aktivierter HIPAA-Compliance deaktiviert, und ein Teamleiter kann es aktivieren. Daten, die über MCP an einen Drittanbieter-KI-Anbieter gesendet werden, sind nicht durch die Business Associate Agreement von PlatoForms abgedeckt. Wenn Sie MCP in einem HIPAA-aktivierten Team aktivieren, liegt es in Ihrer Verantwortung als die abgedeckte Einheit zu bestimmen, ob die Offenlegung gemäß den HIPAA-Regeln zulässig ist und alle erforderlichen Vereinbarungen direkt mit dem verbundenen KI-Anbieter zu treffen.
Das öffentliche PlatoForms-Plugin für ChatGPT darf nicht verwendet werden, um PHI zu sammeln, einzureichen, abzurufen oder anderweitig zu verarbeiten.