Setup ng Unity MCP

Unawain ang editor bridge

Ikinokonekta ng CoplayDev/unity-mcp ang MCP client sa server at package sa panig ng editor. Hiwalay na dependency ang model service. Dinodokumento ng project ang mga tool para sa scene, script, asset, at test, ngunit hindi ebidensya na gumagana sa project mo ang nakalistang capability.

Itala kung aling process ang may-ari ng bawat bahagi ng koneksyon. Mahalaga ito kapag naaabot ng client ang server ngunit hindi nito mapatakbo ang editor. Panatilihing magkahiwalay na setup check ang account credential, editor licensing, package compatibility, at model availability. Hindi maaayos ng model change ang mismatch ng editor instance.

Suriin ang installation path at pinning policy

Dinudokumento ng project installation guide ang pagdaragdag ng package nito sa pamamagitan ng Unity Package Manager at paggamit ng setup interface para i-configure ang server at client. Suriin ang nakasaad nitong Unity, Python, at uv prerequisite para sa napiling revision bago mag-install ng anuman.

Para sa reproducibility, panatilihin pagkatapos ng setup ang resolved package revision, editor version, server version, at dependency record. Discovery path lamang ang moving branch URL, hindi immutable experiment identity. Suriin ang download at package change bago ilapat sa existing game, at panatilihin ang dating gumaganang project state upang manatiling reversible ang connection experiment.

https://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity#main

Itugma ang lokal na HTTP endpoint sa client

Dinudokumento ng maintained installation guide ang lokal na HTTP example sa ibaba. Ipinapalagay nitong tumatakbo na ang server sa address na iyon. Kumpirmahin sa editor setup interface ang aktuwal na configured transport at address bago gamitin. Ang MCP URL ay hindi LLM API base URL.

Gamitin ang documented configuration format ng client mo. Magkakaiba ang root key o transport declaration ng ilang client, kaya hindi universal file na maaaring i-paste sa bawat agent ang generic mcpServers example. Panatilihing lokal ang server maliban kung kailangan ng hiwalay na nasuring remote setup, at huwag magdagdag ng model credential sa hindi kaugnay na editor connection.

{
  "mcpServers": {
    "unityMCP": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

Patunayan kung aling editor instance ang tumatanggap ng work

Buksan ang nilalayong project at siyasatin ang connection state sa package interface. Pagkatapos, gamitin ang natuklasang read operation ng client upang kunin ang project at scene context. Itugma ang impormasyong iyon sa lokal na project bago aprubahan ang edit. Lalong mahalaga ang gate na ito kapag maraming bukas na project.

Itala ang aktuwal na resource at tool schema mula sa naka-install na version. Huwag mag-imbento ng tool call mula sa pangalang naaalala sa ibang release. Tinutukoy ng kapaki-pakinabang na unang resulta ang inaasahang scene at existing object nang hindi binabago ang mga ito. Kung stale o malabo ang ibinalik na state, huminto at ayusin ang routing sa halip na magsagawa ng visible mutation upang tuklasin ang target.

Gawing unang miniflow ang reversible edit

Pumili ng disposable scene na pag-aari mo, itala ang initial state, at humingi ng isang simpleng pagbabago na may nakikitang epekto. Siyasatin ang saved scene at file diff, hintaying maging ready ang editor, at patakbuhin ang scene. Panatilihin ang naobserbahang behavior at anumang console error.

Pagkatapos, buksan muli ang scene upang kumpirmahing na-persist ang nilalayong pagbabago. Inihihiwalay nito ang in-memory editor effect sa saved project change. Panatilihing sapat na maliit ang flow upang ma-diagnose ang failure sa isang boundary: routing, mutation, compilation, execution, o persistence. Ibalik ang disposable scene pagkatapos ng review at gamitin ang naitalang gumaganang configuration para sa susunod na task.

I-troubleshoot muna ang transport bago ang game

Kapag hindi makakonekta ang client, i-verify ang configured URL at kung tumatakbo ang lokal na server. Kapag nagsisimula ang server ngunit wala ang editor, siyasatin ang package connection at editor log. Kapag nakakonekta ang nilalayong editor ngunit nawawala ang tool, siyasatin ang exposed tool group ng naka-install na version.

Pagkatapos lamang gumana ang boundary na iyon dapat i-diagnose ang compilation o gameplay. Panatilihing magkahiwalay ang log excerpt para sa client startup, server routing, editor readiness, at nabigong scene action. Dahil dito, maipapaliwanag ng report kung saan huminto ang execution sa halip na i-attribute ang bawat failure sa model o paulit-ulit na mag-install nang walang ebidensya.

Protektahan ang project laban sa malawak na automation

Maaaring baguhin ng editor connection ang scene, script, at asset. Limitahan ang unang experiment sa alam na directory at humingi ng review para sa operasyong nagde-delete ng resource, nagbabago ng dependency, o humahawak sa hindi kaugnay na scene. Panatilihin ang recoverable working state bago ang unang pagbabago.

Huwag ilantad sa publiko ang lokal na development service para lamang lutasin ang client configuration issue. Ituring na untrusted input ang third-party asset content at tool result, at ilayo ang credential sa shared log. Ang matagumpay na connection ay hindi pahintulot na mag-upload ng build o magbago ng store record. Hiwalay na workflow at authorization boundary ang publishing.

Ihanda ang reproducible connection record

Itala ang editor, project, package, at server revision, client version, transport, naobserbahang tool surface, at nakumpletong miniflow. Panatilihin ang eksaktong scene diff at runtime result. Sabihin kung nasuri o pending pa ang compilation, PlayMode behavior, test, at target export.

Sinusunod ng configuration na ito ang maintained project documentation; i-verify ito laban sa naka-install mong package at client. Para sa game production, magpatuloy sa Unity workflow guide at subukan ang kumpletong loop. Panatilihin sa handoff ang mga kilalang limitasyon upang maihiwalay ng ibang developer ang connection issue sa project problem at ma-reproduce ang parehong gumaganang setup.

Mga madalas itanong