# AspenFlow MCP setup

This connector runs Aspen Plus only on the user's Windows computer.

1. The user must first register at https://mcp.aspenflowsim.top/account/register with an invitation code.
2. Download https://mcp.aspenflowsim.top/downloads/internal/win/AspenFlow.Connector-internal-Setup.exe and let the user run it.
3. After installation, ask the user for their allowed Aspen-model directory, then run:

```powershell
$connector = "$env:LOCALAPPDATA\AspenFlow.Connector\current\AspenFlowConnector.exe"
& $connector pair --cloud-url "https://mcp.aspenflowsim.top"
codex mcp add aspenflow -- $connector mcp --allow-dir "D:\AspenModels"
```

The pair command shows a browser confirmation URL and code. Do not copy its DPAPI credentials to another Windows user or computer. Then add the following two lines inside the [mcp_servers.aspenflow] section of ~/.codex/config.toml:

```toml
startup_timeout_sec = 30
required = true
```

Restart Codex Desktop and start a new local Codex task. These settings make Codex wait for the packaged local connector before it builds the task tool list.