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)
Wo in der App
Abschnitt betitelt „Wo in der App“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.
Beziehungen
Abschnitt betitelt „Beziehungen“| 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 |
Zustände
Abschnitt betitelt „Zustände“| 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.
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- 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.