Verbinden Sie Ihren KI-Assistenten
Verbinden Sie Claude, ChatGPT oder einen anderen MCP-Client mit Ihrem Kundenportal. Der Assistent kann Ihre Projekte, Rechnungen, Support-Tickets, Website-Status und Dateien lesen. Auf den Tarifen Pro und Ultra kann er außerdem Tickets eröffnen oder Änderungsanfragen senden, aber nur, nachdem Sie die genaue Vorschau bestätigt haben.
Werkzeuge und Limits
Jeder Tarif legt seine eigenen Grenzen fest. Der Server erzwingt die Anzahl der Schlüssel, die Anfragen pro Minute je Schlüssel und die monatlichen Einheiten für das gesamte Konto.
Basic
KostenlosNur lesen. Auf diesem Tarif sind keine Schreibzugriffe möglich
Projekte, Rechnungen, Support-Tickets, Websitestatus, Projektdateien und den Monatsbericht einsehen.
Pro
3,000,000 Toman / MonatLesen und bestätigte Schreibzugriffe
Alle Lesewerkzeuge sowie bestätigte Schreibzugriffe: Support-Tickets eröffnen und beantworten, Änderungsanfragen und Farr-Nachrichten senden, Dateien hochladen, Inhaltsentwürfe erstellen und aktualisieren sowie Vorschläge annehmen oder ablehnen. Jeder Schreibvorgang wird zuerst als Vorschau angezeigt und erst nach Ihrer Zustimmung ausgeführt.
Ultra
5,000,000 Toman / MonatAlles aus Pro, plus Massenaktionen und Webhooks
Alles aus Pro, plus Massenaktionen für Tickets (bulk_ticket_reply, bulk_ticket_close und bulk_actions, bis zu 20 Tickets pro Aufruf), Webhooks (webhook_list, webhook_create und webhook_delete) und geplante Monatsberichte (scheduled_reports und scheduled_reports_get).
Sicherheit: Keine Zahlungs- oder Eigentumsaktionen
Die Assistenten-API enthält keine Werkzeuge zur Rechnungsbegleichung, Geldüberweisung, Änderung der Kontoinhaberschaft oder Schlüsselverwaltung. Rechnungen sind dort schreibgeschützt. Zahlungen erfolgen direkt im Kundenportal.
So erstellen Sie einen Assistentenschlüssel
Erstellen Sie in drei Schritten einen Schlüssel im Kundenportal.
1. Im Portal anmelden
Melden Sie sich im Kundenportal an und öffnen Sie den Bereich Assistentenzugriff im Menü.
2. Schlüssel erstellen
Klicken Sie auf "Schlüssel erstellen". Geben Sie einen Namen mit 3 bis 60 Zeichen ein (z. B. "Claude Code - Laptop"), wählen Sie die Berechtigungen und die Gültigkeitsdauer. Zur Erstellung ist eine erneute Anmeldung erforderlich.
3. Schlüssel einmalig kopieren
Der vollständige Schlüssel wird nur einmal direkt nach der Erstellung angezeigt. Der Server speichert nur einen SHA-256-Hash des Geheimnisses. Bei Verlust widerrufen Sie den Schlüssel und erstellen einen neuen.
Verbindung mit Claude & ChatGPT
Verbinden Sie sich über das MCP-Streamable-HTTP-Protokoll mit einem Bearer-Schlüssel oder per OAuth-Anmeldung.
Claude Code und andere MCP-Clients
Fügen Sie in Konfigurationen mit Server-URL und Headern, wie der Datei .mcp.json von Claude Code, diesen Eintrag hinzu und ersetzen Sie den Platzhalter durch Ihren Schlüssel:
{
"mcpServers": {
"sajjad-portal": {
"type": "http",
"url": "https://sajjad.blog/api/client/mcp",
"headers": {
"Authorization": "Bearer <YOUR_AGENT_KEY>"
}
}
}
}ChatGPT und Web-Assistenten
Fügen Sie diese Adresse als benutzerdefinierten Connector hinzu und melden Sie sich bei Aufforderung an (OAuth). Kein Schlüssel erforderlich. Die Menübezeichnungen können je nach Assistent variieren.
Was "Vorschau, dann Bestätigung" für Schreibvorgänge bedeutet
Ein Schreibvorgang wird niemals beim ersten Aufruf angewendet.
Wenn ein Assistent ein Schreibwerkzeug aufruft, speichert der Server die genaue Anfrage und gibt eine Vorschau mit einem Einmalkennwort zurück, das nach 10 Minuten abläuft. Die Änderung wird erst angewendet, wenn der Assistent das Bestätigungswerkzeug mit diesem Kennwort aufruft. Der Assistent ist angewiesen, dies erst nach Ihrer Zustimmung zu tun. Jedes Kennwort funktioniert nur einmal, nur für den erstellenden Schlüssel und das Konto sowie mit denselben Argumenten. Jeder vorgemerkte Vorgang wird protokolliert.
Verifizierte Werkzeugreferenz
Die wichtigsten Werkzeuge des Client-Endpunkts sowie das Bestätigungswerkzeug, das nach einer Vorschau verwendet wird. Ein Werkzeug, das nicht in Ihrem Tarif enthalten ist, wird mit einer plan_required-Meldung abgelehnt.
| Werkzeugname | Zugriffsart | Funktionsbeschreibung |
|---|---|---|
| projects_list | Lesen | Bis zu 50 Ihrer Projekte auflisten: Code, Name, Status, Fortschritt und Enddatum. |
| invoices_list | Lesen | Bis zu 25 Rechnungen mit Fälligkeitsdatum, Gesamtbetrag, gezahltem Betrag, Saldo und Status auflisten. Mit openOnly nur unbezahlte anzeigen. Entwürfe und Zahlungslinks sind ausgeschlossen. |
| tickets_list | Lesen | Bis zu 50 Ihrer Support-Tickets mit Status, Priorität und letzter Antwortzeit auflisten. |
| ticket_get | Lesen | Nachrichtenverlauf eines Support-Tickets abrufen (bis zu 100 Nachrichten). Interne Notizen sind ausgeschlossen. |
| ticket_create | Bestätigtes Schreiben | Neues Support-Ticket mit niedriger oder normaler Priorität vorbereiten. Wird erst nach Ihrer Bestätigung erstellt. |
| ticket_reply | Bestätigtes Schreiben | Antwort auf ein offenes Ticket vorbereiten. Geschlossene Tickets können nicht beantwortet werden. Wird erst nach Bestätigung gesendet. |
| change_request_create | Bestätigtes Schreiben | Änderungswunsch für eines Ihrer Projekte vorbereiten. Wird erst nach Ihrer Bestätigung übermittelt. |
| site_status | Lesen | Domainstatus, Besucher und Seitenaufrufe (24 Stunden und 7 Tage), Verfügbarkeit in Prozent und offene Fehler der Website anzeigen. Werte stammen aus der letzten Telemetrie-Synchronisierung. |
| files_list | Lesen | Dateien im Projektspeicher auflisten, bis zu 100 pro Seite, optional innerhalb eines Ordners. |
| file_link | Lesen | Download-Link für eine gespeicherte Datei erstellen. Der Link läuft nach 15 Minuten ab. |
| report_monthly | Lesen | Monatszusammenfassung abrufen (bis zu 12 Monate zurück): Projekte, geöffnete und geschlossene Tickets, aktueller Websitestatus, fällige Rechnungen und ein nach 15 Minuten ablaufender PDF-Link. |
Häufig gestellte Fragen
Häufige Fragen zu Kundenassistenten, Sicherheit und Nutzungsgrenzen.
Kann mein KI-Assistent Rechnungen automatisch bezahlen?
Nein. Die Assistenten-API verfügt über keine Werkzeuge zur Rechnungsbegleichung oder Geldüberweisung. Rechnungen können dort nur eingesehen werden; die Zahlung erfolgt direkt im Kundenportal.
Was passiert, wenn ich mein monatliches Einheitenkontingent erreiche?
Jeder Tarif hat ein monatliches Einheitenbudget für das gesamte Konto. Ein Lesezugriff kostet 1 Einheit, eine Schreib-Vorschau 3 Einheiten. Erreicht die Nutzung des Kontos im Monat das Budget des Tarifs, liefern weitere Aufrufe bis zum Wechsel des UTC-Kalendermonats einen quota_exceeded-Fehler im Werkzeugergebnis zurück (HTTP 200, nicht 429).
Wie widerrufe ich einen Assistentenschlüssel bei Verdacht auf Missbrauch?
Öffnen Sie den Assistentenzugriff im Kundenportal, wählen Sie Schlüssel widerrufen und bestätigen Sie. Jede weitere Anfrage mit diesem Schlüssel wird sofort abgewiesen. Über OAuth verbundene Assistenten können auf derselben Seite getrennt werden.
Benötige ich eine lokale Bridge, um ChatGPT zu verbinden?
Nein. Der Endpunkt ist ein normaler HTTPS-Endpunkt: Der Client sendet JSON-RPC-Nachrichten per POST und empfängt JSON-Antworten. Cloud-Assistenten können sich ohne lokale Software direkt verbinden.
Bereit, Ihren Assistenten einzusetzen?
Wählen Sie einen Tarif oder erstellen Sie im Kundenportal einen Assistentenschlüssel.