MCP AIC problems and fixes

Read the startup error and check the setting it names. Allowed project folders must be absolute, and the private data folder must be outside them and owned by your user. Correct the setting before restarting your owned server; a data_dir_in_use error means you need a separate data folder or must stop its existing owner first.

Check aic_capabilities for the installed providers. Install and sign in to a supported helper program in the environment where MCP AIC runs, then check capabilities again before opening the session.

Compare the requested folder with the absolute folders the operator allowed. Choose a permitted folder or ask the operator to correct access; do not broaden access merely to silence the error.

List your sessions and identify work that can finish or close. Preserve its output, close the session deliberately and retry the new session after the close succeeds.

Read the active turn with aic_session_read and await_ms. Wait for its final state, or request cancellation and read what happened, before sending replacement work.

Check the original client connection first. List with include_orphaned: true and resume only when the server makes the session reclaimable; do not recreate work until you have reconciled the original task and its project changes.

Check next_since and continue reading from that position. A page has a target size budget, so fewer events than limit does not establish that the turn finished.

Read the stored partial result and inspect the project changes before repeating the task. Ask the operator to restore the data folder’s storage access, then decide whether the remaining work needs a retry.