Skip to content

Reference & Data Model

MCP server (agent_mcp_server)

An MCP server connects Aligia AI to an external system whose functions appear as tools.

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)

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.

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.

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
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.

  • 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.

MCP tool · Agent · Organization settings