Connecting Claude Desktop

Connecting to Claude Desktop

This connects Claude Desktop to the FICSIT Foreman MCP server so Claude can answer Satisfactory production questions using real game data.

Claude Desktop talks to MCP servers over stdio (it launches a command). There are two ways to wire it up — pick one.

Where the config file lives

Open Claude Desktop → Settings → Developer → Edit Config (this opens claude_desktop_config.json), or edit it directly:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

If the file is empty, start from { "mcpServers": {} } and add the entry below.

---

Option A — connect to the running Docker container (recommended)

Use this if you already run the server in Docker (HTTP on :8723). Because Claude Desktop only speaks stdio, a small bridge — mcp-remote — forwards stdio to the HTTP endpoint. Requires Node.js installed (for npx).

1. Make sure the container is up: docker compose up -d (or your docker run), then check http://localhost:8723/health.

2. Add to claude_desktop_config.json:

   {
     "mcpServers": {
       "ficsit-foreman": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "http://localhost:8723/mcp"]
       }
     }
   }

3. Fully quit and reopen Claude Desktop.

---

Option B — let Claude Desktop run it (stdio, no separate server)

Use this if you'd rather not keep a container running or install Node.js. Claude Desktop launches the image on demand over stdio. Requires Docker installed.

{
  "mcpServers": {
    "ficsit-foreman": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT=stdio", "ghcr.io/stuartmeeks/foreman-sf-mcp:latest"]
    }
  }
}

This spawns a fresh container each session (the graph rebuilds on launch — a few seconds) and does not use a long-running HTTP container. To pick the experimental channel, add "-e", "SATISFACTORY_GAME_CHANNEL=experimental" to args.

---

Verify

After restarting, the FICSIT Foreman tools appear under the tools/plug icon in the Claude Desktop message box. Try asking:

Using FICSIT Foreman, what raw resources do I need for 5 Reinforced Iron Plate per minute?

Claude should call total_raw_inputs and answer 60 Iron Ore/min.

Troubleshooting

• Tools don't appear: fully quit and reopen Claude Desktop; check the JSON is valid (no trailing commas); confirm the server/container is running.
• Option A errors: ensure Node.js is installed (npx -v) and http://localhost:8723/health responds.
• Option B errors: ensure Docker is running and the image pulls (docker pull ghcr.io/stuartmeeks/foreman-sf-mcp:latest).

See Troubleshooting for more.