Reference & Data Model
MCP server (agent_mcp_server)
An MCP server connects Aligia AI to an external system whose functions appear as tools.
Purpose
Section titled “Purpose”MCP (Model Context Protocol) is a standard through which an external system exposes its functions to AI. The record holds the address, connection state, connection policy and the release for Polaris. The tools themselves are separate records, see MCP tool. (Data type: configuration)
Where in the app
Section titled “Where in the app”Aligia AI › Agenten › MCP Servers. List with status, endpoint, tools and agents. Detail page with status badge, tiles „Tools“, „Agents“, „Zuletzt synchronisiert“ (Last synced), the „Authentication“ section, the toggle „In Polaris verwenden“ (Use in Polaris), the „Tool-Berechtigungen“ (Tool permissions) and „Von Agenten verwendet“ (Used by agents). See Guides › MCP servers and Guides › Connect an external tool via MCP.
Fields
Section titled “Fields”| Field | Technical | Type | Required | Meaning | Notes |
|---|---|---|---|---|---|
| Name | name |
Text | yes | display name | – |
| Description | description |
Text | no | free text | – |
| Endpoint | endpoint |
Text | yes | HTTPS address of the server | creation dialog only; the edit dialog changes only name and description |
| Status | status |
Selection | yes | connection state, see States | System |
| Last synced | last_synced_at |
Date | no | last completed check attempt | System |
| Last error | last_error |
Text | no | reason of the last error | System; tooltip on the badge |
| Auth kind | auth_kind |
Selection | no | static, oauth or empty |
System; set by the account interface; shows „Über OAuth verbunden“ (Connected via OAuth) |
| OAuth availability | auth_availability |
Selection | no | whether the endpoint offers OAuth | System; shows „OAuth optional“ / „OAuth erforderlich“ (OAuth required) |
| Connection policy | connection_policy |
Selection | yes | „Organisationsverbindung“ (Organization connection, tenant), „Persönliche Verbindungen erlaubt“ (Personal connections allowed, personal), „Persönlich oder Organisation“ (Personal or organization, personal_or_tenant), „Keine Anmeldedaten“ (No credentials, anonymous) |
System; changeable only via the account interface; default personal_or_tenant |
| Use in Polaris | polaris |
Yes/No | yes | Polaris may use the „Allow“ tools | default no |
Not visible and therefore not documented: tool summary, tool set hash, credential generation, policy version.
Relations
Section titled “Relations”| Related to | Kind | Required | On archive | On delete |
|---|---|---|---|---|
| MCP tool | has many | no | – | deleted along |
Agent (agent_mcp_server_map) |
n:m | no | – | mapping deleted along |
States
Section titled “States”| Value | Label | Meaning |
|---|---|---|
disconnected |
Noch nicht synchronisiert (Not yet synced) | initial state |
syncing |
Wird überprüft… (Checking…) | check running („Jetzt prüfen“ (Check now) or credentials saved) |
connected |
Katalog verfügbar (Catalog available) | reachable, tools fetched and reconciled |
auth_required |
Authentifizierung erforderlich (Authentication required) | reachable, requires login; tools unchanged |
unreachable |
Fehler (Error) | network/DNS/timeout; retried hourly |
invalid_url |
Fehler (Error) | endpoint not allowed (no HTTPS, no public address) |
error |
Fehler (Error) | reachable, but no valid MCP response |
All values are set exclusively by the sync workflow.
Rules & automation
Section titled “Rules & automation”- Credentials are never stored or displayed in Aligia. „Verbinden“ (Connect), „Ersetzen“ (Replace) and „Verwalten“ (Manage) lead to the separate account interface.
- Polaris and agents use a server only in status „Katalog verfügbar“.
- Whether new servers are automatically released for Polaris is governed by a default in Guides › Settings › Workspace.