Inhalt der Dokumentation14 / 16

Einstellungen und Hilfe14 / 16

MCP-Server und Skills hinzufügen

Auf dieser Seite

Fügen Sie einen MCP-Server hinzu, wenn ein Agent zusätzliche Werkzeuge oder Dienstverbindungen benötigt. Ein Skill bündelt wiederverwendbare Anweisungen und Ressourcen für eine Art von Arbeit. Noea verwaltet diese Erweiterungen zentral für normale Chats über Agents hinweg.

Erweiterungen sind optional und für den Einstieg nicht erforderlich. Erläuterungs- und Neuordnungsaufgaben verwenden die hier hinzugefügten Erweiterungen nicht.

Die benötigte Erweiterung wählen

ArtZweckEinstellungen
MCP-ServerZusätzliche Werkzeuge oder Dienstverbindungen bereitstellen.Einstellungen → MCP-Server
SkillAnweisungen und unterstützende Ressourcen für eine Art von Arbeit bereitstellen.Einstellungen → Skills

Die Verfügbarkeit eines Servers hängt auch davon ab, ob der Agent dessen Verbindungsmethode unterstützt. Verwenden Sie bei Skill-Befehlen die tatsächlich im Chat angezeigte Liste.

Einen MCP-Server hinzufügen

Öffnen Sie Einstellungen → MCP-Server, fügen Sie einen Server hinzu, geben Sie einen Namen ein und wählen Sie die Verbindungsmethode.

  • stdio: Einen Dienst lokal starten. Geben Sie Befehl, Argumente und erforderliche Umgebungsvariablen ein, mit einem Argument pro Zeile.
  • HTTP: Einen Dienst über eine URL verbinden. Geben Sie Serveradresse und erforderliche Header an.

Liefert der Dienst eine kompatible JSON-Konfiguration, füllen Sie das Formular mit JSON einfügen. Prüfen Sie vor dem Sichern Befehl, Adresse und Authentifizierungsfelder.

Namen müssen unabhängig von Groß-/Kleinschreibung eindeutig sein. Namen, die mit noea beginnen, sind reserviert. Die erste Zeile ist Noeas integrierter Server; er ist immer aktiviert und kann nicht gelöscht werden.

Verbindung testen

Verbindung testen im Bearbeitungsbereich verwendet die aktuellen Formularwerte. Ein Test aus der Liste verwendet die gespeicherte Konfiguration.

Ein erfolgreicher Test zeigt Werkzeugnamen und Anzahl. Bei Fehlern wird die Phase angegeben, etwa fehlender Befehl, Prozessende, Zeitüberschreitung, abgelehnte Anfrage oder fehlgeschlagener Handshake. Benötigt ein HTTP-Dienst Autorisierung, folgen Sie dem Ablauf des gewählten Agenten.

Ein erfolgreicher Test bedeutet, dass die Konfiguration eine Verbindung ermöglicht. Er garantiert weder Unterstützung durch jeden Agenten noch aktiviert er den Server automatisch für einen Chat.

Einen Server für einen Chat aktivieren

Die Standardeinstellung für neue Chats in der Serverliste bestimmt die anfängliche Auswahl. Im Konfigurationsmenü eines Chats können Sie dessen MCP-Server auch gezielt auswählen.

Die Auswahl wird mit dem Chat gespeichert. Ein verbundener Agent lädt geänderte Einstellungen nicht sofort neu; sie gelten ab seiner nächsten Verbindung. Starten Sie für eine neue Konfiguration einen neuen Chat und prüfen Sie die Serverauswahl.

Das Menü erläutert, warum ein Server nicht verfügbar ist, etwa wegen einer fehlenden Umgebungsvariable oder nicht unterstützten Verbindungsmethode.

Umgebungsvariablen verwenden

Umgebungsvariablen- und Headerwerte unterstützen ${VAR}-Verweise auf Variablen in Noeas Laufzeitumgebung. Die Werte werden beim Verbinden gelesen. Testen Sie nach der Einrichtung die Verbindung. Ein export in einem Terminal garantiert nicht, dass ein bereits laufender Noea-Prozess diesen Wert besitzt.

Felder verbergen Werte standardmäßig und können sie per Klick anzeigen. Das Verbergen verhindert nur die Anzeige; es ändert nicht, wie die Konfiguration gespeichert oder verwendet wird.

Einen Skill hinzufügen

Öffnen Sie Einstellungen → Skills, wählen Sie die Hinzufügen-Aktion und einen Ordner mit SKILL.md. Die App erklärt mögliche Formatprobleme.

Der Skill wird in Noeas Bibliothek aufgenommen. Ergänzungen und Entfernungen gelten in neuen Chats. Sie können seinen Ort im Dateimanager anzeigen. Löschen entfernt die Bibliothekskopie, nicht den ursprünglich ausgewählten Ordner.

Dieselbe Seite zeigt schreibgeschützt Nutzer- und Projekt-Skills aus Agent-Verzeichnissen. Sehen Sie ihre Orte an oder wählen Sie Nach Noea kopieren. Die Liste umfasst nicht alle in Agents integrierten oder durch deren Plugins bereitgestellten Skills.

Erweiterungen im Chat verwenden

Starten Sie einen neuen Chat und geben Sie am Anfang der Eingabe / ein, um Noea-Skills und Agent-Befehle zu durchsuchen. Wählen Sie einen verfügbaren Eintrag, ergänzen Sie die Anforderungen der aktuellen Aufgabe und senden Sie ihn.

Fehlt eine Erweiterung, prüfen Sie, ob Sie einen neuen Chat gestartet haben und der Agent sie unterstützt. Lesen Sie anschließend Fehlerbehebung.