Ga naar hoofdinhoud

MCP Server

Open in ChatGPT

De webforJ Model Context Protocol (MCP) server biedt AI-assistenten directe toegang tot officiële webforJ-documentatie, geverifieerde codevoorbeelden en specifieke patronen voor frameworks, wat reacties met nauwkeurigere antwoorden mogelijk maakt, en automatische projectgeneratie specifiek voor webforJ-ontwikkeling.

Wat is een MCP?​

Model Context Protocol is een open standaard die AI-assistenten in staat stelt om verbinding te maken met externe tools en documentatie. De webforJ MCP-server implementeert dit protocol om te voorzien in:

  • Kenniszoektocht - Zoekopdracht in natuurlijke taal in webforJ-documentatie, codevoorbeelden en patronen
  • Projectgeneratie - Maak webforJ-toepassingen vanaf officiële sjablonen met een juiste structuur
  • Thema's maken - Genereer toegankelijke CSS-thema's volgens webforJ-ontwerpatronen

Waarom MCP gebruiken?​

Hoewel AI-codingassistenten uitblinken in het beantwoorden van basisvragen, hebben ze moeite met complexe webforJ-specifieke vragen die meerdere documentatie-secties bestrijken. Zonder directe toegang tot officiële bronnen kunnen ze:

  • Methoden genereren die niet bestaan in webforJ
  • Verwijzen naar verouderde of onjuiste API-patronen
  • Code leveren die niet compileert
  • WebforJ-syntaxis verwarren met andere Java-frameworks
  • WebforJ-specifieke patronen verkeerd begrijpen

Met MCP-integratie zijn AI-antwoorden verankerd in de daadwerkelijke webforJ-documentatie, codevoorbeelden en frameworkpatronen, wat verifieerbare antwoorden met directe links naar officiële bronnen voor diepere verkenning mogelijk maakt.

AI kan nog steeds fouten maken

Hoewel MCP de nauwkeurigheid aanzienlijk verbetert door toegang te bieden tot officiële webforJ-bronnen, garandeert het geen perfecte codegeneratie. AI-assistenten kunnen nog steeds fouten maken in complexe scenario's. Verifieer altijd de gegenereerde code en test grondig voordat je deze in productie gebruikt.

Installatie​

De webforJ MCP-server is gehost op https://mcp.webforj.com met twee eindpunten:

  • MCP-eindpunt (/mcp) - Voor Claude, VS Code, Cursor
  • SSE-eindpunt (/sse) - Voor legacy clients

Gebruik het Claude CLI-commando om de server te registreren:

claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user

Dit configureert automatisch de MCP-server in je Claude Code-omgeving.

Beschikbare tools​

Tools zijn gespecialiseerde functies die de MCP-server biedt aan AI-assistenten. Wanneer je een vraag stelt of een verzoek doet, kan de AI deze tools aanroepen om documentatie te doorzoeken, projecten te genereren of thema's te maken. Elke tool accepteert specifieke parameters en retourneert gestructureerde gegevens die de AI helpen om nauwkeurige, contextbewuste assistentie te bieden.

Deze tool biedt semantische zoekmogelijkheden door het hele webforJ-documentatie-ecosysteem. Het begrijpt de context en relaties tussen verschillende frameworkconcepten en retourneert relevante documentatiedelen, API-referenties en werkende codevoorbeelden.

Voorbeeldvragen:

"Zoek webforJ documentatie voor Button-component met voorbeeldiconen"

"Vind webforJ formulier validatiepatronen in de nieuwste documentatie"

"Toon me de huidige webforJ routeringssetup met de @Route-annotatie"

"Zoek webforJ-documenten voor FlexLayout responsieve ontwerppatronen"

"Vind de integratie van het webforJ-webcomponent in de officiële documentatie"

Scaffold complete webforJ-toepassingen met behulp van officiële Maven-archetypen. De tool maakt een gestandaardiseerd projectdirectory-indeling en bevat startercode op basis van de geselecteerde sjabloon. Gegenerateerde projecten omvatten een kant-en-klare build-systeem, resource-mappen en configuratiebestanden voor onmiddellijke ontwikkeling en implementatie.

Voorbeeldprompts:

"Maak een webforJ-project genaamd CustomerPortal met het hello-world-archetype"

"Genereer een webforJ Spring Boot-project met tabbladindeling genaamd Dashboard"

"Maak een nieuwe webforJ-app met het sidemenu-archetype voor het AdminPanel-project"

"Genereer een webforJ blanco project genaamd TestApp met com.example groupId"

"Maak webforJ-project InventorySystem met sidemenu-archetype met Spring Boot"

Bij het gebruik van deze tool kun je kiezen uit verschillende projecttemplates:

Archetypes (projecttemplates):

  • hello-world - Basisapp met voorbeeldcomponenten om webforJ-functies te demonstreren
  • blank - Minimale projectstructuur voor het beginnen vanaf nul
  • tabs - Vooraf gebouwde tabbladinterface-indeling voor applicaties met meerdere weergaven
  • sidemenu - Indeling met zij-navigatiemenu voor beheerderspanelen of dashboards

Flavors (frameworkintegratie):

  • webforj - Standaard webforJ-app
  • webforj-spring - webforJ geïntegreerd met Spring Boot voor afhankelijkheidsinjectie en enterprise-functies
Beschikbare Archetypes

webforJ komt met verschillende vooraf gedefinieerde archetypes om je snel op weg te helpen. Voor een complete lijst van beschikbare archetypes, zie de archetypes catalogus.

Genereert webforJ-thema-configuraties met behulp van DWC HueCraft. De tool genereert complete sets van CSS-aangepaste eigenschappen met primaire, secundaire, succes-, waarschuwing-, gevaar- en neutrale kleurvarianten.

Voorbeeldverzoeken:

"Genereer een webforJ-thema met HSL 220, 70, 50 als primaire kleur voor ons bedrijfsmerk"

"Maak webforJ-toegankelijk thema genaamd 'ocean' met primaire kleur #0066CC"

"Genereer een webforJ-thema met onze merkkleur #FF5733"

"Maak een webforJ-thema met HSL 30, 100, 50 genaamd 'sunset' voor onze app"

"Genereer toegankelijke webforJ-thema met primaire RGB 44, 123, 229"

Beschikbare prompts​

Prompts zijn vooraf geconfigureerde AI-instructies die meerdere tools en workflows combineren voor veelvoorkomende taken. Ze begeleiden de AI door specifieke stappen en parameters om betrouwbare, herhaalbare resultaten te leveren voor elke ondersteunde workflow.

Argumenten:

  • appName (vereist) - Toepassingsnaam (bijv. MyApp, TodoList, Dashboard)
  • archetype (vereist) - Kies uit: blank, hello-world, tabs, sidemenu
  • runServer (optioneel) - Voer automatisch de ontwikkelserver uit (ja/nee)

Argumenten:

  • primaryColor (vereist) - Kleur in hex (#FF5733), rgb (255,87,51) of hsl (9,100,60) formaat

De prompt configureert de AI om:

  1. De kennisbasis uitgebreid te doorzoeken
  2. Compleet, productieklaar code te schrijven
  3. Het project te samenstellen met mvn compile om te verifiëren dat er geen bouwfouten zijn
  4. Fouten iteratief te corrigeren totdat alles werkt

Hoe prompts te gebruiken​

  1. Typ / in de chat om beschikbare prompts te zien
  2. Selecteer een prompt uit het dropdownmenu
  3. Vul de vereiste parameters in wanneer daarom wordt gevraagd

Best practices​

Om de meest nauwkeurige en actuele webforJ-assistentie te krijgen, volg je deze richtlijnen om optimaal gebruik te maken van de functies van de MCP-server.

Zorgen voor gebruik van de MCP-server​

AI-modellen kunnen de MCP-server overslaan als ze denken dat ze het antwoord al weten. Om ervoor te zorgen dat de MCP-server daadwerkelijk wordt gebruikt:

  • Wees expliciet over webforJ: Vermeld altijd "webforJ" in je vraag om framework-specifieke zoekopdrachten te activeren
  • Vraag om actuele informatie: Voeg zinnen toe zoals "laatste webforJ-documentatie" of "huidige webforJ-patronen"
  • Vraag om geverifieerde voorbeelden: Vraag om "werkende webforJ-codevoorbeelden" om een documentatie-opzoeking af te dwingen
  • Verwijs naar specifieke versies: Vermeld je webforJ-versie (bijv. "webforJ 25.02") om nauwkeurige resultaten te krijgen

Schrijf specifieke prompts​

Goede voorbeelden:

"Doorzoek webforJ-documentatie naar Button-component eventafhandeling met voorbeelden"

"Maak een webforJ-project genaamd InventorySystem met het sidemenu-archetype met Spring Boot"

"Genereer een webforJ-thema met HSL 220, 70, 50 als primaire kleur voor bedrijfsmerk"

Slechte voorbeelden:

"Hoe werken knoppen"

"Maak een app"

"Maak het blauw"

Forceer gebruik van de MCP-tool​

Als de AI algemene antwoorden geeft zonder de MCP-server te gebruiken:

  1. Vraag expliciet aan: "Gebruik de webforJ MCP-server om te zoeken naar [query]"
  2. Vraag om documentatiereferenties: "Vind in webforJ-documenten hoe te [query]"
  3. Vraag om verificatie: "Verifieer deze oplossing aan de hand van de webforJ-documentatie"
  4. Wees framework-specifiek: Vermeld altijd "webforJ" in je vragen

AI-aanpassing​

Configureer je AI-assistenten zodat ze automatisch de MCP-server gebruiken en de beste praktijken van webforJ volgen. Voeg project-specifieke instructies toe, zodat je AI-assistenten altijd de MCP-server gebruiken, de webforJ-documentatiestandaarden volgen en nauwkeurige, actuele antwoorden geven die aansluiten bij de vereisten van je team.

Projectconfiguratiebestanden​

  • Voor VS Code en Copilot, maak .github/copilot-instructions.md
  • Voor Claude Code, maak CLAUDE.md in je projectroot

Voeg het volgende toe aan het gemaakte markdown-bestand:

## Gebruik de webforJ MCP-server om webforJ-vragen te beantwoorden

- Roep altijd de "webforj-knowledge-base" tool aan om relevante documentatie op te halen
- Verifieer alle API-handtekeningen tegen de officiële documentatie
- Neem nooit aan dat methodenamen of parameters bestaan zonder te controleren

Verifieer altijd of de code compileert met `mvn compile` voordat je suggesties doet.

FAQ​

De meeste AI-assistenten hebben expliciete instructies nodig om MCP-servers te gebruiken. Configureer je AI-client met de instructies uit de AI-aanpassings sectie. Zonder deze instructies kunnen AI-assistenten terugvallen op hun trainingsgegevens in plaats van de MCP-server te raadplegen.

Snelle oplossing: Voeg "gebruik webforJ MCP" toe aan je prompt of maak het juiste configuratiebestand aan (.github/copilot-instructions.md of CLAUDE.md).

Gebruik de MCP-inspecteur om verbindingen te debuggen:

npx @modelcontextprotocol/inspector

Wacht op het bericht: 🔍 MCP Inspector is up and running at http://127.0.0.1:6274 (poort kan variëren)

Voer vervolgens in de inspecteur:

  1. Voer de MCP-server-URL in: https://mcp.webforj.com/mcp
  2. Klik op "Verbinden" om de verbinding tot stand te brengen
  3. Bekijk beschikbare tools en testquery's
  4. Houd verzoek/antwoordlogs in de gaten voor debugging

De webforJ MCP-server biedt twee eindpunten:

  • MCP-eindpunt (/mcp) - Modern protocol voor Claude, VS Code, Cursor
  • SSE-eindpunt (/sse) - Server-Sent Events voor legacy clients zoals Windsurf

De meeste gebruikers moeten het MCP-eindpunt gebruiken. Gebruik SSE alleen als je client het standaard MCP-protocol niet ondersteunt.

Ja, maar het is niet aanbevolen. Zonder configuratiebestanden moet je de AI handmatig vragen om de MCP-server in elke conversatie te gebruiken. Configuratiebestanden instrueren de AI automatisch om de MCP-server te gebruiken voor elke interactie, zodat je de instructies niet elke keer hoeft te herhalen.

Handmatige aanpak: Begin prompts met: "Gebruik de webforJ MCP-server om..."

Alternatief: Gebruik vooraf geconfigureerde prompts De MCP-server biedt prompts die werken zonder configuratiebestanden:

  • /create-app - Genereer nieuwe webforJ-toepassingen
  • /create-theme - Maak toegankelijke CSS-thema's
  • /search-webforj - Geavanceerde documentatiezoekopdracht

Zie Beschikbare prompts voor details.

Problemen melden: webforJ MCP Feedback

Veel voorkomende problemen om te melden:

  • Verouderde documentatie in zoekresultaten
  • Ontbrekende API-methoden of componenten
  • Onjuiste codevoorbeelden
  • Fouten bij de uitvoering van tools

Voeg je vraag, verwachte resultaat en feitelijke resultaat toe bij het melden van problemen.