Legg 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 hvilket transportlag som passer der den skal brukes.
Velg riktig transport
| Transport | Web | Mobil | Desktop | Bruk |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Anbefales for hostede servere |
| stdio | Nei | Nei | Ja | Lokale prosesser og desktopintegrasjoner |
| SSE | Bare eksisterende konfigurasjoner | Bare eksisterende konfigurasjoner | Ja | Utdatert transport; velg Streamable HTTP for nye servere |
Krav for Streamable HTTP
Bruk det fullstendige 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 med et 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 nettappen.
Legg til en server
- Åpne Innstillinger → Verktøy.
- Velg Legg til verktøy eller Legg til MCP-server. Denne knappen ser du bare hvis du har MCP-tilgang.
- Se først på de tilgjengelige forhåndsinnstillingene.
- Velg Legg til en egen MCP-server.
- Fyll inn navn, fullstendig endepunkt og autentiseringsmetode.
- Lagre konfigurasjonen og vent på tilkoblingskontrollen.
- Slå på serveren for standardverktøysettet ditt.
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 i server-only storage. En chat mottar bare den registrerte connectorId, aldri den hemmelige konfigurasjonen.
Ved endret URL eller autentisering blir den nye konfigurasjonen kontrollert på nytt først. Hvis kontrollen mislykkes, kan en tidligere godkjent konfigurasjon forbli aktiv til problemet er løst.
Verktøyrettigheter
Gi bare tilgang til de verktøyene 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 de oppdagede verktøyene mot server-side allowlist, men serveradministratoren er fortsatt ansvarlig for riktige scopes og autorisasjon.
Lokal testing
En lokal stdio-server tester du i desktopappen. Renderer-en får ikke starte vilkårlige shell-kommandoer: installasjon skjer via en godkjent forhåndsinnstilling eller den sikre desktopflyten. Kommando, argumenter, environment keys og forespurt tilgang vises før installasjon.
Feilsøking
- Endepunkt ikke tilgjengelig: sjekk HTTPS, DNS, brannmur og den fullstendige
/mcp-stien. - Ny tilkobling kreves: forny OAuth-tillatelsen eller det lagrede secretet.
- Hører til et annet miljø: registrer connectoren på nytt i det gjeldende miljøet.
- Ingen verktøy synlige: sjekk verktøy-allowlisten, MCP-tilgangen din og om serveren er aktiv.
- Fungerer bare på desktop: serveren bruker sannsynligvis stdio eller en lokal adresse.
Utviklingsressurser
Se også
Ved redigering hentes den registrerte serverkonfigurasjonen. Den lagrede nøkkelen forblir skjult: la nøkkelfeltet stå tomt for å beholde den. Ved en annen URL eller autentiseringsmetode er ny kobling nødvendig. En feil i ett MCP-verktøy betyr ikke at alle verktøy fra den serveren er utilgjengelige.