Skip to Content

Troubleshootingturno doctor

The LaunchAgent runs as a Background process

What turno doctor means by "mcpd: the LaunchAgent runs as a Background process, which macOS throttles", and the fix.

View source

This page is for when turno doctor reports the finding below: what it means and how to fix it.

What you see

  !  mcpd: the LaunchAgent runs as a Background process, which macOS throttles
     fix: turno mcp daemon start (turno doctor --fix runs it)

It is a warning; warnings do not change the exit code.

Why it happens

macOS throttles LaunchAgents marked as Background, which slows the gateway down.

Fix

Run:

turno mcp daemon start

turno doctor --fix runs this repair for you, together with every other one it can.

Then run turno doctor again to see the row turn into ok.

The check lives in packages/turno/src/mcpd/health.ts.

On this page