Tilføj en egen MCP-server
Med en egen MCP-server forbinder du AI-School med en egen applikation, datakilde eller specialiseret tjeneste. Vælg først det transportlag, der passer til brugerstedet.
Vælg det rigtige transportlag
| Transport | Web | Mobil | Desktop | Brug |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Anbefales til hostede servere |
| stdio | Nej | Nej | Ja | Lokale processer og desktop-integrationer |
| SSE | Kun eksisterende konfigurationer | Kun eksisterende konfigurationer | Ja | Forældet transport; vælg Streamable HTTP til nye servere |
Krav til Streamable HTTP
Brug det fulde offentlige endpoint, inklusive MCP-stien, for eksempel:
https://mcp.example.nl/mcp
Endpointet skal:
- bruge HTTPS;
- fungere uden brugernavn eller adgangskode i URL'en;
- ikke kræve redirect;
- være tilgængeligt via offentlig DNS;
- svare på et gyldigt MCP
initialize-handshake; - have et eksplicit sæt tilladte tools.
Lokale adresser, private netværksadresser og cloudmetadata-endpoints bliver blokeret. Derfor kan du ikke registrere en server på localhost fra webappen.
Tilføj en server
- Åbn Indstillinger → Tools.
- Vælg Tilføj tools eller Tilføj MCP-server. Denne knap ser du kun, hvis du har MCP-adgang.
- Se først de tilgængelige presets.
- Vælg Tilføj selv en MCP-server.
- Udfyld navn, fuldt endpoint og autentificeringsmetode.
- Gem konfigurationen, og vent på forbindelsestesten.
- Slå serveren til for dit standardværktøjssæt.
En administrator kan også registrere en server for hele miljøet via Admin → AI-indstillinger → Tools → MCP.
Autentificering og secrets
AI-School understøtter connector-OAuth og statiske secrets. OAuth-tokens, refresh tokens, API-nøgler og adgangskoder gemmes i server-only storage. En chat modtager kun det registrerede connectorId, aldrig den hemmelige konfiguration.
Ved en ændret URL eller autentificering bliver den nye konfiguration først tjekket igen. Hvis den kontrol mislykkes, kan en tidligere godkendt konfiguration forblive aktiv, indtil problemet er løst.
Tool-tilladelser
Giv kun adgang til de tools, som brugerne faktisk har brug for. En MCP-server kan tilbyde både læse- og skrivehandlinger, såsom at slette filer, sende e-mail eller ændre records. AI-School filtrerer de opdagede tools mod server-side allowlist, men serveradministratoren er fortsat ansvarlig for passende scopes og autorisation.
Lokal test
En lokal stdio-server tester du i desktop-appen. Renderer må ikke starte vilkårlige shellkommandoer: installation sker via en godkendt preset eller den sikre desktop-flow. Kommando, argumenter, environmentkeys og den adgang, der anmodes om, vises før installation.
Fejlfinding
- Endpoint ikke tilgængeligt: tjek HTTPS, DNS, firewall og den fulde
/mcp-sti. - Genforbindelse påkrævet: forny OAuth-tilladelse eller det gemte secret.
- Hører til et andet miljø: registrer connectoren igen i det aktuelle miljø.
- Ingen tools synlige: tjek tool-allowlist, din MCP-adgang, og om serveren er aktiv.
- Virker kun på desktop: serveren bruger sandsynligvis stdio eller en lokal adresse.
Udviklingsressourcer
Se også
Ved redigering hentes den registrerede serverkonfiguration. Den gemte nøgle forbliver skjult: lad nøglefeltet være tomt for at bevare den. Ved en anden URL eller autentificeringsmetode kræves der genforbindelse. En fejl i ét MCP-tool betyder ikke, at alle tools fra den server er utilgængelige.