Zum Inhalt springen

Referenz & Datenmodell

MCP-Server (agent_mcp_server)

Ein MCP-Server verbindet Aligia AI mit einem externen System, dessen Funktionen als Tools erscheinen.

MCP (Model Context Protocol) ist ein Standard, über den ein externes System seine Funktionen für KI bereitstellt. Der Datensatz hält Adresse, Verbindungszustand, Verbindungsrichtlinie und die Freigabe für Polaris. Die Tools selbst sind eigene Datensätze, siehe MCP-Tool. (Datenart: Konfiguration)

Aligia AI › Agenten › MCP Servers. Liste mit Status, Endpunkt, Tools und Agenten. Detailseite mit Statusbadge, Kacheln „Tools“, „Agents“, „Zuletzt synchronisiert“, dem Bereich „Authentication“, dem Schalter „In Polaris verwenden“, den „Tool-Berechtigungen“ und „Von Agenten verwendet“. Siehe Guides › MCP Servers und Guides › Externes Tool per MCP anbinden.

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Name name Text ja Anzeigename –
Beschreibung description Text nein Freitext –
Endpunkt endpoint Text ja HTTPS-Adresse des Servers Nur im Anlage-Dialog; der Bearbeiten-Dialog ändert nur Name und Beschreibung
Status status Auswahl ja Verbindungszustand, siehe Zustände System
Zuletzt synchronisiert last_synced_at Datum nein Letzter abgeschlossener Prüfversuch System
Letzter Fehler last_error Text nein Grund des letzten Fehlers System; Tooltip am Badge
Anmeldeart auth_kind Auswahl nein static, oauth oder leer System; gesetzt von der Konto-Oberfläche; zeigt „Über OAuth verbunden“
OAuth-Verfügbarkeit auth_availability Auswahl nein Ob der Endpunkt OAuth anbietet System; zeigt „OAuth optional“ / „OAuth erforderlich“
Verbindungsrichtlinie connection_policy Auswahl ja „Organisationsverbindung“ (tenant), „Persönliche Verbindungen erlaubt“ (personal), „Persönlich oder Organisation“ (personal_or_tenant), „Keine Anmeldedaten“ (anonymous) System; nur über die Konto-Oberfläche änderbar; Standard personal_or_tenant
In Polaris verwenden polaris Ja/Nein ja Polaris darf die „Allow“-Tools nutzen Standard Nein

Nicht sichtbar und daher nicht dokumentiert: Tool-Zusammenfassung, Tool-Set-Hash, Zugangsdaten-Generation, Richtlinien-Version.

Zu Art Pflicht Beim Archivieren Beim Löschen
MCP-Tool hat viele nein – mitgelöscht
Agent (agent_mcp_server_map) n:m nein – Zuordnung mitgelöscht
Wert Label Bedeutung
disconnected Noch nicht synchronisiert Anfangszustand
syncing Wird überprüft… Prüfung läuft („Jetzt prüfen“ oder Zugangsdaten gespeichert)
connected Katalog verfügbar Erreichbar, Tools abgerufen und abgeglichen
auth_required Authentifizierung erforderlich Erreichbar, verlangt Anmeldung; Tools unverändert
unreachable Fehler Netzwerk/DNS/Timeout; stündlich erneut versucht
invalid_url Fehler Endpunkt nicht zulässig (kein HTTPS, keine öffentliche Adresse)
error Fehler Erreichbar, aber keine gültige MCP-Antwort

Alle Werte setzt ausschließlich der Synchronisierungs-Workflow.

  • Zugangsdaten werden nie in Aligia gespeichert oder angezeigt. „Verbinden“, „Ersetzen“ und „Verwalten“ führen in die separate Konto-Oberfläche.
  • Polaris und Agenten nutzen einen Server nur im Status „Katalog verfügbar“.
  • Ob neue Server Polaris automatisch freigeben, regelt eine Vorgabe in Guides › Einstellungen › Arbeitsbereich.

MCP-Tool · Agent · Organisationseinstellungen