n8n-MCP 노드 지식을 활용한 AI 지원 n8n 워크플로 빌더

# n8n-MCP 설정 및 워크플로 초안

## 1) MCP 클라이언트 설정

**호스팅 대시보드 방식** (`~/.config/mcp/servers.json` 또는 클라이언트별 동등 파일):

```json
{
  "mcpServers": {
    "n8n-mcp": {
      "url": "https://<your-n8n-mcp-host>/mcp",
      "headers": { "Authorization": "Bearer ${N8N_MCP_API_KEY}" }
    }
  }
}
```

**npx 자체 호스팅**:

```json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "n8n-mcp"],
      "env": {
        "N8N_API_URL": "https://<dev-instance>/api/v1",
        "N8N_API_KEY": "${N8N_API_KEY}",
        "MCP_MODE": "stdio"
      }
    }
  }
}
```

**Docker 자체 호스팅**:

```json
{
  "mcpServers": {
    "n8n-mcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm",
        "-e", "N8N_API_URL", "-e", "N8N_API_KEY", "-e", "MCP_MODE=stdio",
        "ghcr.io/czlonkowski/n8n-mcp:latest"],
      "env": {
        "N8N_API_URL": "https://<dev-instance>/api/v1",
        "N8N_API_KEY": "${N8N_API_KEY}"
      }
    }
  }
}
```

API 키는 n8n **개발 인스턴스**에서만 발급하고, 프로덕션 키는 사용하지 않습니다.

## 2) 연결 검증

MCP 클라이언트에서 다음을 실행합니다:

- `search_nodes` → `query: "HTTP Request"`
- 결과의 노드 타입(예: `n8n-nodes-base.httpRequest`)에 대해 `get_node` 호출 → `properties` 배열 출력

확인해야 할 항목: 노드 `type`, `typeVersion`, `properties`에 `url`, `method`, `authentication`, `sendBody`, `specifyBody`, `jsonBody` 등이 존재하는지. 이 단계에서 반환된 실제 속성명만 이후 단계에서 인용합니다.

## 3) 워크플로 초안 (Webhook → 변환 → Slack)

```json
{
  "name": "draft-webhook-transform-slack",
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "draft-inbound",
        "responseMode": "onReceived",
        "options": {}
      },
      "id": "a1",
      "name": "Webhook",
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2,
      "position": [0, 0],
      "webhookId": "draft-inbound"
    },
    {
      "parameters": {
        "mode": "manual",
        "assignments": {
          "assignments": [
            { "id": "f1", "name": "text", "value": "={{ $json.body.message }}", "type": "string" },
            { "id": "f2", "name": "channel", "value": "={{ $json.body.channel || '#dev-alerts' }}", "type": "string" }
          ]
        },
        "options": {}
      },
      "id": "a2",
      "name": "Transform",
      "type": "n8n-nodes-base.set",
      "typeVersion": 3.4,
      "position": [220, 0]
    },
    {
      "parameters": {
        "resource": "message",
        "operation": "post",
        "select": "channel",
        "channelId": { "__rl": true, "value": "={{ $json.channel }}", "mode": "name" },
        "text": "={{ $json.text }}",
        "otherOptions": {}
      },
      "id": "a3",
      "name": "Slack",
      "type": "n8n-nodes-base.slack",
      "typeVersion": 2.2,
      "position": [440, 0],
      "credentials": { "slackApi": { "id": "REPLACE_ME", "name": "Slack dev" } }
    }
  ],
  "connections": {
    "Webhook": { "main": [[{ "node": "Transform", "type": "main", "index": 0 }]] },
    "Transform": { "main": [[{ "node": "Slack", "type": "main", "index": 0 }]] }
  },
  "settings": { "executionOrder": "v1" },
  "active": false
}
```

## 4) 속성 출처 및 미검증 항목

| 노드 | 인용한 속성 | 상태 |
|---|---|---|
| Webhook | `httpMethod`, `path`, `responseMode`, `options` | MCP `get_node`로 확인 필요 (아래 참고) |
| Set | `mode`, `assignments.assignments[].name/value/type`, `options` | 확인 필요 |
| Slack | `resource`, `operation`, `select`, `channelId`, `text`, `otherOptions` | 확인 필요 |

**미검증/주의 항목 (반드시 MCP로 재확인)**:

- `typeVersion` 값(Webhook 2, Set 3.4, Slack 2.2)은 버전에 따라 다를 수 있음 — `get_node`의 `typeVersion`으로 확정할 것.
- Slack `channelId`의 `__rl` 리소스 로케이터 구조와 `mode: "name"` 지원 여부.
- Set 노드의 `assignments` 중첩 구조(버전 3.x에서 `assignments.assignments` 형태인지).
- Webhook `responseMode: "onReceived"`가 해당 버전에서 유효한 enum 값인지.
- Slack 자격증명 ID는 플레이스홀더이며 실제 값으로 교체 필요.

위 항목 중 MCP 응답에서 확인되지 않은 것은 **미검증**으로 표시하고, 확인 전에는 워크플로를 활성화하지 않습니다.

## 5) 테스트 계획 (개발 인스턴스)

1. **임포트**: 개발 인스턴스에 JSON 임포트, `active: false` 유지.
2. **자격증명**: Slack dev 앱 자격증명을 `REPLACE_ME`에 연결.
3. **Webhook 스모크 테스트**:
   ```bash
   curl -X POST https://<dev>/webhook/draft-inbound \
     -H 'Content-Type: application/json' \
     -d '{"message":"hello","channel":"#dev-alerts"}'
   ```
   기대: 200 응답, 실행 로그에 Webhook → Transform → Slack 순서 기록.
4. **Transform 검증**: 실행 데이터에서 `text`, `channel` 필드가 기대값인지 확인. `channel` 누락 시 기본값 `#dev-alerts` 적용 확인.
5. **Slack 전송 검증**: dev 채널에 메시지 도착 확인. 실패 시 Slack 노드의 `channelId` 리소스 로케이터 해석 오류 여부 점검.
6. **에러 경로**: `message` 필드 누락 페이로드 전송 → Slack 노드 실패 또는 빈 메시지 동작 기록.
7. **회귀 방지**: 프로덕션 워크플로는 조회만 하고 수정하지 않음. 프로덕션 인스턴스에는 임포트하지 않음.
8. **승격 전 체크**: 4)의 미검증 항목을 MCP `get_node`로 모두 확정한 뒤에만 활성화 검토.