Naski
FunktionenIntegrationenPreiseDokumentationSicherheitBlog
AnmeldenKostenlos starten
Dokumentation

Wie man es tatsächlich benutzt

Die drei Dinge, die ein neues Team am ersten Tag braucht. Alles hier beschreibt das Produkt, wie es heute ausgeliefert wird.

01

Was ein Agent ist und wie man einen bekommt

Ein Agent ist ein Stück TypeScript, geschrieben gegen ein einziges Objekt. Sie müssen ihn nicht schreiben: Beschreiben Sie die Aufgabe im Chat, Naski schreibt ihn und zeigt Ihnen den Code, bevor irgendetwas gespeichert wird.

  1. 1

    Sagen Sie, was wann passieren soll. „Jeden Werktag um 8 Uhr“, „sobald ein PDF in einem Ordner landet“, „wenn jemand an diese Adresse schreibt“. Zeitplan und Auslöser werden aus dem Code gelesen, ohne ihn auszuführen — sie stehen deshalb als feste Werte darin.

  2. 2

    Lesen Sie vor dem Speichern, was er tut. Der Code ist das Verhalten — dahinter steckt nichts Verborgenes.

  3. 3

    Geben Sie ihm einen Ordner, wenn er nur einen Teil Ihres Bereichs sehen soll. Seine Dateiwerkzeuge sind dann auf diesen Teilbaum beschränkt.

  4. 4

    Lassen Sie ihn ein Journal führen. Ein Agent schreibt je erledigter Sache eine Zeile in Klartext, markiert als offen oder erledigt, und liest sie im nächsten Lauf zurück. So übersteht eine lange Aufgabe ihre Aufteilung in viele kurze Läufe.

  5. 5

    Entscheiden Sie, was über Sie läuft. Eine Freigabe anzufordern pausiert den Lauf, bis ein Mensch antwortet, und wertet Schweigen als Ablehnung; eine Prüfung einzureihen stellt einen Punkt für später ein, ohne zu blockieren.

  6. 6

    Einen Agenten zu bearbeiten erzeugt einen neuen, sodass die funktionierende Fassung erhalten bleibt.

Gut zu wissenAgenten haben keinen beiläufigen Netzzugang. Alles, was sie erreichen — das Web, Ihren Bereich, ein verbundenes Werkzeug — geht über einen benannten Aufruf, den die Plattform für sie ausführt.

02

Wie man ein Werkzeug verbindet

Ein Konnektor ist Daten, kein Code: eine Basisadresse, eine Auth-Form und eine Liste von Operationen. Naski baut die Anfrage und setzt Ihre Zugangsdaten serverseitig ein.

  1. 1

    Öffnen Sie Einstellungen → Konnektoren und installieren Sie aus dem Katalog. Sie können den Chat auch bitten, das für Sie zu tun.

  2. 2

    Wo der Anbieter auf Ihrem Deployment registriert ist, klicken Sie auf Verbinden und bestätigen auf dessen eigenem Bildschirm. Es wird nirgends ein Schlüssel kopiert.

  3. 3

    Andernfalls fügen Sie den Schlüssel in den Einstellungen ein. Fügen Sie einen Schlüssel nie in eine Chat-Nachricht ein: Schlüssel gehören in die Einstellungen, wo sie verschlüsselt gespeichert und serverseitig eingesetzt werden.

  4. 4

    Manche Dienste liegen unter der Adresse Ihres Unternehmens — Salesforce, Zendesk, Jira, Confluence, Zoho CRM, Odoo, Shopify, DocuSign. Deren Installation fragt nach Ihrer Instanz-URL und verweigert ohne sie.

  5. 5

    Ausgehende Aufrufe laufen nur über HTTPS und werden abgelehnt, wenn die Adresse in ein privates oder reserviertes Netz auflöst.

  6. 6

    Verweigert ein Anbieter die Erneuerung eines Tokens, wird die Verbindung gelöscht und Sie werden zum erneuten Verbinden aufgefordert — statt dass jeder Aufruf still fehlschlägt.

Gut zu wissenEin Dienst außerhalb des Katalogs bleibt erreichbar: Der Chat kann einen Konnektor dafür in derselben deklarativen Form schreiben, und ein entfernter MCP-Server deckt werkzeugartige Dienste ab.

03

Wie man einen externen KI-Client verbindet

Naski stellt einen eigenen MCP-Server bereit, damit ein Client wie Claude Code, Claude Desktop oder ChatGPT Ihre Agenten dort auflisten, anlegen, ausführen und einsehen kann, wo Sie ohnehin arbeiten.

  1. 1

    Öffnen Sie Einstellungen → MCP-Server. Die Adresse steht dort, und sie lautet:

    https://api.blackbox.finance/mcp
  2. 2

    Claude Desktop und ChatGPT verbinden sich über OAuth: Adresse als Konnektor hinzufügen und bestätigen. Es gibt kein Token zum Kopieren.

  3. 3

    Für einen Kommandozeilen-Client erzeugen Sie ein Token in den Einstellungen und führen aus:

    claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN"
  4. 4

    Ein Token wird einmal angezeigt und nur als Hash gespeichert. Widerrufen Sie es auf demselben Bildschirm; ein Konto darf bis zu zwanzig halten.

  5. 5

    Externe KI-Verbindungen gehören zu den bezahlten Tarifen — der kostenlose Tarif enthält sie nicht.

Gut zu wissenAlles, was ein MCP-Client sieht, ist auf das Konto beschränkt, dessen Token er verwendet: dessen Agenten, Läufe und Credits, und sonst nichts.

Bereit, es an einem echten Arbeitsablauf zu testen?

Der kostenlose Tarif umfasst einen aktiven Agenten und einen geplanten Lauf — genug, um zu sehen, ob die Form passt, bevor jemand etwas unterschreibt.

Kostenlos startenKontakt aufnehmen