1-4. [실습] "내 워크플로우 목록 보여줘" — 첫 자연어 명령

환경이 모두 준비되었습니다. Claude Code 설치, n8n 서버 실행, MCP 연결까지 완료한 상태에서 자연어 명령을 직접 내려봅니다.

1. 실습 1: 워크플로우 목록 조회

Claude Code에 다음과 같이 입력합니다.

"내 n8n 워크플로우 목록을 보여줘"

Claude Code가 n8n_list_workflows 도구를 호출합니다. 잠시 후 결과가 표시됩니다.

워크플로우가 있는 경우 각 워크플로우의 ID, 이름, 활성 상태가 출력됩니다.

1. ID: gAmdkXg1  |  이름: 기상청 날씨 조회  |  활성: true
2. ID: hBneYr2   |  이름: 슬랙 알림 봇     |  활성: false
3. ID: kCofZs3   |  이름: 일일 리포트       |  활성: true

워크플로우가 없는 경우 "현재 워크플로우가 없습니다"라는 결과가 나옵니다. 방금 n8n 서버를 설치했다면 비어 있는 것이 정상입니다.

2. 실습 2: 워크플로우 개수 확인

이번에는 표현을 살짝 바꿔 봅니다.

"n8n 서버에 워크플로우가 몇 개 있어?"

같은 n8n_list_workflows 도구를 호출하지만, Claude Code가 결과를 다르게 해석합니다. 전체 목록 대신 개수만 세어 "현재 3개의 워크플로우가 있습니다"라고 답합니다.

같은 도구라도 질문에 따라 답변 형태가 달라집니다. 이것이 자연어 명령의 장점입니다.

3. 실습 3: 최근 실행 기록 확인 (선택)

시간이 된다면 한 가지 더 시도합니다.

"가장 최근에 실행된 워크플로우는 뭐야?"

이번에는 n8n_executions 도구가 호출됩니다. 앞선 실습과 다른 도구입니다. Claude Code가 질문 의도를 파악해 "워크플로우 목록"이 아니라 "실행 기록"을 가져오는 도구를 선택한 것입니다.

실행 기록이 있으면 워크플로우 이름, 실행 시간, 성공 여부가 표시됩니다. 한 번도 실행한 적이 없다면 "실행 기록이 없습니다"라는 결과가 나옵니다.

4. 핵심 포인트

지금까지 진행한 작업을 정리하면 다음과 같습니다.

• "내 워크플로우 목록을 보여줘"
• "워크플로우가 몇 개 있어?"
• "가장 최근에 실행된 워크플로우는 뭐야?"

★ 핵심. 코드 한 줄도 작성하지 않았습니다. API 문서를 읽지도, HTTP 요청을 직접 보내지도 않았습니다. 자연어로 말했을 뿐인데 Claude Code가 알맞은 도구를 골라 n8n 서버를 조회했습니다.

이것이 Claude Code와 MCP의 힘입니다. 앞으로 배울 모든 내용은 이 패턴의 확장입니다. 더 복잡한 명령, 더 정교한 작업을 자연어로 지시하는 방법을 익혀갑니다.

5. Chapter 1 총정리

Chapter 1에서 완료한 항목은 네 가지입니다.

이제 기본 환경이 모두 갖추어졌습니다.

6. 다음 예고

Chapter 2에서는 클로드 스킬을 다룹니다. 마크다운 파일 한 장으로 AI에게 업무 매뉴얼을 써주는 방식입니다. 이 스킬을 Claude Code에 등록하면 더 정교하고 일관된 작업을 자연어로 지시할 수 있게 됩니다.