# code.hofmanns.ai — Claude Code + n8n MCP Integration

> AI-powered workflow builder for hofmanns.ai infrastructure.
> Based on [Nate Herk's tutorial](https://youtu.be/B6k_vAjndMo) — Claude Code + n8n MCP integration.

## What This Project Does

Claude Code connects to **n8n** via the **n8n-mcp** server (Model Context Protocol) to:
- Search 1,200+ n8n nodes and their documentation
- Build, validate, and deploy n8n workflows
- Access workflow templates (2,700+)
- Manage workflows via the n8n REST API

Additionally connects to **hofmanns.ai infrastructure** via custom MCP servers:
- **hai-infra** (infra.hofmanns.ai) — shell, Docker, Caddy, filesystem on hai
- **hai-tasks** (mcp.hofmanns.ai) — task management
- **jetson-mcp** — GPU status, Docker on Jetson Orin

## Architecture

```
Claude Code (this machine)
    ├── n8n-mcp (npx)      → localhost:5678 (n8n API)
    ├── hai-infra MCP       → infra.hofmanns.ai:3100
    ├── hai-tasks MCP       → mcp.hofmanns.ai:3847
    └── jetson-mcp          → jetson-mcp.hofmanns.ai:3100
```

## n8n Skills (7 installed)

| Skill | Purpose |
|-------|---------|
| n8n-mcp-tools-expert | Node search, workflow management via MCP |
| n8n-expression-syntax | {{}} patterns, $json, $node variables |
| n8n-workflow-patterns | 5 architectural patterns, 2,700+ templates |
| n8n-validation-expert | Error interpretation, auto-sanitization |
| n8n-node-configuration | Property dependencies, required fields |
| n8n-code-javascript | Code nodes, $input/$helpers, DateTime |
| n8n-code-python | Python in n8n, stdlib, limitations |

## Quick Reference

### n8n API
- **URL:** http://localhost:5678
- **API Key:** See credentials
- **Key Expires:** 2026-03-08 (renew!)

### Forgejo (git.hofmanns.ai)
- **API Key:** See credentials
- **SSH:** `ssh -p 2222 git@git.hofmanns.ai`
- **This repo:** `hofmann/code.hofmanns.ai`

### Key Conventions
- Always copy workflows before editing (never modify production directly)
- Test in development first
- Export backups before changes
- Webhook data is at `$json.body`, NOT root level

## Installed Components

```
~/.claude/.mcp.json          # MCP server config (n8n-mcp + hai servers)
~/.claude/skills/            # 7 n8n skills
    n8n-mcp-tools-expert/
    n8n-expression-syntax/
    n8n-workflow-patterns/
    n8n-validation-expert/
    n8n-node-configuration/
    n8n-code-javascript/
    n8n-code-python/
```

## Usage Examples

```
# Ask Claude Code to build workflows:
"Build a webhook workflow that receives JSON, processes it, and sends to Slack"
"Create an n8n workflow that monitors a URL and sends Telegram alerts on changes"
"Find me the Slack node and show its configuration options"
"Validate my workflow for errors"
```