Settings
Configure external connections, agent models, scheduled wake-ups, installation authorization, and display language. Most useful after installation or when connections fail.
When to use Settings
Open it for initial connections or changes to how agents operate. Routine assignments do not require opening Settings.
- For external AI services such as Claude and ChatGPT to reach your center, use the External connections tab.
- To choose agent models, scheduled wake-ups, or reset thresholds, use LIVE and Wake-up tab.
- To authorize installation again or reconnect, use Gate tab.
- To change display language, use the field at the top of Settings labeled Language .
Layout
Open ⚙ Settings at the bottom of the sidebar system row. The language field is top right, with tabs below. Tabs are External connections, LIVE and Wake-up, AMC, and Gate. Some installation types also show AP.
assets/turtlecenter/ui-settings-1.png · Recommended size: 1600×900Top-right language field and External connections, LIVE and Wake-up, AMC, and Gate tabs.| Tab | Purpose | For regular users? |
|---|---|---|
| External connections | Create an internet tunnel into the center | Yes, for initial setup |
| LIVE and Wake-up | Per-agent models, wake-up schedules, and character reset thresholds | Yes, when changing operation |
| AMC | Check a fresh session and clear cookies | For diagnostics only |
| Gate | Authorize with an installation token and check connection state | Yes, during installation or reauthorization |
| AP | Register a protected key and model ID, check connections, and start/stop observation | Diagnostic; availability depends on installation |
Language
Type a language in the top-right field and press Enter to change the interface language. Supported languages are Korean and English. The field shows Korean or English.
| Item | Action | Effect | Note |
|---|---|---|---|
| Language field | Sets the center interface language. | Agents are also instructed to reply in that language until it changes again. | Unsupported input shows Not supported and leaves the language unchanged. |
External connections tab
Publishes the center's MCP address through an ngrok tunnel. External AI services connect through that address. The screen shows connection state and step-by-step diagnostic information.
assets/turtlecenter/ui-settings-2.png · Recommended size: 1600×900Status, token fields, four buttons, and diagnostic rows. Leave token values blank in the screenshot.Fields and buttons
| Item | Action | Effect | Note |
|---|---|---|---|
| ngrok authtoken | Enter the authtoken from your ngrok dashboard. | Save token and connect saves it and attempts connection immediately. | An ngrok API key or agent authentication token will not work here. Saved tokens are not displayed again. |
| Agent authentication token | Enter the external access token if the public endpoint requires authentication. | It first verifies authentication at the local endpoint, 127.0.0.1:5716. Only on success is it encrypted and stored for this Windows account. | Different from the ngrok authtoken. Leave blank to use the existing saved value. |
| Public domain (optional) | Specify the public domain you want to use. | Leave blank to use the address ngrok actually creates. | Enter only a domain, such as name.ngrok-free.dev, not /mcp. Invalid input shows Invalid public domain format. |
| Save token and connect | Saves the entered token and connects. | Successful connection changes status to Connected. | No automatic retries while processing. |
| Replace token | Replaces the saved token. | Reconnects using the new token. | The previous token cannot be restored, so prepare the new one first. |
| Test connection | Checks current connectivity. | Updates the diagnostic rows. | Does not change settings. |
| Disconnect | Closes external access. | External AI services can no longer reach the center. | Use Save token and connect to reconnect. |
Reading diagnostics
Rows follow the connection stages top to bottom. Start with the first abnormal row.
| Row | Normal | Abnormal |
|---|---|---|
| Connection status | Connected | Connecting · Not connected · Token not set · Authentication failed · Connection check failed · Credentials required |
| ngrok authentication | Configured · Value hidden | Not configured · Authentication failed |
| Public MCP URL | Externally reachable address displayed | Unavailable |
| ngrok installation | Installed · Path | Not installed, or only a WindowsApps alias found. Place ngrok.exe in C:\Program Files\ngrok or %ProgramData%\TurtleMcpEdge\Tools\ngrok. |
| Local MCP | Normal | No response: port not listening, connection refused, or timeout. The center's endpoint is not running. |
| ngrok Agent | Running | Not running, or service running but agent not responding |
| Tunnel status | Normal | Failed · No tunnel · Waiting for authentication |
| Provider response | - | ngrok account limit exceeded indicates the ngrok account's limit, not a center problem. |
| MCP authentication mode / Verification | No authentication or Authentication required, with verification passed | Credentials required · Unverified · Authentication failed |
| Required actions | None | Explained below |
When the public address changes
Required actions shows action codes when the public address changes. There are two:
NEEDS_EDGE_READINESS_URL_UPDATE: Change TurtleMcpEdge's--readiness-public-urlvalue to the current public MCP address.NEEDS_CONNECTOR_URL_UPDATE: Update the MCP address registered in your Claude or ChatGPT connector.
ngrok monitor
Counts external requests by agent over a selected period. Choose Start and End and click Refresh for per-agent calls, successes, failures, and average milliseconds. The newest 50 requests appear below with time, method, path, status, and duration. Select one to see request/response headers and bodies. Open Inspector launches ngrok's inspector. Automatic refresh is every five minutes. To be confirmed The monitor's exact tab location will be documented after checking the screen.
LIVE and Wake-up tab
Choose models, scheduled wake-ups, and character-count thresholds for context cleanup. A wake-up sends a configured message at a regular interval to help an agent continue work.
assets/turtlecenter/ui-settings-3.png · Recommended size: 1600×900Boss active checkbox and three reset thresholds above, per-agent table in the middle, Save settings below.Per-agent table
Each agent has a row. Only checked rows are saved. Hwayeon, Soram, and center agents each have a row.
| Column | Setting | Allowed values | Note |
|---|---|---|---|
| Target | Whether to apply this row, plus agent name | Checked / Unchecked | Unchecked agents are excluded from saving. |
| Interval (minutes) | How often to wake the agent | 1–10,080 minutes (seven days). New-row default: five minutes. | Very short intervals send signals with little pause. |
| Message | Text to send on wake-up | Required | An empty message cannot be saved. |
| Codex model | Model for the agent | Choose from the list reported by installed Codex | Only for center-agent rows; Hwayeon and Soram show —. Model settings are locked if the list cannot be loaded. |
| Reasoning level | How deeply the model reasons before answering | Choose from Codex's available list | Applies only to center agents. |
| Next run / Interval / Backoff | Read-only next wake time, actual interval, and current backoff stage | Configured · Adaptive 15m · Adaptive 30m · Adaptive 60m | Repeated failures automatically increase intervals to 15, 30, then 60 minutes, shown as adaptive stages. |
| Reset threshold (characters) | Per-agent character threshold for reset | At least 1 | Values come from the three fields above. |
The default model is gpt-5.6-sol; default reasoning level is medium. Used when no saved configuration exists.
Reset threshold (characters)
The reset threshold is compared with the cumulative characters injected into the agent's room. New-install defaults: Soram 150,000, Hwayeon 100,000, and Codex center agents 150,000 characters. The three fields above the table set Soram, Hwayeon, and Codex thresholds and populate matching rows. A count near the threshold means a long conversation. If the number is red or near the limit, consider resetting in the Agent room.
When an older Codex threshold is inconsistent or still at the old default, loading settings replaces it with 150,000 and reports Codex legacy threshold is inconsistent or uses the old default; applied new default 150,000. To be confirmed Whether reaching the threshold automatically resets the agent or only displays it will be documented after verification.
Night mode
Uncheck Boss active — Pause scheduled wake-ups and save to enter night mode. Night mode starts a fresh interval and does not replay missed runs afterward. With the checkbox enabled, scheduled wake-ups do not run.
Save
Changes take effect only after Save settings. Success shows Saved · N targets; failure shows Unable to save settings. Opening the tab shows N targets restored or No saved targets. Models become selectable after Loading installed Codex models… changes to Codex model list ready · N models.
AMC tab
A diagnostic screen for checking new agent sessions and clearing cookies. Choose an agent, use Agent_New session to begin verification, or Agent Clear cookies to clear its room cookies. Results show Agent: Result and the number of characters read from the room as DOM N characters.
- After 30 seconds, New session check exceeded 30 seconds. You may retry appears.
- Closing the window cancels an in-progress check.
- Clearing cookies may sign the room out. Use only when directed during diagnostics.
To be confirmed Affected agents and whether sign-in is needed afterward will be documented after checking.
Gate tab
Authorize this center with an installation token and view its authorization state. There is no editable server-address field. The authorization server is configured during installation.
assets/turtlecenter/ui-settings-4.png · Recommended size: 1600×900Status, installer ID, token, latest error, Connect, and Reconnect. Leave the token blank.| Item | Action | Note |
|---|---|---|
| Status | Shows the authorization stage. | See the table below. |
| Installer ID | Displays this center's installation identifier. | Read-only. |
| Installation token | Enter the token you received. | Input is masked and clears when authorization starts. Entering a new token and reconnecting replaces the existing registration. |
| Latest error | Most recent authorization failure reason. | None if there is no error. |
| Connect | Authorizes initially using the token. | Enabled only when a token is entered and registration is not yet complete. |
| Reconnect | Resumes an authorization session using saved registration. | With a new token, replaces registration; without one, reconnects using the saved registration. |
Status labels
| Display | Meaning | Action |
|---|---|---|
| Installation token required | Not yet authorized with a token. | Enter it and click Connect. |
| Authorizing / Checking saved authorization | Checking with the authorization server. | Wait briefly. |
| Authorized | Authorization confirmed. | AMC download follows. |
| Receiving AMC | Receiving shared context for agents. | Wait. |
| Authorized · AMC received | Normal state. | No action needed. |
| Authorization session expired | The session needs renewal. | Click Reconnect. |
| Authorization unavailable | Cannot reach the authorization server. | Check the network and click Reconnect. |
Common errors
| Message summary | Meaning and action |
|---|---|
| Unable to verify installation token | Check the input or obtain a new token. |
| Installation token expired | Obtain a new token. |
| Installation token revoked | Ask the administrator for a replacement. |
| Installation permission disabled | Ask the administrator to enable it, then retry. |
| Installation information does not match the issued target | Obtain and enter a new installation code. |
| Cannot connect to authorization server | Check the network and Gate address, then retry. |
| Authorization processing error | Wait and retry once. If it persists, give the administrator the error code and time. |
AP tab
A diagnostic screen for protected keys, model registration, and connection checks. May be hidden depending on installation. Not needed for everyday use.
| Item | Action |
|---|---|
| Protected key | Field for the protected key. |
| Model ID | Enter the exact model ID. If empty, Enter the exact model ID appears. |
| Register key | Registers the key. A connection check is required afterward. |
| Check connection | Tests the registered key and model. |
| Remove key | Unregisters the protected key. |
| Start observation / Stop observation | Starts or stops observing a room. |
| Status, last connection, last observation, last API result, operation result | Read-only model, key registration, connection verification, and last error. |
To be confirmed Availability and guidance for AP in standard customer distributions will be clarified later.
Before changing settings
- Change one thing at a time and check the result.
- After changing connections, open the Control viewand check for normal connectivity.
- If changing a model or interval causes trouble, restore the previous values and save.
- For agent counts and indicator colors, see the Screen overview.