cline/cline · error

MCP server settings toggle requires a server name.

Error message

MCP server settings toggle requires a server name.

What it means

Error "MCP server settings toggle requires a server name." thrown in cline/cline.

Source

Thrown at sdk/packages/core/src/extensions/mcp/config-loader.ts:815

		typeof serversValue !== "object" ||
		Array.isArray(serversValue)
	) {
		return undefined;
	}
	const server = getOwnServerRecord(
		serversValue as Record<string, unknown>,
		serverName,
	);
	return server ? parseMcpServerRegistration(serverName, server) : undefined;
}

export function setMcpServerDisabled(
	options: SetMcpServerDisabledOptions,
): void {
	const filePath = options.filePath ?? resolveDefaultMcpSettingsPath();
	const name = options.name.trim();
	if (!name) {
		throw new Error("MCP server settings toggle requires a server name.");
	}
	updateMcpSettingsFileSync(filePath, (settings) => {
		const serversValue = settings.mcpServers;
		if (
			!serversValue ||
			typeof serversValue !== "object" ||
			Array.isArray(serversValue)
		) {
			throw new Error(
				`Invalid MCP settings at "${filePath}": mcpServers must be an object.`,
			);
		}
		const servers = { ...(serversValue as Record<string, unknown>) };
		const current = getOwnServerRecord(servers, name);
		if (!current) {
			throw new Error(`Unknown MCP server: ${name}`);
		}
		const next = { ...current };

View on GitHub (pinned to 491b30b806)

When it happens

Trigger: Thrown at sdk/packages/core/src/extensions/mcp/config-loader.ts:815 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cline/cline@491b30b806 (2026-08-25). Data as JSON: /api/errors/05c01228b7c71ae8. Report an issue: GitHub.