MCP

MCP-Server ergänzen Anyy um externe Werkzeuge. Jeder Server gehört zu einem Profil. Konfigurieren Sie Verbindung und Werkzeugbereitstellung und speichern Sie dann. Prüfen ist ein optionaler Verbindungstest; er ist zum Speichern oder Aktivieren eines Servers nicht erforderlich.

Über ein Gespräch konfigurieren

Sie können Anyy einen bestimmten MCP-Endpunkt oder lokalen Serverbefehl geben und es bitten, den Server dem aktuellen Profil hinzuzufügen. Das Gespräch verwendet die vorhandene Anyy-CLI, sofern Shell-Werkzeuge verfügbar sind; die MCP-Konfiguration ist kein separates natives Modellwerkzeug. Verwenden Sie für Gespräch und Dashboard dasselbe Profil. Ist ein ausdrücklicher CLI-Profilpfad erforderlich, ist dies der Anyy-Profilpfad, der vom HOME einer Shell abweichen kann.

Aktualisieren Sie nach dem Speichern die Seite, um Server-ID, Aktivierungseinstellung und Verbindung zu prüfen. Sie können den Server auch direkt auf dieser Seite hinzufügen und Anyy im nächsten Gesprächsschritt bitten, ihn zu verwenden. Bei Bereitstellung über codemode entdeckt und verwendet es die Werkzeuge über Codemode; deferred verwendet die Werkzeugsuche. Das Speichern einer Definition, das Anzeigen ihres Namens und der tatsächliche Aufruf eines Remote-Werkzeugs sind getrennte Prüfungen. Eine fehlgeschlagene Verbindung muss als Fehler sichtbar bleiben, auch wenn die Konfiguration erfolgreich gespeichert wurde.

Einen Server im Dashboard hinzufügen

Öffnen Sie Dashboard → MCP → MCP-Server hinzufügen.

1. Geben Sie eine dauerhafte Server-ID aus Buchstaben, Ziffern, Bindestrichen oder Unterstrichen ein.
2. Wählen Sie stdio für einen lokalen Befehl oder http für einen Remote-Endpunkt.
3. Geben Sie Befehl und Argumente oder die MCP-URL ein.
4. Legen Sie bei Bedarf Anbieterauthentifizierung, OAuth-Optionen, Header oder Umgebungswerte fest.
5. Wählen Sie Bereitstellung und optionale geordnete JSON-Werkzeugüberschreibungen.
6. Wählen Sie Speichern. Verwenden Sie bei Bedarf Prüfen, um Verbindungsergebnisse einzusehen.

Der lokale Befehl läuft mit den Betriebssystemrechten der Anyy-Laufzeit. Gewöhnliche Umgebungs-/Header-/OAuth-Werte behalten die eingegebenen Zeichenfolgen; Speichern leitet aus einem Feldnamen keine Geheimnisreferenz ab. Verwenden Sie explizite Geheimnisreferenzen für durch Anyy verwaltete geheime Werte. Siehe Wertausdrücke.

Die gemeinsame Verbindung meldet den residenten Workspace-Stamm, der beim Start des MCP-Managers festgelegt wird. Das konfigurierte Arbeitsverzeichnis eines lokalen Prozesses ist davon unabhängig. Einzelheiten zu Initialisierung, Stamm und Arbeitsverzeichnis finden Sie unter Initialisierung und Workspace-Stämme.

Verbindungsvoraussetzungen

Unterstützte Client-Transporte sind stdio und Streamable HTTP (http). Ein separater Transport sse wird abgelehnt; HTTP kann im Rahmen von Streamable HTTP weiterhin Ereignisströme übertragen. Remote-Endpunkte müssen HTTPS verwenden; ausgenommen sind HTTP-URLs auf Loopback-Adressen.

Installieren Sie bei stdio die ausführbare Serverdatei und ihre Abhängigkeiten auf dem Rechner, auf dem Anyy läuft. Ein npx-Befehl benötigt dort Node.js/npm; Anyy liefert diese Laufzeiten nicht mit und installiert den Server nicht für Sie. Es wird nur eine begrenzte Prozessumgebung einschließlich PATH und HOME geerbt; setzen Sie andere benötigte Werte ausdrücklich über Server-env. HTTP-Server benötigen keine lokale Node.js-Laufzeit.

Einstellungen und Profildefinitionen

Die gespeicherte Profildefinition und der wirksame Projekteintrag können aus verschiedenen Dateien stammen. Prüfen Sie vor dem Bearbeiten die Konfigurationsquelle des Servers; siehe Profil- und Projektkonfiguration.

Verwenden Sie zum Aktivieren/Deaktivieren den vorhandenen Aktivierungsschalter. Wählen Sie unter Bearbeiten die Einstellungsoperation, um nur Bereitstellung in der ausgewählten Quelle oder vorhandenen Überschreibung zu speichern; lassen Sie Transport- und Definitionsfelder leer. Unbeteiligte Server werden nicht neu verbunden. Auch Änderungen der Bereitstellung verbinden den ausgewählten Server nicht neu. Verwenden Sie für Transport, Zugangsdaten, Beschreibung und geordnete Werkzeugüberschreibungen eine separate Profildefinitionsoperation. Verbinden Sie beide Operationen nicht in einem Speichervorgang.

Ein Verbindungsfehler nach dem Speichern von Einstellungen macht die gespeicherte Einstellung nicht rückgängig. mcp reload verbindet geladene Werte neu; das erneute Einlesen manuell geänderter Dateien erfordert einen Start oder einen session.reload-RPC im Leerlauf, nicht einen weiteren Verbindungstest.

Werkzeugbereitstellung

Wert	Verhalten
codemode	Standard; über die Codemode-Erkennung zugänglich
deferred	Über die Werkzeugsuche entdeckt
direct	Dem Modell direkt bekanntgegeben
hidden	Von Modell- und Codemode-Erkennung ausgeschlossen

toolExposure überschreibt die Servervorgabe. Ein exakter Name hat Vorrang; andernfalls gewinnt die erste passende Platzhalterregel. Die Objektreihenfolge ist daher relevant:

{"search":"direct","read*":"deferred","*":"hidden"}

Die MCP-Konfiguration erstellt oder aktiviert keine persönlichen Werkzeuggruppen mcp-*. Gewöhnliche persönliche Anyy-Werkzeuggruppen und übergeordnete Werkzeugbeschränkungen bleiben getrennt.

HTTP-Authentifizierung

Wenn weder ein Authorization-Header noch eine Anbieterreferenz konfiguriert ist, unterstützt Anyy bei Bedarf den OAuth-Ablauf des Remote-Servers. Eine Anbieterreferenz ist ein JSON-Objekt:

{"provider":"provider-id"}

OAuth-Optionen sind ein weiteres JSON-Objekt, zum Beispiel {"clientId":"registered-client"}. Die alten Selektoren auth: oauth, header und none werden nicht akzeptiert. Speichern Sie vertrauliche Header als Geheimnisreferenzen; schreiben Sie keine Zugangsdaten in URLs.

Speichern Sie den Server und wählen Sie auf seiner Detailseite Anmelden. Öffnen Sie die Autorisierungsseite; falls der Browser Anyy nicht erreichen kann, fügen Sie die vollständige Weiterleitungs-URL in dieses Anmeldeformular ein. Brechen Sie ab oder verlassen Sie die Seite, um die ausstehende Anmeldung zu stoppen. Die CLI-Alternative lautet anyy mcp login SERVER_ID --timeout 300.

Um sich abzumelden und den Server zu behalten, verwenden Sie anyy mcp logout SERVER_ID mit der exakt konfigurierten ID; Verhalten von Zugangsdaten und Cache ist unter Abmelden beschrieben. Dies ist ein CLI-Befehl, keine zusätzliche Dashboard-Schaltfläche. Das Entfernen einer rohen Profildefinition löscht auch deren durch Anyy verwaltete OAuth-Zugangsdaten. Verwenden Sie für Projektdefinitionen den Projektablauf per CLI/Datei; remove --local bewahrt diese Autorisierungen und wird nach erneutem Einlesen der Konfiguration wirksam. Bestehende Regeln für Profilbesitz und Zugangsdaten-Schutz gelten für alle Konfigurationsänderungen.

Status und Werkzeuge

Die Servereinstellung sagt aus, ob er aktiviert ist. Die Laufzeitverfügbarkeit meldet separat „verbunden“, „ausstehend“, „beeinträchtigt“ oder „nicht verfügbar“. Prüfergebnisse enthalten ein tools-Inventar mit den Angaben name, visible_name, description, exposure und offered für jedes Werkzeug. Das Inventar ist keine Freigabe- oder Zulassungslistenentscheidung.

Die standardmäßige OAuth-Unterstützung von HTTP verlangt bei anonymen Servern keine Anmeldung. Verbindungsbereitschaft und Zugangsdatenstatus sind getrennt: auth_mode: oauth kann mit einer bereiten Verbindung und als not_loaded gekennzeichnetem OAuth-Material zusammen auftreten. Ein anfängliches Fehlen von Token allein ist keine Aufforderung zur erneuten Authentifizierung. Eine tatsächliche Serveraufforderung, abgelaufene Autorisierung oder ausdrückliche Abmeldung behält das übliche Anmelde- und Zugangsdatenstatusverhalten.

Öffnen Sie Werkzeuge für Schemas und Werkzeugbeschreibungen. Prüfen Sie redigierte Diagnoseereignisse auf der Serverseite oder über die CLI.

Ressourcenfähigkeiten verwenden die gemeinsamen Werkzeuge list_mcp_resources, list_mcp_resource_templates und read_mcp_resource. Der Status meldet resources_advertised, prompts_advertised und server_capabilities; die alten Aktivierungs-, Zustands- und Zählfelder für Ressourcen/Prompts sowie Konfigurationsschalter sind abgeschafft. Eingaben, Bereitstellung und Ausgabeverhalten sind unter Ressourcen und Vorlagen beschrieben.

Aktivierte Server mit Codemode- oder verzögerter Erkennung erscheinen auch in einer begrenzten Prompt-Zusammenfassung mcp_servers. Die konfigurierte Beschreibung hat Vorrang vor der ersten Zeile verfügbarer Serveranweisungen. Ein Server kann aufgeführt sein, während er noch verbindet; ausschließlich direkte, ausschließlich verborgene und deaktivierte Server werden ausgelassen.

Das Speichern einer Beschreibung oder Ändern der Bereitstellung schreibt den Prompt des aktiven Laufs nicht um. Die Zusammenfassung wird beim Start jedes Laufs erfasst und mit dem nächsten Prompt aktualisiert. Siehe Serverzusammenfassungen.

CLI

anyy mcp add docs --command mcp-docs --exposure codemode
anyy mcp add remote --url https://example.com/mcp --auth '{"provider":"provider-id"}'
anyy mcp configure docs --exposure deferred
anyy mcp set docs description 'Documentation tools'
anyy mcp set docs toolExposure '{"read*":"deferred","*":"hidden"}'
anyy mcp test docs
anyy mcp status --json
anyy mcp show docs
# Only if the current docs server advertises this name and schema:
anyy mcp call docs.search --args '{"query":"Anyy"}'
anyy mcp disable docs
anyy mcp remove docs

add speichert standardmäßig einen aktivierten, erst bei Bedarf verbundenen Server. Mit --disable speichern Sie ihn deaktiviert. Die Konfiguration führt keine Werkzeugauswahl-Rückfragen aus und erfordert keinen Verbindungstest.

Die alten globalen Einstellungen mcp.client.enabled, tools.include, tools.exclude, tools.trusted, --include und --activate-toolset sind abgeschafft und werden abgelehnt. Stellen Sie die Konfiguration auf die Bereitstellungsfelder um. Über RPC werden geordnete Überschreibungen als JSON-Zeichenfolge tool_exposure übertragen und zum einzelnen geordneten Konfigurationswert toolExposure.

Fehlerbehebung

Problem	Nächster Schritt
Ein aktivierter Server bleibt nicht verfügbar	Prüfen Sie Protokolle und führen Sie anyy mcp test SERVER_ID aus
Die Konfiguration wird abgelehnt	Prüfen Sie typisierte Felder und entfernen Sie abgeschaffte Selektoren
OAuth benötigt Aufmerksamkeit	Führen Sie anyy mcp login SERVER_ID aus
Ein Werkzeug fehlt	Prüfen Sie Serveraktivierung, Bereitstellung und Erkennungswerkzeuge
Ein lokaler Prozess startet nicht	Prüfen Sie Befehl, Argumente und Umgebung