Lägg till en egen MCP-server
Med en egen MCP-server kopplar du AI-School till en egen applikation, datakälla eller specialiserad tjänst. Välj först vilken transport som passar platsen för användning.
Välj rätt transport
| Transport | Webb | Mobil | Desktop | Användning |
|---|---|---|---|---|
| Streamable HTTP | Ja | Ja | Ja | Rekommenderas för hostade servrar |
| stdio | Nej | Nej | Ja | Lokala processer och desktopintegrationer |
| SSE | Endast befintliga konfigurationer | Endast befintliga konfigurationer | Ja | Föråldrad transport; välj Streamable HTTP för nya servrar |
Krav för Streamable HTTP
Använd den fullständiga publika endpointen, inklusive MCP-sökvägen, till exempel:
https://mcp.example.nl/mcp
Endpointen måste:
- Använda HTTPS;
- fungera utan användarnamn eller lösenord i URL:en;
- inte kräva omdirigering;
- vara tillgänglig via publik DNS;
- svara på en giltig MCP
initialize-handshake; - ha en explicit uppsättning tillåtna verktyg.
Lokala adresser, privata nätverksadresser och cloudmetadata-endpoints blockeras. Därför kan du inte registrera en server på localhost från webbappen.
Lägg till en server
- Öppna Inställningar → Verktyg.
- Välj Lägg till verktyg eller Lägg till MCP-server.
- Titta först på tillgängliga förinställningar.
- Välj Lägg till en egen MCP-server.
- Fyll i namn, fullständig endpoint och autentiseringsmetod.
- Spara konfigurationen och vänta på anslutningskontrollen.
- Aktivera servern för din standardverktygsuppsättning.
En administratör kan via Administration → AI-inställningar → Verktyg → MCP också registrera en server för hela miljön.
Autentisering och hemligheter
AI-School stödjer connector-OAuth och statiska hemligheter. OAuth-token, refresh-token, API-nycklar och lösenord lagras i server-only lagring. En chatt får endast den registrerade connectorId, aldrig den hemliga konfigurationen.
Vid ändrad URL eller autentisering kontrolleras den nya konfigurationen först på nytt. Om kontrollen misslyckas kan en tidigare godkänd konfiguration förbli aktiv tills problemet är löst.
Verktygsrättigheter
Ge endast tillgång till de verktyg som användarna verkligen behöver. En MCP-server kan erbjuda både läs- och skrivåtgärder, som att ta bort filer, skicka e-post eller ändra poster. AI-School filtrerar de upptäckta verktygen mot serverns tillåtna lista, men serveradministratören ansvarar för lämpliga scopes och auktorisation.
Lokal testning
En lokal stdio-server testar du i desktopappen. Renderaren får inte starta godtyckliga shellkommandon: installation sker via en godkänd förinställning eller den säkra desktopflödet. Kommando, argument, miljövariabler och begärd åtkomst visas före installation.
Felsökning
- Endpoint inte tillgänglig: kontrollera HTTPS, DNS, brandvägg och hela
/mcp-sökvägen. - Behöver återansluta: förnya OAuth-behörighet eller sparad hemlighet.
- Tillhör en annan miljö: registrera om connectorn i den aktuella miljön.
- Inga verktyg syns: kontrollera verktygs-allowlist, din MCP-åtkomst och att servern är aktiv.
- Fungerar bara på desktop: servern använder troligen stdio eller en lokal adress.
