Skip to Content

Troubleshootingturno doctor

mcp.toml reads a variable that is not set

What turno doctor means by "<name> reads <list> from mcpd's environment, and <it is|they are> not set here", 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> reads <list> from mcpd's environment, and <it is|they are> not set here
     manual: set <list> where mcpd starts, then turno mcp daemon restart; or store <it|each> with turno secret set <name> and write keychain:<name> instead

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

Why it happens

A server in mcp.toml reads env:NAME or ${NAME} from mcpd's environment. The variable is not set in the shell doctor runs in. A variable that is unset and has no default stops that server from starting.

Fix

Set <list> where mcpd starts, then turno mcp daemon restart; or store <it|each> with turno secret set <name> and write keychain:<name> instead.

No single command fixes this one, so doctor names the manual step.

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