Eine Integrationsart wählen
| Art | Wofür |
|---|---|
| Programm (Fire-and-Forget) | Startet eine andere App, ohne auf ihr Ende zu warten oder ihre Ausgabe zu übernehmen |
| Stdio-Filter | Übergibt Text an ein Programm und übernimmt das umgewandelte Ergebnis |
| REST-API (HTTP POST) | Sendet JSON und übernimmt den Antworttext |
| MCP-Client | Ruft ein Tool auf einem MCP-Server auf und übernimmt den Antworttext |
Ein Tool registrieren und ausführen
- Wählen Sie Einstellungen → Externe Tools → + Tool hinzufügen.
- Geben Sie einen Namen ein, wählen Sie den Tooltyp und füllen Sie die Felder für diesen Typ aus, etwa einen Programmpfad oder eine Endpunkt-URL.
- Nimmt das Tool Text entgegen, wählen Sie die zu sendende Eingabe. Liefert es ein Ergebnis, wählen Sie, wie die Ausgabe verarbeitet werden soll.
- Setzen Sie bei Bedarf Nur ausführen, wenn eine Datei geöffnet ist und Nur ausführen, wenn Text markiert ist.
- Speichern Sie die Einstellungen und führen Sie im Terminal
/<Toolname>aus.
Sie können Tools auch über das Steckersymbol in der Formatierungsleiste ausführen. Jedes registrierte Tool erscheint auf den Einstellungsregisterkarten Tastenkürzel und Gesten, wo Sie ihm ein Tastenkürzel oder eine Geste zuweisen können.
Das aktuelle Dokument an ein Tool übergeben
Verwenden Sie die folgenden Platzhalter in Argumenten und an anderen Stellen.
| Platzhalter | Inhalt |
|---|---|
{file} / {dir} | Der Dateipfad und der Ordner, der die Datei enthält |
{selection} | Der markierte Text |
{workspace} | Das Stammverzeichnis des Arbeitsbereichs |
{input} | Was Sie im Terminal nach dem Toolnamen eingegeben haben |
{full_document} | Das ganze Dokument. Verfügbar im REST-Body und im Argument-JSON für MCP |
{token} | Das registrierte Token. Verfügbar in REST-Headern und -Body sowie im Argument-JSON für MCP |
Verwenden Sie in JSON die Platzhalter mit der Endung _json. Diese maskieren Anführungszeichen und Zeilenumbrüche und schließen die umgebenden Anführungszeichen ein, sodass das Ergebnis eine gültige JSON-Zeichenkette ist. Setzen Sie den Platzhalter nicht zusätzlich in Anführungszeichen.
{"text": {selection_json}, "instruction": {input_json}}Was Sie je nach Art prüfen sollten
- Stdio-Filter: Wählen Sie, was übergeben wird, etwa die Markierung, das ganze Dokument oder das Terminalargument. Prüfen Sie den Pfad zum Programm und seinen Arbeitsordner.
- REST-API: Ein externer Endpunkt muss HTTPS verwenden. Der Antworttext wird unverändert übernommen, einzelne Felder lassen sich also nicht aus JSON herauslösen. Tokens registrieren Sie mit Token festlegen….
- MCP: Für Standard-Ein-/Ausgabe geben Sie den Befehl, seine Argumente und seine Umgebungsvariablen an; für HTTP den Endpunkt. Legen Sie dann den Toolnamen und das Argument-JSON fest. Um
npxoderuvxzu verwenden, installieren Sie die benötigte Laufzeitumgebung separat.
Festlegen, wohin das Ergebnis geht
Das Ergebnis kann die Markierung ersetzen, an der Cursorposition eingefügt werden, das ganze Dokument ersetzen, in die Zwischenablage gehen, zu einer neuen Datei werden oder im Terminal angezeigt werden. Das Ersetzen des ganzen Dokuments wird nicht automatisch gespeichert; prüfen Sie das Ergebnis vor dem Speichern.
Wenn Sie nach dem Start einer Ausführung den Tab wechseln, wandert die Ausgabe nicht mit: Sie wird auf den Tab angewendet, in dem die Ausführung gestartet wurde. Wurde dieser Tab geschlossen, wird die Ausgabe in einem neuen Tab geöffnet. Eine laufende Ausführung können Sie im Fortschrittsfenster oder im Terminal abbrechen.
Ihre Definitionen auf einen anderen Rechner übertragen
Verwenden Sie auf der Registerkarte „Externe Tools“ Als JSON exportieren… / Aus JSON importieren…. Prüfen Sie vor dem Import die Programmpfade und URLs. Tokenwerte werden nicht mit exportiert; registrieren Sie sie auf dem anderen Rechner erneut.
Externe Tools können nicht ausgeführt werden, solange die Lizenz das Bearbeiten nicht erlaubt. Prüfen Sie den Status unter Lizenzierung und Aktivierung.