Gå till huvudinnehållet

Lägga till en egen MCP-server

Med en egen MCP-server kopplar du AI-Public till ett ärendehanteringssystem, arkiv, datakälla eller annan specialiserad tjänst. Välj först vilket transportläge som passar vid användningsplatsen.

Välj rätt transport​

TransportWebMobilDesktopAnvändning
Streamable HTTPJaJaJaRekommenderas för hostade servrar
stdioNejNejJaLokala processer och desktopintegrationer
SSEEndast befintliga konfigurationerEndast befintliga konfigurationerJaFöråldrad transport; välj Streamable HTTP för nya servrar

Krav för Streamable HTTP​

Använd hela det publika endpointet, inklusive MCP-sökvägen, till exempel:

https://mcp.organisatie.nl/mcp

Endpointet måste använda HTTPS, vara nåbart via publik DNS utan omdirigering och svara på ett giltigt MCP initialize-handshake. Användarnamn och lösenord får inte ingå i URL:en. Lokala adresser, privata nätverksadresser och cloudmetadata-endpoints blockeras.

Lägga till en server​

  1. Öppna Inställningar → Tools.
  2. Välj Lägg till Tools eller Lägg till MCP-server. Den här knappen ser du bara om du har MCP-åtkomst.
  3. Granska de tillgängliga presets.
  4. Välj Lägg till en egen MCP-server.
  5. Fyll i namn, fullständigt endpoint och autentiseringsmetod.
  6. Spara konfigurationen och vänta på anslutningskontrollen.
  7. Slå på servern för din standardverktygsuppsättning.

En administratör kan registrera en server för hela miljön via Administration → Tools → MCP.

Autentisering och secrets​

AI-Public stöder connector-OAuth och statiska secrets. OAuth-token, refresh tokens, API-nycklar och lösenord lagras endast på serversidan. En chatt får bara den registrerade connectorId, aldrig den hemliga konfigurationen.

Vid en ändrad URL eller autentisering kontrolleras den nya konfigurationen först på nytt. Om den kontrollen misslyckas kan en tidigare godkänd konfiguration förbli aktiv tills problemet är löst.

Rättigheter för tools och informationssäkerhet​

Ge bara tillgång till de tools som användarna faktiskt behöver. En MCP-server kan erbjuda både läs- och skrivåtgärder. AI-Public filtrerar upptäckta tools mot en server-side allowlist och kontrollerar miljö, ägare och roll vid varje användning. Organisationen ansvarar för lämpliga scopes, loggning, gallringsfrister och auktorisering i källsystemet.

Lokala desktopservrar​

En lokal stdio-server installerar du i desktopappen. Kommando, argument, miljövariabler och begärd åtkomst begränsas och visas innan godkännande. Secrets krypteras lokalt.

Felsökning​

  • Endpointet kan inte nås: kontrollera HTTPS, DNS, brandvägg och hela /mcp-sökvägen.
  • Återanslutning krävs: förnya OAuth-samtycke eller det sparade secretet.
  • Tillhör en annan miljö: registrera connectorn på nytt inom den aktuella miljön.
  • Inga tools syns: kontrollera allowlist, rollåtkomst och aktiv status.
  • Fungerar bara på desktop: servern använder troligen 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 ny koppling. Ett fel i ett enda MCP-tool betyder inte att alla tools på den servern blir otillgängliga.