Skip to Content

Troubleshootingturno doctor

A server runs outside the gateway

What turno doctor means by "<name> runs outside mcpd", 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

  !  <name> runs outside mcpd

It is a warning; warnings do not change the exit code. Words in angle brackets stand for values from your machine.

Why it happens

An agent config starts this MCP server directly, so every session gets its own copy instead of sharing the gateway's.

Fix

turno mcp import when the server is not in mcp.toml yet; turno mcp sync (turno doctor --fix runs it) when it is; otherwise remove the entry from the agent config, as doctor says.

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

The check lives in packages/turno/src/cli/commands/doctor.ts.

On this page