Mit MCP verbinden

Prüfen Sie die Verfügbarkeit, bevor Sie einen Client verbinden.

Gehostete Verbindungen

Cloud MCP verwendet https://mcp.altifigence.com/cloud-mcp mit Streamable HTTP und OAuth. Siehe Verfügbarkeit und Client-Qualifikation, bevor Sie einen Client konfigurieren.

  1. Fügen Sie den exakten Endpunkt in den Einstellungen Ihres Clients für Remote-MCP-Verbindungen hinzu.

  2. Schließen Sie die Account-Anmeldung ab und prüfen Sie auf der Zustimmungsseite die Organisation und angeforderten Cloud-Berechtigungen. Der Client verwaltet die OAuth-Zugangsdaten.

  3. Initialisieren Sie die Verbindung und aktualisieren Sie die Werkzeugliste des Clients. Nur aktuell erlaubte Cloud-Werkzeuge werden angezeigt.

  4. Lesen Sie mit Leseberechtigung zuerst Ihre Identität und Projektliste. Verwenden Sie eine zurückgegebene Projekt-ID für Projekt- und Dateizugriffe; Dateizugriffe benötigen einen bereiten Workspace.

  5. Fordern Sie für Projekt-, Datei-, Einstellungs- oder Git-Änderungen https://mcp.altifigence.com/cloud.write an und erteilen Sie eine neue Zustimmung. Ihre Organisation muss jedes Werkzeug ausdrücklich erlauben. Lesen Sie die aktuellen Projekt- und Dateirevisionen, bevor Sie gespeicherte Dateien ändern; prüfen Sie nach einer unsicheren Änderungsantwort den Zustand, bevor Sie einen neuen Versuch erwägen.

  6. Fordern Sie für Laufzeit-Lebenszyklus, Terminalaktionen oder Jobs die Berechtigung https://mcp.altifigence.com/cloud.execute an und erteilen Sie eine neue Zustimmung. Die Analyse von gespeichertem RTL in Cloud ist für Kunden noch nicht freigeschaltet. Siehe Werkzeug-Workflows. Die Verfügbarkeit hängt vom Dienstrelease und der Laufzeit- und Werkzeugrichtlinie Ihrer Organisation ab.

  7. Fordern Sie für persönliche KI-Verbindungen nur die erforderlichen KI-Bereiche aus Kontosicherheit an, holen Sie die Organisationsfreigabe für Werkzeuge ein und erteilen Sie eine neue Zustimmung. Verwenden Sie die zurückgegebene sichere Einrichtungs-URL, damit der Benutzer einen Anbieterschlüssel direkt in Cloud eingeben kann. Prüfen Sie gewählten Anbieter, Modell, Kontext und mögliche Kosten, bevor Sie eine KI-Antwort anfordern.

Neue Werkzeugnamen benötigen eine neue Zustimmung, auch neue Werkzeuge innerhalb einer bestehenden Berechtigung. Das Aktualisieren eines alten Tokens fügt sie nicht hinzu. Das in der Console ausgewählte Projekt gewährt keine Autorisierung. Ein Wechsel der autorisierten Organisation erfordert neue Zustimmung. Eine Leseanfrage startet kein gestopptes Projekt. Fügen Sie der Verbindungskonfiguration keine Kontotoken, Browser-Cookies oder KI-Anbieterschlüssel hinzu.

Falls Initialisierung oder Autorisierung scheitern, verwenden Sie Fehlerbehebung. Weichen Sie nicht darauf aus, Protokollanfragen an das Stammverzeichnis einer Website oder ein anderes Profil zu senden.

Installierte Software

Verwende für lokale XLS-Werkzeuge die verifizierte Linux-CLI mit ALTI_MCP_MODE=local-xls. Hinweise zur Einrichtung findest du unter CLI. Dieser Modus verwendet keine Auftragsweiterleitung an die Cloud des Kunden. Siehe MCP-Überblick für den Unterschied zwischen lokalen und gehosteten Verbindungen.

Den ersten Lesezugriff prüfen

  1. Bitten Sie den Client, das verbundene Altifigence-Konto und die Organisation zu lesen.

  2. Listen Sie zugängliche Projekte auf und wählen Sie eine zurückgegebene Projekt-ID.

  3. Lesen Sie den Zustand des ausgewählten Projekts. Falls ein Dateizugriff nicht verfügbar ist, prüfen Sie in Cloud das ausgewählte Projekt, den Zugriff und den aktuellen Speicher-/Dienststatus. Das Starten einer Laufzeit ist eine separate Ausführungsaktion; gewöhnlicher Zugriff auf gespeicherte Dateien erfordert keinen Start einer persönlichen Laufzeit.

  4. Listen Sie Dateien auf und wählen Sie einen zurückgegebenen Pfad. Lesen Sie den vollständigen Inhalt und folgen Sie bei Bedarf den Fortsetzungs-Offsets.

  5. Bitten Sie um eine Zusammenfassung mit Projekt, Pfad und gespeicherter Revision. Vergleichen Sie sie mit Cloud, bevor Sie die Verbindung für größere Arbeiten verwenden.

Beispielanfrage: „Liste meine Altifigence-Cloud-Projekte auf. Lies die README im von mir gewählten Projekt, fasse dann die Einrichtungsschritte zusammen und benenne die verwendete gespeicherte Datei.“ Dies funktioniert innerhalb des veröffentlichten Lesebereichs und macht das Ziel explizit.