Protected ReadonlyconfigurationProtected ReadonlyeditorReadonlyidA unique id of this handler.
Protected ReadonlyinstallProtected ReadonlymessageProtected ReadonlypreferenceProtected Optional ReadonlyregistryProtected ReadonlywindowTest whether this handler can open the given URI for given options. Return a nonzero number if this handler can open; otherwise it cannot. Never reject.
A returned value indicating a priority of this handler.
ProtectedconfirmAcknowledge prompt for already-installed servers. We don't try to be clever about "is this the same registry entry?" - the user may have edited the local config and any overwrite should be an explicit decision.
ProtectedextractProtectedisTrue if a server with this name is already in ai-features.mcp.mcpServers.
Open a widget for the given URI and options.
Resolve to an opened widget or undefined, e.g. if a page is opened.
Never reject if canHandle return a positive number; otherwise should reject.
Handles
theia://install-mcp?id=<serverId>deep links. The URL is intentionally minimal: the install configuration, version, display name and content hash are all read from the configured AI registry by id. This guarantees the user installs exactly what the registry currently publishes and keeps install links short and stable.Opening such a link brings the IDE window to the foreground, reveals the AI registry (Extensions) view with the
serverIdsearched so the entry is in focus, and then opens the install dialog for that entry.Lives in
@theia/ai-mcpso products without the registry package still receive the URL - but installation only succeeds when anMCPRegistryUiBridgeis bound and the id exists in the registry. The bridge is consulted via@optional().