Skip to main content

MCP — beállítás és konfiguráció

Settings → MCP fül​

A Beállítások MCP füle (settings-page.tsx) mutatja:

  • Engine állapot — csatlakozva / nincs, motor-verzió.
  • HTTP végpont — http://127.0.0.1:<port>/mcp, a port a GET /api/v1/health mcpPort mezőjéből (a valódi, esetleg fallback port).
  • Nagy, színes státusz-banner egy élő /health poll-ból (listening / disabled / no-project / port-in-use).
  • MCP token — másolás gombbal.
  • export CRAFTINGTABLE_MCP_TOKEN=… sor és a feloldott tokennel beilleszthető kliens-konfig.
  • Tool-lista — 8 olvasó + 28 író/generáló.
Képernyőkép — Settings → MCP fül

(A képernyőkép pótlása folyamatban.)

A generált .mcp.json​

A projekt gyökerébe generált fájl a fix HTTP transportra mutat:

{
  "mcpServers": {
    "craftingtable": {
      "type": "http",
      "url": "http://127.0.0.1:8420/mcp",
      "headers": { "Authorization": "Bearer ${CRAFTINGTABLE_MCP_TOKEN}" }
    }
  }
}

A .mcp.json verziózható a projekt repójában, mert nem tartalmaz titkot — a tokenre a CRAFTINGTABLE_MCP_TOKEN környezeti változón keresztül hivatkozik.

A stabil token​

A fő REST API --token-je indulásonként véletlenszerű. Az MCP-nek ezért külön, stabil tokenje van:

  • Az Electron a központi DB-ben tárolja (app-db.ts getMcpToken()), és minden engine-indításnál átadja (--mcp-token flag → app.go withMCPAuth).
  • Így a verziózott .mcp.json a CRAFTINGTABLE_MCP_TOKEN env-változóra hivatkozhat.

Ez a vírushatás mechanizmusa: a csapattársnak a klón után csak a token env-változót kell beállítania — a Settings → MCP fül mutatja a pontos értéket és az export sort.

# a Settings → MCP fülről másolva
export CRAFTINGTABLE_MCP_TOKEN="ct_mcp_xxxxxxxxxxxxxxxxxxxxxxxx"

stdio változat (alternatíva)​

Ha inkább a rövid életű stdio processzt akarod (nincs futó Electron app):

{
  "mcpServers": {
    "craftingtable": {
      "command": "craftingtable-engine",
      "args": ["mcp", "--project", "/abszolut/ut/a/projekthez"]
    }
  }
}

Ez minden indításkor egyszer olvassa be a fájlokat — ha közben a UI-ban szerkesztesz, a stdio szerver elavul. Futó app mellett a HTTP transport az ajánlott.

Biztonsági megjegyzés​

A :8420/mcp végpont HTTP-szinten loopback-kötött (127.0.0.1). Token nélkül (--mcp-token üres) bárki, aki a gépen fut, eléri — ez dev-only. Éles használatban az Electron mindig ad stabil tokent. Részletek: Architektúra → Biztonság.