Slå på AI-klienter

AI-klienter som Claude Code ansluter till plattformen via MCP på https://api.example.com/mcp och agerar som den person som loggar in — se Anslut en AI-klient. Gränssnittet är avslaget tills en plattformsadministratör slår på det. För att ändra det krävs kernel/mcpSettings/manage på plattformens rot, som Platform Owner och Platform Contributor har.

Slå på eller av gränssnittet

Öppna Inställningar → Plattformsinställningar och fliken AI clients, och använd Enable the MCP interface for this platform. Ändringen sparas direkt.

När det är påslaget kan alla som kan logga in i portalen ansluta en klient, med exakt sina egna behörigheter. Att slå av det stoppar anslutna klienter inom ungefär femton sekunder; servern svarar då på varje MCP-anrop med 404 och mcp_disabled.

Tills någon har använt reglaget säger fliken att värdet kommer från plattformens konfiguration (Mcp:Enabled, avslaget om inte en operatör har satt det). Att använda reglaget sparar ett beslut som konfigurationen inte längre åsidosätter.

Låt klienter registrera sig

De flesta AI-klienter kan inte få ett klient-ID i förväg, så de registrerar ett själva när de ansluter första gången: Claude Code, opencode, den allmänna konfigurationen under Konfigurationsfil på installationssidan och Claude Desktops egna koppling. Bara bryggkonfigurationerna — Codex och Claude Desktops konfigurationsfil — loggar in med den färdiga klienten som beskrivs under Installationsinställningar och registrerar inte.

En registrering avvisas om inte varje adress som den skulle skicka tillbaka användaren till ligger på en värd i Hosts allowed to register a client. Listan är tom från början, så tills du lägger till värdar kan bara bryggkonfigurationerna logga in. Lägg till:

• localhost och 127.0.0.1 för klienter som körs på användarens dator, till exempel Claude Code och opencode. De skickar tillbaka användaren till en lokal adress, och vilken av de två de använder beror på klienten.
• claude.ai för Claudes hostade klienter, till exempel Claude Desktops koppling.

En värd i listan låter alla klienter som skickar tillbaka användare till den värden registrera sig, inte bara den du tänkte på.

Ange en värd per rad — en inklistrad URL kortas till sin värd — och välj Save hosts. Listan sparas i plattformens identitetsleverantör och inte i dess databas; för att skriva den måste plattformens RBAC-tjänst ha rollen manage-realm där.

Installationsinställningar

Inställning	Standard	Betydelse
Mcp:Enabled	false	Om gränssnittet är påslaget — bara tills någon använder reglaget på fliken
Mcp:PublicBaseUrl	tom	Den publika adress som servern annonserar för klienter. Tom hämtas den från proxyns vidarebefordrade headers; sätt den när din proxy inte skickar dem
Mcp:SelfBaseUrl	http://localhost:8080	Var serverns verktyg anropar plattformens API inifrån API-processen
Mcp:DocumentationUrl	sätts av installern till https://portal.example.com/help/ai-clients	Installationssidan som annonseras för klienter

Ange dem som miljövariabler för plattformens API, till exempel Mcp__PublicBaseUrl.

Bryggkonfigurationerna på installationssidan — Codex, och Claude Desktops konfigurationsfil — loggar in med Keycloak-klienten stackship-mcp, som installern skapar när den sätter upp Keycloak på en ny installation. Klienten godtar omdirigeringar vid inloggning till http://127.0.0.1 och http://localhost, plus adresserna i installationsinställningen platform.mcpRedirectUris.