Troubleshoot MCP Servers

Start with the status shown under Settings → Agents → MCP Servers.

Server is disabled or disconnected

Enable or connect the server, then wait for the state to update. Use Reload after changing the configuration file outside the extension.

Local server fails

Review the configured command, arguments, working environment, and required executable. Run only safe diagnostic commands and do not paste secret environment values into Chat or support messages.

Remote server needs authentication

Use the authentication or client-registration action shown for that server. Confirm that its URL belongs to the intended environment and that the account has access.

Agent still reports a missing requirement

Confirm that the connected server name and scope match the agent requirement. Project and global entries with different names do not satisfy one another automatically.

Reload configuration and retry. Choose another agent only when the task does not require that MCP capability.