Skip to Content

Troubleshootingturno doctor --security

mcp.toml holds literal secrets

What turno doctor --security means by "literal secrets in <mcp file>: <in manifest>", and the fix.

View source

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

What you see

  !  literal secrets in <mcp file>: <in manifest>
     manual: store each with turno secret set <name> and write keychain:<name> in its place (args and URLs cannot hold references; see docs/mcp.md)

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 secret is written in mcp.toml itself. Env and header secrets can come from the secret store; secrets in a server's args or URL query string cannot, and stay literal.

Fix

Store each with turno secret set <name> and write keychain:<name> in its place (args and URLs cannot hold references; see docs/mcp.md)

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

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

The check lives in packages/turno/src/cli/security.ts.

On this page