# MCP Notes

This repository manages shared MCP configuration through tracked templates plus
machine-local overrides.

## What Is Tracked

- Shared templates live in `config/mcp/`.
- The merge logic lives in `install/merge-managed-mcp-config.mjs`.
- The Copilot CLI filesystem wrapper lives in `install/mcp/`.

## What Stays Local

- Machine-local values live in `.local/mcp.local.jsonc`.
- Secrets stay in that local file and are never committed.
- Bootstrap creates `.local/mcp.local.jsonc` from
	`config/mcp/local-overrides.example.jsonc` if it does not exist yet.

## Generated Outputs

- VS Code user MCP config: user-profile `mcp.json`
- Copilot CLI user MCP config: `~/.copilot/mcp-config.json`

Bootstrap and update regenerate those managed files while preserving unmanaged
entries already present in the user config.

## Managed Servers

- Playwright: generated for VS Code with `npx @playwright/mcp@latest`
- Filesystem: generated for VS Code with Docker and `${workspaceFolder}` binding
- Filesystem: generated for Copilot CLI with a repo-owned Node wrapper that
	binds the current working directory into Docker
- Gitea/Forgejo: generated for VS Code and Copilot CLI with
	`ronmi/forgejo-mcp`, but only when `.local/mcp.local.jsonc` enables it and
	provides `serverUrl` plus `token`

Copilot CLI Playwright is not generated here because Copilot CLI already ships a
built-in Playwright MCP server.