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 vilket transportalternativ som passar för användningsplatsen.
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 hela den 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 nåbar via publik DNS;
- besvara en giltig MCP
initialize-handshake; - ha en explicit uppsättning tillåtna verktyg.
Lokala adresser, privata nätverksadresser och cloud metadata-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. Den här knappen ser du bara om du har MCP-åtkomst.
- Titta först på de tillgängliga presets.
- 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 Admin → AI-inställningar → Verktyg → MCP också registrera en server för hela miljön.
Autentisering och secrets
AI-School stöder connector-OAuth och statiska secrets. OAuth-tokens, refresh tokens, API-nycklar och lösenord lagras i server-only storage. En chatt får bara den registrerade connectorId, aldrig den hemliga konfigurationen.
Vid en ändrad URL eller autentisering kontrolleras den nya konfigurationen först igen. Om kontrollen misslyckas kan en tidigare godkänd konfiguration förbli aktiv tills problemet är löst.
Verktygsrättigheter
Ge bara åtkomst till de verktyg som användarna faktiskt 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 server-side allowlist, men serveradministratören är fortfarande ansvarig för lämpliga scopes och auktorisering.
Testa lokalt
Du testar en lokal stdio-server i desktopappen. Rendererprocessen får inte starta vilka shellkommandon som helst: installation sker via en godkänd preset eller den säkra desktopflödet. Kommando, argument, environmentkeys och begärd åtkomst visas före installation.
Felsökning
- Endpointen kan inte nås: kontrollera HTTPS, DNS, brandvägg och hela
/mcp-sökvägen. - Återanslutning krävs: förnya OAuth-behörigheten eller det sparade secret.
- Tillhör en annan miljö: registrera connectorn på nytt inom den aktuella miljön.
- Inga verktyg syns: kontrollera verktygs-allowlist, din MCP-åtkomst och om servern är aktiv.
- Fungerar bara på desktop: servern använder sannolikt stdio eller en lokal adress.
Utvecklingsresurser
Se även
Vid redigering hämtas den registrerade serverkonfigurationen. Den sparade nyckeln förblir dold: lämna nyckelfältet tomt för att behålla den. Vid en annan URL eller autentiseringsmetod krävs återanslutning. Ett fel i ett enskilt MCP-verktyg betyder inte att alla verktyg från den servern är otillgängliga.