MCP szerver — áttekintés
A Craftingtable beépített MCP (Model Context Protocol) szervert ad, ami az AI ágensnek
(Claude Code, Cursor, Copilot, Antigravity) nem az egész projektet adja át, hanem
tool-hívásokra válaszolva pontosan a kért feladat kontextusát. A hivatalos
github.com/modelcontextprotocol/go-sdk-ra épül (nem hand-rolled JSON-RPC).
Az MCP egy kimeneti csatorna a több közül. Aki soha nem indít AI ágenst, annak is teljes értékű a termék.
Két transport, ugyanaz a logika
| Transport | Cím / parancs | Mikor |
|---|---|---|
| stdio | craftingtable-engine mcp --project <path> | Rövid életű processz projektenként. A .mcp.json stdio változatának célja. |
| streamable HTTP | http://127.0.0.1:8420/mcp | Amikor az engine már fut (az Electron --mode=embedded mindig felhúzza). Fix, előre ismert port. |
Miért fix port a HTTP-nél: hogy bármelyik helyi MCP-kliens kapcsolódni tudjon anélkül,
hogy előbb az Electron folyamattól kellene portot/tokent kérnie — ugyanúgy, ahogy pl. az
Ollama is fix porton (:11434) szolgál ki mindenkit helyben.
Miért a HTTP a .mcp.json célja (2026-09-02 óta): a HTTP transport a futó app élő
workspace-ét osztja, így az MCP-ből végzett szerkesztés azonnal konzisztens a felülettel. A
stdio processz ezzel szemben induláskor egyszer olvassa be a fájlokat, és utána elavul.
Feltétel: az Electron app fut közben (solo workflow-ban ez adott).
Ha a 8420-as port foglalt (már fut egy másik Craftingtable-példány), az engine naplóz,
8421–8429 között próbálkozik, és a fő API-t érintetlenül futtatja tovább. A stdio út ilyenkor
is működik. A /health a valódi portot és státuszt jelenti (mcpPort, mcpStatus).
Két eszközcsoport
- Olvasó tool-ok (8) — mindkét transporton. A specifikáció és a Work Package-ek fogyasztása.
- Író / generáló tool-ok (28) — csak a token-védett HTTP transporton hatásosak. Az
AI-kliens nem csak fogyaszthat, hanem a specifikációt is építheti. Minden wrapper ugyanazon
a
workspacemetóduson megy át, mint a UI és a REST — azonos validáció, ID-generálás, kanonikus JSON, kereszt-szinkron.
Teljes lista: Tool-referencia.
A token-ablak védelme
- Semmilyen tool nem ad vissza teljes projektet. Nincs
dump_project. - A
list_*tool mindig csak azonosítót és címet ad — a tartalomért külön hívás kell (get_task_context).
MCP be/ki kapcsolás
A Settings.mcpEnabled kapcsoló (Beállítások → MCP fül) letiltja az MCP-t — ilyenkor az
engine --mcp-port=0-val indul újra. Alapból be van kapcsolva.