feat: add Claude Code, configure MCP servers, and refine tool configs

- Add Claude Code: cask (macOS), pnpm (Ubuntu), WinGet (Windows)
- Configure 4 user-scoped MCP servers (playwright, github, cloudflare, context7)
  via a single loop over mcp_servers in group_vars/all.yml
- Add bat, ripgrep, and atuin configs with full deployment via dotfiles role
- Wire fzf previews (bat for Ctrl-T, eza tree for Alt-C), RIPGREP_CONFIG_PATH,
  and ZSH_AUTOSUGGEST_STRATEGY into .zshrc
- Document MCP server pattern in CLAUDE.md

Author: WhatIsHeDoing

CLAUDE.md

@@ -85,6 +85,28 @@ Touch **all** of these files — none are optional:
 
 If the tool is only available via a custom installer on a platform, also add a check-and-install task to `roles/tools/tasks/{darwin,debian,windows}.yml`.
 
+## Adding a New MCP Server
+
+MCP servers are configured at user scope via `claude mcp add`. The list lives in
+`ansible/inventory/group_vars/all.yml` under `mcp_servers`; a single loop task in
+`roles/dotfiles/tasks/main.yml` iterates over it.
+
+`claude mcp add` exits 1 if the server already exists, so the loop task pre-checks
+with `claude mcp list | grep -q` before running — do not remove this guard.
+
+To add a new MCP server:
+
+1. **`ansible/inventory/group_vars/all.yml`** — append to `mcp_servers` (alphabetically):
+
+   ```yaml
+   - name: my-server
+     command: npx @scope/my-mcp-package
+   ```
+
+2. **`cspell.json`** — add any non-dictionary words (package scope, server name).
+
+No changes to the dotfiles task or verify playbook are needed.
+
 ## Adding a New App
 
 1. **`roles/apps/vars/{darwin,debian,windows}.yml`** — add the package name.

README.md

@@ -192,6 +192,7 @@ The Ansible playbook connects back to the Windows host over WinRM and installs e
 
 | App                         | Platforms       | Description                                           |
 | --------------------------- | --------------- | ----------------------------------------------------- |
+| [Claude Code]               | all             | AI coding assistant CLI and desktop app               |
 | [VS Code]                   | all             | Code editor                                           |
 | [draw.io]                   | all             | Diagramming                                           |
 | [Obsidian]                  | all             | Note-taking                                           |
@@ -268,6 +269,7 @@ just spellcheck
 [7-Zip]: https://7-zip.org/
 [Amberol]: https://gitlab.gnome.org/World/amberol
 [bat]: https://github.com/sharkdp/bat
+[Claude Code]: https://claude.ai/code
 [bottom]: https://clementtsang.github.io/bottom/
 [Firefox]: https://www.mozilla.org/firefox/
 [Caesium]: https://saerasoft.com/caesium

ansible/inventory/group_vars/all.yml

@@ -33,6 +33,17 @@ pip_packages:
     - ipykernel
     - pre-commit
 
+# Claude Code MCP servers configured at user scope
+mcp_servers:
+    - name: cloudflare
+      command: npx @cloudflare/mcp-server-cloudflare
+    - name: context7
+      command: npx @upstash/context7-mcp
+    - name: github
+      command: npx @modelcontextprotocol/server-github
+    - name: playwright
+      command: npx @playwright/mcp@latest
+
 # pnpm packages installed globally on all platforms
 pnpm_packages:
     - cspell

ansible/playbooks/verify.yml

@@ -62,6 +62,8 @@
             name: "ripgrep-all"
           - cmd: "atuin --version"
             name: "atuin"
+          - cmd: "claude --version"
+            name: "claude-code"
           - cmd: "dust --version"
             name: "dust"
           - cmd: "tldr --version"

ansible/roles/apps/tasks/debian.yml

@@ -22,6 +22,20 @@
   loop: "{{ snap_apps }}"
   become: true
 
+- name: Check if Claude Code CLI is installed
+  ansible.builtin.command: which claude
+  register: claude_check
+  changed_when: false
+  failed_when: false
+
+- name: Install Claude Code CLI via pnpm
+  ansible.builtin.command: pnpm add -g @anthropic-ai/claude-code
+  environment:
+      PATH: "{{ ansible_env.HOME }}/.local/share/pnpm:{{ ansible_env.PATH }}"
+      PNPM_HOME: "{{ ansible_env.HOME }}/.local/share/pnpm"
+  changed_when: claude_check.rc != 0
+  when: claude_check.rc != 0
+
 - name: Check if Zed is installed
   ansible.builtin.command: which zed
   register: zed_check

ansible/roles/apps/vars/darwin.yml

@@ -1,6 +1,7 @@
 ---
 # OrbStack is used in place of Docker Desktop on macOS (drop-in replacement per principle 2)
 homebrew_casks:
+    - claude-code
     - dbeaver-community
     - drawio
     - firefox

ansible/roles/apps/vars/windows.yml

@@ -1,6 +1,7 @@
 ---
 winget_apps:
     - 7zip.7zip
+    - Anthropic.Claude
     - Mozilla.Firefox
     - SabaAmaury.Caesium
     - dbeaver.dbeaver

ansible/roles/dotfiles/tasks/main.yml

@@ -333,3 +333,16 @@
       - ff
       - ll
   when: effective_platform != "windows"
+
+# ── Claude Code MCP servers ──────────────────────────────────────────────
+- name: Configure Claude Code MCP servers
+  ansible.builtin.shell: |
+    claude mcp list 2>/dev/null | grep -q "{{ item.name }}" || \
+    claude mcp add {{ item.name }} -s user -- {{ item.command }}
+  args:
+      executable: /bin/bash
+  loop: "{{ mcp_servers }}"
+  loop_control:
+      label: "{{ item.name }}"
+  changed_when: false
+  when: effective_platform != "windows"

cspell.json

@@ -17,6 +17,7 @@
         "Amaury",
         "Amberol",
         "ansible",
+        "anthropic",
         "aquasecurity",
         "asciinema",
         "autoclean",
@@ -31,6 +32,7 @@
         "checkov",
         "chezmoi",
         "clmv",
+        "cloudflare",
         "commitizen",
         "conflictstyle",
         "CoreyButler",
@@ -92,9 +94,11 @@
         "linted",
         "localport",
         "markdownlint",
+        "mcp",
         "minikube",
         "misconfig",
         "mise",
+        "modelcontextprotocol",
         "nvm",
         "mlr",
         "MSVC",
@@ -111,6 +115,7 @@
         "Pathbar",
         "pipefail",
         "pipx",
+        "playwright",
         "playbook",
         "playbooks",
         "pnpm",
@@ -148,6 +153,7 @@
         "timezone",
         "tlsv",
         "toml",
+        "upstash",
         "upx",
         "uv",
         "yq",