MCP-sovelluksen määrittäminen
Lisää MCP-sovelluksen asetukset application.properties-tiedostoon tai webforj.conf-tiedostoon käytettäessä standardia webforJ-asetusta. Määritä osoite, josta asiakas voi käyttää sovellusta, ja lisää sitten vain ne asiakas- ja selaimen alkuperät, joita käyttöönotto vaatii.
Aseta sovelluksen alkuperä
webforj.origin on julkinen alkuperä, jota käytetään sovelluksen resurssissa, sisältöturvapolitiikassa ja webforJ-komponentin URL-osoitteissa. Paikallisessa testauksessa se on sovelluksen osoite:
webforj.origin=http://localhost:8080
Kun tunneli tai käänteinen välityspalvelin altistaa sovelluksen, käytä julkista alkuperää, johon MCP-asiakas voi päästä:
webforj.origin=https://example.trycloudflare.com
Älä sisällytä /mcp tähän ominaisuuteen. Polku kuuluu MCP-pisteeseen, ei sovelluksen alkuperään.
Salli upottava asiakas
webforj.mcp.allowed-origins ohjaa, mitkä selainalkuperät voivat tehdä ristiin-origin-pyyntöjä ja upottaa näkymän. Paikallista MCPJam -selainta, joka toimii edustavassa alkuperässä http://127.0.0.1:6274, varten käytä:
webforj.mcp.allowed-origins=http://127.0.0.1:6274
Käytä alkuperää, joka näkyy asiakkaan selaimen osoitepalkissa, koska paikalliset työkalut voivat valita eri portin. Tunnelin osoite ei ole sallittu asiakasalkuperä; se kuuluu webforj.origin-kohtaan.
webforJ sallii jo tunnetut Codex-sovelluksen ja Claude Desktop -hiekkalaatikon alkuperäkaavat. Lisää tämä ominaisuus vain toiselle asiakasalkuperälle. Villikorttia, kuten https://*.example.com, käytetään isäntätunnisteiden vastaamiseen, ei satunnaisen URL-tekstin.
Salli ulkoiset resurssit ja yhteydet
Upotettu kehys alkaa rajoitetulla sisältöturvapolitiikalla. Lisää resource-domains, kun käyttöliittymän on ladattava skripti, tyyli, kuva, fontti tai muu selainresurssi toisesta alkuperästä:
webforj.mcp.resource-domains=https://cdn.example.com
Lisää connect-domains, kun kehyksen selainkoodin on yhdistettävä ulkoiseen API:hin, WebSocketiin tai vastaavaan päätepisteeseen:
webforj.mcp.connect-domains=https://api.example.com
Nämä ominaisuudet laajentavat sitä, mitä upotettu kehys voi ladata tai kontaktoida. Ne eivät salli toisen asiakkaan upottaa sovellusta; käytä siihen allowed-origins.
Määritä standardi käyttöönotto
Spring Boot lukee nämä arvot application.properties-tiedostosta. Standardissa servlet-käyttöönottossa käytetään webforj.conf-tiedostoa vastaavilla arvoilla:
webforj.origin = "https://app.example.com"
webforj.mcp.allowed-origins = ["https://assistant.example.com"]
webforj.mcp.resource-domains = ["https://cdn.example.com"]
webforj.mcp.connect-domains = ["https://api.example.com"]
Lisää vain ne alueet, joita sovellus tarvitsee. Asiakkaan testaus näyttää, mistä löytää paikallisen asiakasalkuperän ja milloin julkista sovelluksen alkuperää tarvitaan.
Connecting webforJ to your stack?
Ask the team about your libraries, services, and build.
Jatka oppimista
ArtikkeliSpring Boot MCP server: tools plus a live UI in webforJ
ArtikkeliMCP Apps in Java: show a webforJ UI inside AI chat
ArtikkeliMCP app in plain Java: no Spring Boot required
ArtikkeliMigrate a Java desktop app to the web with AI: a decision guide
ArtikkeliHow to test a Java MCP App without an AI host
ArtikkeliMCP server for Java developers: webforJ setup guide