# Mcp Config Sync

> >

- **Type:** Skill
- **Install:** `agentstack add skill-ellmos-ai-skills-mcp-config-sync`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ellmos-ai](https://agentstack.voostack.com/s/ellmos-ai)
- **Installs:** 0
- **Category:** [Databases](https://agentstack.voostack.com/c/databases)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ellmos-ai](https://github.com/ellmos-ai)
- **Source:** https://github.com/ellmos-ai/skills/tree/master/skills/infrastructure/mcp-config-sync
- **Website:** https://github.com/ellmos-ai/skills#readme

## Install

```sh
agentstack add skill-ellmos-ai-skills-mcp-config-sync
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# MCP Config Sync

Synchronisiert die drei Bereiche, in denen Claude Code und Claude Desktop sich Inhalte teilen koennen — MCP-Server, Skills-Status, Plugin/Extension-Paritaet.

## Ueberblick — was ist synchronisierbar?

| Bereich | Sync-Status | Mechanik |
|---|---|---|
| **MCP-Server** | automatisch | Master-Datei + Skript spiegelt in beide Configs |
| **User-Skills** | teilweise | Claude Code liest `~/.claude/skills/`, Claude Desktop nicht direkt — siehe `references/skills-sync-options.md` |
| **Plugins/Extensions** | nur Mapping | unterschiedliche Marketplaces — siehe `references/plugin-extension-parity.md` |

## Erstmaliger Setup

1. Master-Datei am Ziel-Pfad anlegen:
   - Windows: `%USERPROFILE%\.claude\_shared-mcp.json`
   - macOS: `~/.claude/_shared-mcp.json`

   Vorlage: `assets/_shared-mcp.template.json`. Pfade fuer das jeweilige System anpassen.

2. Sync-Skript am gleichen Ort ablegen:
   - Windows: `scripts/sync-tools.ps1` -> `%USERPROFILE%\.claude\sync-tools.ps1`
   - macOS: `scripts/sync-tools.sh` -> `~/.claude/sync-tools.sh` (`chmod +x` nicht vergessen)

3. macOS-Voraussetzung: `brew install jq`

## Routine-Sync (jedes Mal nach Aenderung der Master-Datei)

**Windows:**
```powershell
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.claude\sync-tools.ps1"
```

**macOS:**
```zsh
~/.claude/sync-tools.sh
```

**Danach:**
- Claude Desktop **vollstaendig** beenden (Tray-Icon -> Quit, nicht nur Fenster schliessen) und neu starten
- In Claude Code wahlweise mit `claude --mcp-config ~/.claude/profiles/shared.json` starten

## Was passiert beim Sync?

Das Skript nimmt den `mcpServers`-Block aus der Master-Datei und schreibt ihn an zwei Stellen:

1. **Claude Code**: `~/.claude/profiles/shared.json` (Datei wird komplett ueberschrieben — andere Profile bleiben unberuehrt)
2. **Claude Desktop**: `/Claude/claude_desktop_config.json` — der `mcpServers`-Block wird ersetzt, alle anderen Felder (`isUsingBuiltInNodeForMcp`, `preferences`, ...) bleiben erhalten. Vorher wird ein Backup mit Zeitstempel angelegt.

## Master-Datei-Schema

```json
{
  "_comment": "Optional, wird ignoriert.",
  "_stand": "YYYY-MM-DD",
  "mcpServers": {
    "": {
      "command": "node | npx | absolute path",
      "args": ["..."],
      "env": { "OPTIONAL_VAR": "value" }
    }
  }
}
```

Zusaetzliche Top-Level-Felder werden vom Skript ignoriert. Fuer absolute Pfade, die plattformuebergreifend sind, im Master Slash-Pfade (`C:/Users//...`) verwenden — Windows akzeptiert beides, macOS nutzt eh Forward-Slashes.

## Wenn ein MCP-Server nur in einer App laufen soll

Nicht in die Master-Datei aufnehmen. Stattdessen:
- Claude Code only: in einem anderen Profile-File (`~/.claude/profiles/.json`) eintragen, dann `claude --mcp-config ...`
- Claude Desktop only: per Hand in `claude_desktop_config.json` ergaenzen — der Sync-Lauf laesst andere Server in der Config unangetastet, weil er nur den `mcpServers`-Block ersetzt.

> **Beachten:** Wenn ein neuer Master-Sync laeuft, geht der nicht in der Master-Datei stehende Server in Claude Desktop verloren. Wenn Claude-Desktop-only-Server gepflegt werden sollen, **immer manuell in der Master-Datei eintragen** und das Skript zum einzigen Schreiber machen — sonst gehen sie beim naechsten Sync verloren.

## Aufbau dieses Skills

```
mcp-config-sync/
├── SKILL.md (diese Datei)
├── scripts/
│   ├── sync-tools.ps1    Windows-Sync (PowerShell)
│   └── sync-tools.sh     macOS-Sync (zsh+jq)
├── assets/
│   └── _shared-mcp.template.json  Master-Datei-Vorlage
└── references/
    ├── plugin-extension-parity.md  Mapping Claude-Code-Plugins ↔ Claude-Desktop-Extensions
    └── skills-sync-options.md      Optionen, User-Skills auch in Claude Desktop nutzbar zu machen
```

Bei den meisten Anfragen reicht die SKILL.md. Reference-Dateien nur dann lesen, wenn der User explizit nach Plugin-Mapping oder Skills-Sync-Optionen fragt.

## Anti-Pattern

- **Nicht** den `mcpServers`-Block in `claude_desktop_config.json` haendisch editieren, wenn die Master-Datei der wahre Quellort ist — der naechste Sync ueberschreibt das.
- **Nicht** versuchen, das Skill-Verzeichnis `~/.claude/skills/` per Junction in Claude Desktops session-internen Skill-Pfad zu binden — das ist fragil und wird durch Anthropic-Updates regelmaessig zerstoert. Stattdessen einen Index-/Bridge-Skill verwenden (siehe `references/skills-sync-options.md`, Option 1).
- **Nicht** Claude-Code-Plugins und Claude-Desktop-Extensions 1:1 abgleichen wollen — die Toolkits sind komplementaer, nicht spiegelbar.

---

## Changelog

### 1.0.1 (2026-06-13)
- Erstveroeffentlichung in der Skill-Bibliothek: hartkodierte User-Pfade in SKILL.md, Sync-Skript und Master-Vorlage durch `%USERPROFILE%`/`$HOME`-Platzhalter ersetzt

### 1.0.0 (2026-05-16)
- Initiale Fassung: Master-Datei + Sync-Skripte (Windows/macOS), Plugin-Paritaets- und Skills-Sync-Referenzen

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ellmos-ai](https://github.com/ellmos-ai)
- **Source:** [ellmos-ai/skills](https://github.com/ellmos-ai/skills)
- **License:** MIT
- **Homepage:** https://github.com/ellmos-ai/skills#readme

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ellmos-ai-skills-mcp-config-sync
- Seller: https://agentstack.voostack.com/s/ellmos-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.