---
title: FAQ
description: Frequently asked questions.
---

**When you need this:** You have a quick "what happens if…" question about syncing skills or MCPs.

## Will Kasetto Overwrite My MCP Entries?

No. MCP merges are **additive** and existing server entries are **never overwritten**. See [How Sync Works](/docs/how-sync-works#mcp-servers-discovery-and-additive-merge).

## What Happens When Two Sources Define The Same MCP Server Name?

**First write wins** based on config order. Later sources with the same server name are skipped. See [How Sync Works](/docs/how-sync-works#edge-cases).

## Where Is The Lock File?

- **Global scope**: `$XDG_DATA_HOME/kasetto/kasetto.lock` (default: `~/.local/share/kasetto/kasetto.lock`)
- **Project scope**: `./kasetto.lock`

See [How Sync Works](/docs/how-sync-works#lock-file).

## How Do I Uninstall Safely?

- To remove tracked installs for a scope: `kst clean`
- To remove everything including the binary: `kst self uninstall`

See `kst clean` and `kst self uninstall` in [Commands](/docs/commands).

## Can I Use Multiple Agents?

Yes. Set `agent` to a list. See [Configuration](/docs/configuration#multiple-agents).

## Does Kasetto Run Code From Skills?

No. Skills are copied as directories. Execution is up to the agent you load them into.

## Can I Pin Sources To A Known-Good Version?

Yes. Use `ref:` with a tag or commit SHA. See [Cookbook](/docs/cookbook#mcp-packs-pinning-and-rollouts).

## What Does `--dry-run` Do?

It prints what would change without writing any files. Useful in CI. See [CI & automation](/docs/ci).

## Why Didn't My MCP Servers Show Up?

Most common causes:

- The target agent settings file is malformed JSON/TOML
- The MCP file doesn't contain a top-level `mcpServers` object

See [How Sync Works](/docs/how-sync-works#edge-cases) (corrupted settings file behavior).

## How Do Remote Configs (`--config https://...`) Authenticate?

Kasetto selects tokens by the URL hostname using the same rules as skill/MCP sources. See [Authentication](/docs/authentication#remote-configs).
