Claude Code Power Tools

# Claude Code Power Tools

Verwandeln Sie Claude Code mit Hooks, Headless-Ausführungen und MCP-Integrationen in eine programmierbare Workflow-Engine.

## Was dieses Plugin macht

Dieses Plugin kombiniert drei komponierbare Fähigkeiten:

- **Hooks** — Intercept-Tool-Aufrufe (PreToolUse / PostToolUse), um Regeln durchzusetzen, Ausgaben zu validieren oder Nebeneffekte auszulösen
- **Headless** — Führen Sie Claude Code nicht-interaktiv über `claude -p` für Batch-Verarbeitung, CI/CD und Skripting aus
- **MCP** — Erstellen Sie Model Context Protocol Server, die Claude Zugriff auf externe Systeme geben (Datenbanken, APIs, Messaging)

Diese drei Teile greifen ineinander: Hooks kontrollieren *was Claude tut*, Headless kontrolliert *wann und wie es läuft*, und MCP kontrolliert *was es erreichen kann*.

## Vollständiges Beispiel: Automatisierte Code-Review-Pipeline

Ein Team möchte, dass jeder PR automatisch überprüft und die Ergebnisse in Slack gepostet sowie Verstöße blockiert werden.

### Schritt 1: MCP-Server — Mit externen Systemen verbinden

Erstellen Sie einen MCP-Server, der Slack-Posting und GitHub-PR-Daten bereitstellt:

```typescript
// review-mcp/server.ts
const server = new McpServer({ name: "review-tools" });

server.tool("post_slack", { channel: z.string(), message: z.string() },
  async ({ channel, message }) => {
    await slack.chat.postMessage({ channel, text: message });
    return { content: [{ type: "text", text: "Posted" }] };
  }
);

server.tool("get_pr_diff", { pr: z.number() },
  async ({ pr }) => {
    const diff = await octokit.pulls.get({ owner, repo, pull_number: pr });
    return { content: [{ type: "text", text: diff.data.body }] };
  }
);
```

Registrieren Sie es: `claude mcp add review-tools -- node review-mcp/server.ts`

### Schritt 2: Headless — Reviews in CI ausführen

```yaml
# .github/workflows/review.yml
- name: AI Code Review
  run: |
    claude -p "Review PR #${{ github.event.pull_request.number }}.       Use get_pr_diff to fetch changes, analyze for bugs and style issues,       then post_slack the summary to #code-review."       --allowedTools "mcp__review-tools__post_slack,mcp__review-tools__get_pr_diff"       --output-format json > review-result.json
```

### Schritt 3: Hooks — guardrails durchsetzen

```json
// .claude/settings.json
{
  "hooks": {
    "PreToolUse": [{
      "matcher": "mcp__review-tools__post_slack",
      "hooks": [{
        "type": "command",
        "command": "python3 validate_slack.py "$TOOL_INPUT""
      }]
    }]
  }
}
```

Das Hook-Skript prüft, ob Slack-Nachrichten den Team-Formatierungsregeln folgen. Ein Exit-Code ungleich Null blockiert den Tool-Aufruf.

**Ergebnis:** PRs lösen headless Claude aus → Claude holt Diff via MCP → überprüft Code → postet in Slack (validiert durch Hook) — vollständig automatisiert, vollständig überprüfbar.

## Risikogrenzen

### Hooks

- Hooks **ändern das Standardverhalten von Claude**. Ein fehlerhafter PreToolUse-Hook kann legitime Tool-Aufrufe stillschweigend blockieren. Testen Sie Hooks immer isoliert, bevor Sie sie bereitstellen.
- Hook-Skripte werden mit Ihren Shell-Berechtigungen ausgeführt. Leiten Sie niemals nicht vertrauenswürdige Eingaben direkt ohne Bereinigung in Hook-Befehle.
- Halten Sie Hooks schnell (< 2s). Langsame Hooks verschlechtern das interaktive Erlebnis.

### Headless-Modus

- `--dangerously-skip-permissions` entfernt alle Sicherheitsaufforderungen. Verwenden Sie dies nur in vertrauenswürdigen CI-Umgebungen mit gesperrten Berechtigungen.
- Headless-Ausführungen haben keinen Menschen in der Schleife. Begrenzen Sie erlaubte Tools explizit mit `--allowedTools`, um unbeabsichtigte Aktionen zu verhindern.
- Die Ausgabe kann groß sein. Setzen Sie in Pipelines immer `--output-format json` und analysieren Sie strukturierte Ergebnisse.

### MCP-Server

- MCP-Server werden als separate Prozesse mit eigenen Berechtigungen ausgeführt. Ein schlecht begrenzter Server kann sensible Daten expose oder destruktive Operationen erlauben.
- Validieren Sie immer Eingaben in Tool-Handlern. Von Claude generierte Parameter sind nicht garantiert sicher.
- Verwenden Sie Transport-Isolation: Führen Sie MCP-Server in Containern oder eingeschränkten Benutzerkonten für Produktionsbereitstellungen aus.
- Behandeln Sie Fehler graceful — ein MCP-Server-Absturz mitten in einem Gespräch hinterlässt Claude ohne Zugriff auf diese Tools bis zum Neustart.