1. CADCraft — Permanent Setup

Enable automatic control on port 7979:

flatpak override --user \
  --share=network \
  --env=CADCRAFT_CONTROL_PORT=7979 \
  ai.storyteller.cadcraft

Register MCP server in Codex:

codex mcp add cadcraft -- \
  flatpak run --share=network \
  --command=cadcraft-cli \
  ai.storyteller.cadcraft \
  mcp --connect 127.0.0.1:7979

2. PhotoCraft — Permanent Setup

Create authentication directory and workspace:

mkdir -p "$HOME/.var/app/ai.storyteller.photocraft/config"
mkdir -p "$HOME/Pictures/Photocraft"

Enable automatic control on port 7878, token authentication and filesystem access:

flatpak override --user \
  --share=network \
  --env=PHOTOCRAFT_CONTROL_PORT=7878 \
  --env=PHOTOCRAFT_CONTROL_TOKEN_FILE="$HOME/.var/app/ai.storyteller.photocraft/config/photocraft-control.token" \
  --filesystem="$HOME/Pictures/Photocraft" \
  --env=PHOTOCRAFT_AUTOMATION_READ_ROOT="$HOME/Pictures/Photocraft" \
  --env=PHOTOCRAFT_AUTOMATION_WRITE_ROOT="$HOME/Pictures/Photocraft" \
  ai.storyteller.photocraft

Register MCP server in Codex:

codex mcp add photocraft -- \
  flatpak run \
  --command=photocraft-cli \
  ai.storyteller.photocraft \
  mcp --bridge 127.0.0.1:7878 \
  --control-token-file "$HOME/.var/app/ai.storyteller.photocraft/config/photocraft-control.token"

3. Verification

List registered MCP servers:

codex mcp list

Check active control ports:

ss -ltn | grep -E ':7979|:7878'

Inspect Flatpak overrides:

flatpak override --show --user ai.storyteller.cadcraft
flatpak override --show --user ai.storyteller.photocraft

4. Remove MCP Integration

Remove both servers from Codex:

codex mcp remove cadcraft
codex mcp remove photocraft

Reset Flatpak overrides:

flatpak override --user --reset ai.storyteller.cadcraft
flatpak override --user --reset ai.storyteller.photocraft

Warning: --reset removes ALL user-defined Flatpak overrides for the specified application, not just MCP settings. It does not uninstall the application.

Optionally delete the PhotoCraft authentication token:

rm -f "$HOME/.var/app/ai.storyteller.photocraft/config/photocraft-control.token"

5. Daily Usage

Open CADCraft or PhotoCraft normally from the application launcher, then start Codex:

codex

MCP connections are configured globally and persist across restarts. No manual control-server startup is required.