Legge til en egen MCP-server
Med en egen MCP-server kobler du AI-School til en egen applikasjon, datakilde eller spesialisert tjeneste. Velg først hvilken transport som passer til bruksstedet.
Velg riktig transport
| Transport | Web | Mobil | Desktop | Bruk |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Anbefalt for hostede servere |
| stdio | Nei | Nei | Ja | Lokale prosesser og desktopintegrasjoner |
| SSE | Kun eksisterende konfigurasjoner | Kun eksisterende konfigurasjoner | Ja | Utdatert transport; velg Streamable HTTP for nye servere |
Krav til Streamable HTTP
Bruk hele det offentlige endepunktet, inkludert MCP-stien, for eksempel:
https://mcp.example.nl/mcp
Endepunktet må:
- Bruke HTTPS;
- fungere uten brukernavn eller passord i URL-en;
- ikke kreve redirect;
- være tilgjengelig via offentlig DNS;
- svare på en gyldig MCP
initialize-handshake; - ha et eksplisitt sett med tillatte verktøy.
Lokale adresser, private nettverksadresser og cloudmetadata-endepunkter blokkeres. Derfor kan du ikke registrere en server på localhost fra webappen.
Legge til en server
- Åpne Preferanser → Verktøy.
- Velg Legg til verktøy eller Legg til MCP-server.
- Se først på tilgjengelige forhåndsinnstillinger.
- Velg Legg til egen MCP-server.
- Fyll inn navn, fullstendig endepunkt og autentiseringsmetode.
- Lagre konfigurasjonen og vent på tilkoblingskontrollen.
- Slå på serveren for ditt standard verktøysett.
En administrator kan også registrere en server for hele miljøet via Administrasjon → AI-innstillinger → Verktøy → MCP.
Autentisering og secrets
AI-School støtter connector-OAuth og statiske secrets. OAuth-tokens, refresh tokens, API-nøkler og passord lagres kun på serveren. En chat mottar kun den registrerte connectorId, aldri den hemmelige konfigurasjonen.
Ved endring av URL eller autentisering blir den nye konfigurasjonen først kontrollert på nytt. Hvis kontrollen feiler, kan en tidligere godkjent konfigurasjon forbli aktiv til problemet er løst.
Verktøyrettigheter
Gi kun tilgang til verktøy brukerne faktisk trenger. En MCP-server kan tilby både lese- og skrivehandlinger, som å slette filer, sende e-post eller endre poster. AI-School filtrerer oppdagede verktøy mot server-side allowlist, men serveradministratoren er fortsatt ansvarlig for passende scopes og autorisasjon.
Lokal testing
En lokal stdio-server tester du i desktopappen. Renderen kan ikke starte vilkårlige shell-kommandoer: installasjonen skjer via en godkjent forhåndsinnstilling eller den sikre desktopflyten. Kommando, argumenter, miljøvariabler og forespurt tilgang vises før installasjon.
Feilsøking
- Endepunkt ikke tilgjengelig: sjekk HTTPS, DNS, brannmur og hele
/mcp-stien. - Krever ny tilkobling: forny OAuth-tillatelse eller lagret secret.
- Hører til et annet miljø: registrer connector på nytt i gjeldende miljø.
- Ingen verktøy synlige: sjekk verktøy-allowlist, MCP-tilgang og at serveren er aktiv.
- Fungerer kun på desktop: sannsynligvis bruker serveren stdio eller en lokal adresse.
