muaco Tech Note

업무 자동화blog.n8n.io

n8n에 Gemini 4 Argon 연결하기자격 증명, Assistant, 에이전트, MCP

n8n에 Gemini 4 Argon을 연결하고 Assistant, 에이전트, MCP로 첫 워크플로를 만드는 순서를 정리합니다.

안녕하세요, muaco입니다.

이 글을 마치면 되는 일

끝까지 따라 하면 n8n 안에서 Gemini 4 Argon이 일하는 워크플로와 에이전트가 하나씩 생깁니다. n8n은 앱과 앱 사이에 심부름꾼을 세워 두는 자동화 도구로, 메일을 읽고 표에 적고 메신저로 알리는 일을 차례로 맡습니다.

2026년 10월 14일 기준 공식 문서를 따랐습니다.

시작 전에 갖출 준비물

  • n8n 계정. 가장 쉬운 길은 n8n Cloud입니다. 자격 증명 칸에서 Use Gateway credits를 고르면 n8n이 마련해 둔 모델 이용권(Gateway 크레딧)을 선불 카드처럼 꺼내 써서 구글 계정 없이도 모델을 부릅니다.
  • Assistant가 열리는 요금제. Cloud는 Starter와 Pro에서 씁니다. 자체 호스팅(내 서버에 n8n을 직접 설치해 돌리는 방식)은 Community, Registered Community, Business가 대상입니다. Enterprise는 아직 아닙니다.
  • 최신 n8n 버전. 자체 호스팅이라면 최신 안정판으로 올려 두세요. 에이전트는 2.32.3부터, MCP 설정의 Connect a client 창은 2.33.0부터 들어 있습니다.
  • 내 키로 쓸 때는 유료 등급 Gemini API. 구글 가격 문서에 따르면 Gemini 4 Argon은 무료 등급과 Google AI Pro 요금제에서 쓸 수 없습니다. 구글 클라우드 계정과 프로젝트도 하나 필요합니다.
  • 요금. 2026년 11월 30일까지는 입력 100만 토큰(모델이 글을 잘게 잘라 세는 단위)당 2달러, 출력 10달러입니다. 12월 1일부터는 4달러와 20달러로 오르고 출력에는 모델이 속으로 생각한 분량도 들어갑니다.
  • MCP를 켤 권한. n8n 인스턴스(내가 쓰는 n8n 한 벌)의 소유자나 관리자여야 합니다.

따라 하기: 다섯 묶음으로 갑니다

1. 열쇠 만들기: 자격 증명

회사 건물에 들어갈 때 출입증을 찍듯, n8n도 다른 서비스에 들어갈 때 열쇠를 내밉니다. 이 열쇠를 n8n에서는 자격 증명이라고 부릅니다.

따라 하기
  1. n8n Cloud에서 Gateway 크레딧만 쓸 생각이라면 이 묶음은 건너뜁니다.
  2. Google AI Studio의 API 키 화면을 열고 Create API Key를 누르세요. 새 프로젝트라면 Create API key in new project, 있던 프로젝트라면 Create API key in existing project를 고릅니다.
  3. 결제가 연결된 유료 등급 프로젝트인지 확인한 뒤 키를 복사하세요.
  4. n8n에서 Google Gemini(PaLM) API 자격 증명을 만들고 API Key 칸에 키를 붙여 넣습니다. Host 칸은 기본값 https://generativelanguage.googleapis.com을 그대로 두세요.

2. 한 번 불러 보기: Google Gemini 노드

열쇠가 맞는지는 어떻게 알까요? 가장 짧은 워크플로로 직접 불러 보면 됩니다.

따라 하기
  1. 새 워크플로에 Google Gemini 노드를 넣고 Text 묶음의 Message a Model을 고릅니다. 모델에게 글을 보내고 답을 받는 동작입니다.
  2. 자격 증명 칸에서 방금 만든 자격 증명을 고르세요. Cloud에서 크레딧을 쓴다면 Use Gateway credits를 고릅니다.
  3. 모델 목록에서 Gemini 4 Argon을 고르고 "세 줄로 자기소개를 해 주세요" 같은 짧은 지시를 넣습니다.
  4. 노드를 실행해 결과에 답이 돌아오는지 보세요. 답이 오면 열쇠와 모델이 제대로 이어진 상태입니다.

3. 말로 맡기기: n8n Assistant

n8n Assistant는 워크플로를 짜고 고치고 시험하는 채팅 도우미입니다. 아직 미리 보기(Preview) 단계라 실수가 있을 수 있어 만든 결과는 사람이 살펴야 합니다.

Cloud에서는 Assistant가 Gateway 크레딧과 따로 세는 Assistant 크레딧을 씁니다.

자체 호스팅이라면 Assistant부터 켭니다. 한 줄 설치 명령이나 Docker Compose로 깔았다면 샌드박스(밖과 분리된 작업 공간)가 이미 있으니 .env에 모델 키를 넣고 다시 시작하세요. 직접 설치했다면 설정 문서대로 N8N_INSTANCE_AI_SANDBOX_ENABLED=true와 샌드박스 주소부터 채웁니다.

따라 하기
  1. 워크플로를 둘 프로젝트에서 n8n Assistant 창을 열고 새 대화를 시작합니다. 대화는 창을 연 프로젝트를 쓰기 때문입니다.
  2. 시작 조건(트리거), 쓰는 앱, 오가는 데이터, 성공과 실패 때 할 일을 한 메시지에 적습니다. 아래 예시처럼 모델 이름과 "발행 전에 물어봐 달라"는 부탁도 넣으세요.
  3. Assistant가 계획을 내놓으면 만들라고 하기 전에 읽어 봅니다. 방향은 계획 단계에서 바로잡아야 크레딧이 덜 듭니다.
  4. 대화창에 자격 증명 카드가 뜨면 기존 자격 증명을 고르거나 새로 만듭니다. API 키는 채팅창에 쓰지 말고 카드가 여는 자격 증명 화면에만 넣으세요.
  5. 발행을 승인하기 전에 만들어진 노드를 하나씩 열어 봅니다. Assistant는 발행이나 삭제처럼 영향이 큰 동작 앞에서 먼저 확인을 묻습니다. 발행하면 실제 문의 메일마다 워크플로가 돌기 시작하니 시험 실행 결과를 보기 전에는 승인하지 마세요.

2단계에 넣을 메시지 예시입니다.

새 문의 메일이 오면 Gemini 4 Argon으로 내용을 세 줄로 요약해 주세요.
요약은 구글 시트에 한 줄씩 쌓고, 실패하면 저에게 메일로 알려 주세요.
워크플로를 발행하기 전에 꼭 저에게 물어봐 주세요.

4. 일꾼 세우기: 에이전트

정해진 노선만 도는 버스가 워크플로라면, 목적지만 듣고 길을 고르는 택시도 있습니다. 모델에 목표와 도구를 주면 어떤 도구를 언제 쓰고 언제 멈출지 스스로 정합니다. 이런 일꾼을 에이전트라고 부릅니다.

따라 하기
  1. 프로젝트를 고른 뒤 Agents 탭에서 Create Agent를 누릅니다. 빈 초안이 담긴 Agent Builder가 열리면 제대로 들어온 상태입니다.
  2. Agent 탭에 이름을 적고 모델 칸에서 제공자와 모델을 차례로 골라 Gemini 4 Argon을 지정합니다. 자격 증명을 물으면 첫 묶음에서 만든 자격 증명을 넣고 Cloud라면 Gateway 크레딧을 써도 됩니다.
  3. Instructions 칸에 역할, 말투, 하지 말아야 할 일, 먼저 쓸 도구를 적습니다. 신입에게 건네는 업무 안내서라고 보면 쉽습니다.
  4. Tools 영역의 Add tool로 도구를 붙입니다. n8n 연동, 같은 프로젝트의 워크플로, MCP 서버 가운데서 고를 수 있습니다.
  5. 머리말의 Preview를 눌러 발행 전 초안과 대화해 봅니다. 버튼이 눌리지 않으면 화면에 뜬 설정 오류부터 고치세요.
  6. 답이 마음에 들 때만 Publish를 누릅니다. 발행하면 그 순간의 초안이 사진처럼 저장되고 사용자와 채널에는 그 버전만 돕니다.

기존 워크플로에 넣으려면 발행한 에이전트를 Message an Agent 노드로 부르거나, AI Agent 노드의 모델 자리에 Google Gemini Chat Model을 이으면 됩니다.

5. 바깥 도구와 잇기: MCP

이번엔 방향이 반대입니다. 바깥 AI 도구가 n8n에 들어와 워크플로를 짓습니다. Gemini 4 Argon을 고를 수 있다고 확인된 바깥 도구는 GitHub Copilot이라 VS Code의 Copilot을 예로 듭니다.

따라 하기
  1. 소유자나 관리자 계정일 때만 됩니다. Settings의 Instance-level MCP로 가서 Enable MCP access를 고르세요. 연결된 도구가 워크플로를 만들고 고칠 수 있게 되니, 업무용 인스턴스라면 시험용에서 먼저 켜 보세요.
  2. Connection details의 Connect를 눌러 Connect a client 창을 엽니다. Server URL이 /mcp-server/http로 끝나면 제대로 찾은 주소입니다.
  3. OAuth (recommended) 탭의 Your client 목록에서 VS Code를 고르고 안내대로 등록합니다. OAuth는 비밀번호 대신 허락만 건네는 방식입니다. 도구가 n8n 화면으로 넘겨 주면 접근을 승인하되, 운영 인스턴스라면 읽기 전용만 허락하세요.
  4. API 키 방식을 쓴다면 토큰을 그 자리에서 복사해 둡니다. API key 탭은 처음 열 때 개인 접근 토큰(내 계정 이름으로 발급되는 긴 비밀번호)을 만듭니다. 탭을 떠나면 전체 값을 다시 볼 수 없습니다.
  5. 기존 워크플로도 다루게 하려면 그 워크플로의 오른쪽 위 ... 메뉴에서 Settings를 열고 Available in MCP를 켭니다. 켜면 연결된 모든 도구가 그 워크플로를 읽고 실행하고 고칠 수 있으니, 고객 정보나 결제를 다루는 워크플로는 켜지 마세요.
  6. Copilot의 모델 선택 창에서 Gemini 4 Argon을 고릅니다(Pro+, Max, Business, Enterprise 사용자). "가입 신청이 오면 CRM에 넣고 Slack에 알리는 워크플로를 만들어 주세요"라고 부탁해 n8n 워크플로 목록에 새 워크플로가 생기면 성공입니다.

막히기 쉬운 네 군데

  • 모델 목록에 Gemini 4 Argon이 없습니다. 목록에는 내 계정이 쓸 수 있는 모델만 뜹니다. 무료 등급 키라면 유료 등급 프로젝트의 키로 바꾸고 Cloud라면 Use Gateway credits를 고르세요.
  • 회사 프록시를 거치는 망에서 노드가 Gemini에 닿지 않습니다. Gemini 관련 노드는 프록시 설정을 지원하지 않습니다. Chat Model 문서는 역방향 프록시(구글행 요청만 전하는 중계 서버) 주소를 Host에 넣으라고 합니다. 자격 증명 문서는 이를 지원하지 않는다고 적어 엇갈리니, 시험해 보고 쓰세요.
  • 자체 호스팅 Assistant 설정에 Gemini가 없습니다. 제공자가 Anthropic, OpenAI, OpenRouter뿐이니 모델 지정법이 문서에 나온 OpenRouter를 거치세요. .env의 N8N_INSTANCE_AI_MODEL에 openrouter/로 시작하는 Gemini 4 Argon 모델 이름을, N8N_INSTANCE_AI_MODEL_API_KEY에 OpenRouter 키를 넣고 다시 시작합니다. 모델 변수를 빠뜨리면 기본값 anthropic/claude-opus-4-8이 그대로 갑니다.
  • MCP로 이은 도구가 기존 워크플로를 못 찾습니다. MCP를 켜도 처음엔 어떤 워크플로도 열려 있지 않습니다. 워크플로마다 Available in MCP를 켜거나, Instance-level MCP의 Workflows enabled에서 Enable workflows로 고르세요.

여기서 더 나아가려면

에이전트가 바깥 MCP 서버의 도구를 쓰게 하려면 AI Agent 노드에 MCP Client Tool 노드를 이어 보세요. 12월 1일부터 요금이 두 배가 되니 Chat Model의 Maximum Number of Tokens로 답 길이를 묶어 두면 비용을 가늠하기 쉽습니다.

이상으로 글 마치겠습니다.

출처

#n8n#Gemini 4 Argon#n8n Agents#n8n Assistant#MCP#워크플로 자동화#자격 증명

같은 분류의 글