Koppeling met AI-clients (IDE-integratie)
ServBay kan de ingebouwde MCP Server in één klik koppelen aan jouw favoriete AI-clients. De juiste MCP-configuratie wordt automatisch geschreven, waardoor je handmatig bewerken niet nodig is. In dit document lees je hoe je de koppeling maakt, welke clients worden ondersteund en de specifieke verbindingsmethodes.
Vereisten
- ServBay is geïnstalleerd en actief.
- De gewenste AI-client is geïnstalleerd (ServBay bepaalt op basis van de configuratie of koppelen mogelijk is).
Eén-klik koppeling
Ga naar ServBay Settings → IDE Integrations (AI-clientintegratie), zoek in de lijst de gewenste client en klik op Integrate (Koppelen). ServBay zal dan:
- Het
servbay-mcpuitvoerbare bestand lokaliseren dat met de distributie is meegeleverd (apart installeren is niet nodig). - De MCP-configuratie toevoegen of bijwerken volgens de specificaties van de geselecteerde client (enkel het
servbay-onderdeel wordt aangepast, jouw andere MCP-configuraties blijven intact). - De verbindingsstatus tonen.
Wil je de koppeling verwijderen, klik dan eenvoudig op Remove (Verwijderen).
Verbindingsstatus
Elke client toont de status van de koppeling met deze lokale ServBay-installatie:
| Status | Betekenis |
|---|---|
| Gekoppeld | De client verwijst naar het lokale servbay-mcp van deze ServBay-installatie |
| Gekoppeld (ander pad) | De client heeft wel servbay geconfigureerd, maar verwijst naar een ander pad (bijvoorbeeld een andere ServBay-installatie) |
| Niet gekoppeld | De client is gevonden, maar nog niet gekoppeld |
| Niet gevonden | De client is niet op deze machine aangetroffen |
Ondersteunde clients en verbindingsmethodes
| Client | Verbindingsmethode | Configuratielocatie |
|---|---|---|
| Claude Code | Officiële CLI: claude mcp add --scope user --transport stdio servbay -- <bin> | Claude Code gebruikers-MCP-configuratie |
| Codex | Officiële CLI: codex mcp add (indien CLI niet beschikbaar, schrijf naar ~/.codex/config.toml) | Codex-configuratie |
| Cursor | Schrijf naar ~/.cursor/mcp.json (bovenste niveau mcpServers) | ~/.cursor/mcp.json |
| VS Code / GitHub Copilot | Schrijf naar gebruikersniveau mcp.json (bovenste niveau servers, type: stdio) | Gebruikersniveau VS Code mcp.json |
| Claude Desktop | Schrijf naar claude_desktop_config.json (bovenste niveau mcpServers) | claude_desktop_config.json |
Verschillen in configuratieschema
Verschillende clients hanteren verschillende bovenliggende sleutels in hun MCP-configuratie: VS Code gebruikt servers, terwijl Cursor / Claude Desktop gebruikmaken van mcpServers. ServBay schrijft automatisch de juiste sleutel volgens de specificaties van elke client; je hoeft hier zelf niet op te letten.
Koppeling verifiëren
Start na het koppelen een request gericht op je ontwikkelomgeving vanuit de betreffende AI-client (bijvoorbeeld: “Toon de momenteel draaiende diensten van ServBay”). Kan de AI daadwerkelijk de juiste servicelijst retourneren, dan is de koppeling geslaagd.
Veelgestelde vragen (FAQ)
- Vraag: Overschrijft koppelen mijn bestaande MCP-configuratie?
- Antwoord: Nee. ServBay voegt alleen het
servbay-onderdeel toe of werkt het bij, jouw andere MCP Servers blijven behouden.
- Antwoord: Nee. ServBay voegt alleen het
- Vraag: Wat als de client ‘Niet gevonden’ weergeeft?
- Antwoord: Op deze machine is de betreffende client niet gevonden. Installeer en start de client eerst, en probeer vervolgens opnieuw te koppelen.
- Vraag: Mislukt de AI-aanroep na het koppelen?
- Antwoord: Controleer of ServBay actief is. Voor Claude Code / Codex via CLI: verifieer dat de officiële CLI werkt. Probeer eventueel het verwijderen en opnieuw koppelen.
- Vraag: Wat wordt aanbevolen na koppelen?
- Antwoord: Installeer de AI-regels om de AI te sturen ServBay MCP te gebruiken, en zo het maximale eruit te halen.
Samenvatting
Met “AI-clientintegratie” kun je ServBay MCP in één klik verbinden met populaire AI-tools, zonder handmatige configuratie of verlies van bestaande instellingen. Na koppeling en installatie van de AI-regels kan de AI jouw lokale ontwikkelomgeving soepel beheren.
