InfoGrab DocsInfoGrab Docs

환경설정(Preferences)

요약

환경설정(Preferences)은 "항상 오류 워크플로를 연결해 줘"처럼 한 번 작성해 두는 짧은 지침입니다. 환경설정은 다음 플랜에서 사용할 수 있습니다. 환경설정은 아직 n8n Cloud Enterprise와 셀프 호스팅 Enterprise에서는 사용할 수 없습니다.

환경설정(Preferences)은 "항상 오류 워크플로를 연결해 줘"처럼 한 번 작성해 두는 짧은 지침입니다. n8n Assistant와 연결된 MCP 클라이언트는 사용자를 위해 워크플로와 에이전트를 만들 때마다 이 지침을 적용합니다.

Note

기능 사용 가능 여부

환경설정은 다음 플랜에서 사용할 수 있습니다.

  • n8n Cloud: Starter, Pro
  • 셀프 호스팅: Community, Registered Community, Business

환경설정은 아직 n8n Cloud Enterprise와 셀프 호스팅 Enterprise에서는 사용할 수 없습니다.

환경설정은 n8n 2.40.0부터 사용할 수 있습니다. n8n Assistant에서 환경설정을 저장하는 기능과 n8n MCP 서버의 환경설정 도구는 n8n 2.42.0부터 사용할 수 있습니다.

Note

프리뷰 상태

환경설정은 에이전트 컨텍스트 관리(agentic context management)의 일부이며, 에이전트 컨텍스트 관리는 프리뷰(Preview) 단계라서 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 환경에서는 의존하지 않는 것이 좋습니다.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

환경설정의 용도#

현재 작업뿐 아니라 모든 작업에서 AI 도구가 따르기를 원하는 규칙에 환경설정을 사용합니다. 다음과 같은 내용이 좋은 환경설정입니다.

  • 노드와 자격 증명 선택: "알림에는 이름이 ops-bot인 Slack 자격 증명을 사용해 줘."
  • 이름 규칙: "노드 이름은 동사로 시작하는 영어로 지어 줘."
  • 작업 정리 방식: "새 워크플로는 Drafts 폴더에 넣어 줘."
  • 피해야 할 패턴: "기본 제공 노드로 처리할 수 있는 작업에는 Code 노드를 사용하지 마."
  • 소통 방식: "변경 사항은 두 문장 이내로 설명해 줘."

현재 작업에 대한 지시는 프롬프트에 작성합니다. "이번 것만 POST 요청으로 만들어 줘"는 환경설정이 아니라 채팅에 속합니다.

n8n이 환경설정을 적용하는 위치#

다음 두 AI 화면이 환경설정을 읽습니다.

화면 환경설정을 읽는 시점
n8n Assistant 메시지를 보낼 때마다 읽습니다. 따라서 저장하거나 수정한 환경설정은 이미 열려 있는 대화에서도 다음 메시지부터 적용됩니다.
n8n MCP 서버에 연결된 MCP 클라이언트 클라이언트가 get_user_preferences 도구를 호출할 때 읽습니다. n8n MCP 서버는 클라이언트에 n8n에서 무언가를 만들거나 변경하기 전에 이 도구를 호출하도록 안내합니다.

환경설정이 사용자가 직접 요청한 내용과 충돌하면 AI 도구는 사용자의 요청을 따르고, 어떤 환경설정을 제외했는지 알려 줍니다.

환경설정 범위#

환경설정의 범위(scope)는 환경설정이 적용되는 대상을 결정합니다. 환경설정을 만들거나 수정할 때 Scope 필드에서 범위를 선택합니다.

범위 레이블 적용 대상 생성, 수정, 삭제 가능한 사용자
Just you · All projects 모든 프로젝트에서 사용자 본인에게만 적용 사용자 본인
Just you · Personal project 개인 프로젝트에서 작업할 때 사용자 본인에게만 적용 사용자 본인
팀 프로젝트 이름(목록에서는 Project로 표시) 해당 프로젝트에서 작업하는 모든 사용자 프로젝트 관리자와 프로젝트 편집자. 프로젝트 뷰어는 볼 수만 있고 변경할 수 없습니다.
Global 인스턴스의 모든 사용자 인스턴스 소유자와 관리자

n8n은 범위에 해당하는 모든 환경설정을 한꺼번에 적용합니다. 대화에서 n8n Assistant는 Global 환경설정, 사용자 본인의 환경설정, 그리고 대화를 연 프로젝트의 환경설정을 받습니다. MCP 클라이언트는 Global 환경설정, 사용자 본인의 환경설정, 그리고 사용자가 읽을 수 있는 모든 프로젝트의 환경설정을 프로젝트별로 묶어서 받습니다. projectId를 전달하는 클라이언트는 모든 프로젝트 대신 해당 프로젝트 한 곳의 환경설정만 받습니다.

환경설정을 다른 범위로 옮기려면 이전 범위에서 삭제할 권한과 새 범위에서 생성할 권한이 모두 필요합니다.

환경설정 제한#

제한 값
환경설정 하나의 길이 2,000자
하나의 범위에 둘 수 있는 환경설정 수 50개
하나의 범위 내 중복 텍스트 허용되지 않습니다. 같은 범위에 이미 저장된 환경설정과 텍스트가 같은 환경설정은 n8n이 거부합니다.

범위가 가득 차면 다른 환경설정을 추가하기 전에 환경설정 하나를 삭제합니다.

설정에서 환경설정 만들기#

  1. Settings > Context를 선택합니다.
  2. Preferences를 선택합니다.
  3. Create preference를 선택합니다.
  4. Preference에 지침을 작성합니다. 동료에게 말하듯이 작성합니다. 예: "항상 오류 워크플로를 연결해서, 무언가 실패하면 Slack으로 알림을 받을 수 있게 해 줘".
  5. Scope에서 환경설정을 적용할 대상을 선택합니다. 각 옵션은 환경설정 범위를 참조하세요.
  6. Save를 선택합니다.

n8n Assistant는 다음 메시지부터 새 환경설정을 적용합니다. MCP 클라이언트는 다음에 get_user_preferences를 호출할 때 적용합니다.

설정에서 환경설정 수정 또는 삭제하기#

Settings > Context > Preferences에는 사용자가 볼 수 있는 모든 환경설정이 나열됩니다. 목록에는 각 환경설정의 Scope, Created by, Last updated 값이 표시됩니다. Created by에는 환경설정을 만든 사람의 이름이 표시되며, AI 도구가 저장한 경우에는 이름 뒤 괄호 안에 출처가 표시됩니다. 예: "Jane Doe (MCP)", "Jane Doe (n8n assistant)".

  • 환경설정을 수정하려면: 환경설정의 Options 메뉴를 열고 Edit를 선택한 다음, 텍스트나 범위를 변경하고 Save를 선택합니다.
  • 환경설정을 삭제하려면: 환경설정의 Options 메뉴를 열고 Delete를 선택합니다.
  • 환경설정 여러 개를 삭제하려면: 목록에서 해당 환경설정을 선택한 다음 Delete selected를 선택합니다.

삭제는 되돌릴 수 없습니다. n8n Assistant와 MCP 클라이언트는 삭제된 환경설정을 즉시 사용하지 않습니다.

환경설정을 변경할 권한이 없으면 n8n은 해당 환경설정을 읽기 전용으로 표시합니다.

n8n Assistant에서 환경설정 저장하기#

"앞으로는 항상 오류 워크플로를 추가해 줘"처럼 n8n Assistant에 지속적으로 적용할 규칙을 알려 주면, n8n Assistant는 그 규칙을 Just you · All projects 범위의 환경설정으로 저장합니다. 현재 작업에만 해당하는 일회성 지시는 저장하지 않습니다.

n8n Assistant가 환경설정을 저장하면 채팅에 저장된 텍스트가 담긴 카드가 표시됩니다. 이 카드에서 다음을 할 수 있습니다.

  • Edit를 선택해 텍스트나 범위를 변경합니다.
  • Edit preference 대화 상자에서 Remove preference를 선택해 환경설정을 삭제합니다.

n8n Assistant가 가장 최근 답변에 적용한 환경설정을 확인하려면 채팅 입력창의 + 메뉴를 열고 Preferences를 선택합니다.

인스턴스 소유자와 관리자는 n8n Assistant가 환경설정을 저장할 수 있는지 여부를 제어합니다. Settings > Assistant > Permissions에서 Save preferences from chat을 Allow(기본값) 또는 Block으로 설정합니다. Block으로 설정하면 n8n Assistant는 저장된 환경설정을 계속 적용하지만 새 환경설정은 저장할 수 없습니다.

MCP 클라이언트에서 환경설정 저장하기#

n8n MCP 서버에 연결된 MCP 클라이언트는 네 가지 도구로 환경설정을 읽고 저장할 수 있습니다.

도구 기능
get_user_preferences 사용자에게 적용되는 환경설정을 읽습니다
save_user_preference Just you · All projects 범위로 새 환경설정을 저장합니다
update_user_preference 환경설정의 텍스트, 범위 또는 둘 다 변경합니다
undo_user_preference MCP 클라이언트가 사용자를 위해 저장한 환경설정을 제거합니다

undo_user_preference는 설정에서 직접 작성한 환경설정, 프로젝트용으로 저장된 환경설정, 인스턴스 전체용으로 저장된 환경설정은 제거할 수 없습니다. 이러한 환경설정은 Settings > Context > Preferences에서 제거합니다.

MCP 클라이언트가 MCP 엘리시테이션(elicitation)을 지원하는 경우, save_user_preference가 환경설정을 저장한 후 n8n이 검토 양식을 표시합니다. 이 양식에서 다음을 할 수 있습니다.

  • 표시된 텍스트를 그대로 수락하거나 먼저 수정합니다.
  • 인스턴스 소유자 또는 관리자라면 범위를 Everyone on this n8n instance로 변경합니다.
  • 양식을 거부해 환경설정을 제거합니다.

응답하지 않고 양식을 닫으면 환경설정은 저장된 상태로 유지됩니다.

환경설정에 대한 MCP 클라이언트 권한#

OAuth로 MCP 클라이언트를 연결하면 n8n은 환경설정에 대한 두 가지 권한을 승인하도록 요청합니다.

동의 화면의 권한 OAuth 스코프 도구
Read AI preferences aiPreference:read get_user_preferences
Save, update and undo AI preferences aiPreference:write save_user_preference, update_user_preference, undo_user_preference

n8n은 인스턴스에서 환경설정이 켜져 있을 때만 이러한 권한을 제공합니다. 환경설정이 켜지기 전에 클라이언트를 연결했다면, 권한을 부여하기 위해 클라이언트를 다시 연결합니다. 클라이언트 액세스 검토 및 해지를 참조하세요.

각 도구의 파라미터와 출력은 MCP 서버 도구 레퍼런스의 사용자 환경설정을 참조하세요.

효과적인 환경설정 작성하기#

AI 도구는 환경설정을 해당 범위의 모든 작업에 적용하므로, 어떤 작업에서도 문제없이 통하도록 작성합니다.

  • 환경설정 하나에 규칙 하나를 작성합니다. 규칙 하나가 여러 규칙이 섞인 문단보다 나중에 수정하거나 삭제하기 쉽습니다.
  • 무엇을 해야 하는지 쓰고, 도움이 된다면 이유도 씁니다. "올바른 자격 증명을 사용해 줘"보다 "고객 이메일에는 이름이 support-inbox인 Gmail 자격 증명을 사용해 줘"가 낫습니다.
  • 노드, 자격 증명, 폴더, 프로젝트의 정확한 이름을 씁니다. AI 도구는 이름을 정확히 일치시켜 찾습니다.
  • 하나의 워크플로에만 맞는 규칙은 피합니다. 이러한 규칙은 프롬프트에 넣습니다.
이렇게 쓰는 대신 이렇게 작성합니다
"웹훅 경로를 /orders로 해 줘." 프롬프트에 둡니다. 하나의 워크플로에만 적용되는 내용입니다.
"오류에 주의해 줘." "새 워크플로는 모두 Error alerts 오류 워크플로에 연결해 줘."
"이름을 잘 짓고, 폴더에 정리하고, Code 노드는 피해 줘." 환경설정 세 개로 나눕니다. 이름 규칙 하나, 폴더 하나, Code 노드 하나입니다.

셀프 호스팅 인스턴스에서 환경설정 켜기#

환경설정은 기본적으로 켜져 있습니다. 인스턴스의 텔레메트리가 꺼져 있거나(N8N_DIAGNOSTICS_ENABLED=false) n8n의 기능 플래그 서비스에 연결할 수 없으면 환경설정은 꺼진 상태로 유지됩니다.

환경설정을 켜려면 N8N_FEATURE_FLAG_OVERRIDES를 설정합니다. 예를 들어 .env 파일에 다음 값을 추가합니다. JSON 객체의 다른 항목은 그대로 유지합니다.

N8N_FEATURE_FLAG_OVERRIDES='{"111_context_preferences":"variant"}'

변경 사항을 적용하려면 n8n을 재시작합니다.

값은 문자열 "variant"여야 합니다. true 같은 불리언 값으로는 환경설정이 켜지지 않습니다.

환경설정이 꺼져 있으면 n8n은 Settings > Context에서 Preferences를 숨기고, n8n Assistant는 환경설정을 읽거나 저장하지 않으며, n8n MCP 서버는 환경설정 도구를 제공하지 않습니다. n8n은 이전에 저장된 환경설정을 유지하고, 환경설정을 다시 켜면 그 환경설정을 다시 적용합니다.

환경설정 문제 해결#

설정에 Preferences가 나타나지 않습니다#

인스턴스가 n8n 2.40.0 이상을 실행 중인지, 그리고 Enterprise 플랜이 아닌지 확인합니다. 텔레메트리가 꺼진 셀프 호스팅 인스턴스라면 셀프 호스팅 인스턴스에서 환경설정 켜기를 참조하세요.

MCP 클라이언트에 환경설정 도구가 표시되지 않습니다#

인스턴스에서 환경설정이 켜져 있는지 확인한 다음, 클라이언트에 Read AI preferences와 Save, update and undo AI preferences 권한이 있는지 확인합니다. 환경설정이 켜지기 전에 클라이언트를 연결했다면 클라이언트의 액세스를 해지한 다음 다시 연결합니다.

n8n Assistant가 환경설정 저장이 차단되었다고 알려 줍니다#

인스턴스 소유자 또는 관리자가 Settings > Assistant > Permissions에서 Save preferences from chat을 Block으로 설정했거나, 인스턴스가 보호된 소스 컨트롤 브랜치에 연결되어 있습니다. 권한이 있다면 Settings > Context > Preferences에서 환경설정을 대신 만듭니다.

AI 도구가 환경설정을 무시합니다#

환경설정의 범위가 작업 중인 프로젝트를 포함하는지 확인합니다. n8n Assistant에서는 팀 프로젝트의 환경설정이 해당 프로젝트에서 연 대화에만 적용됩니다. 환경설정이 프롬프트와 충돌하면 AI 도구는 프롬프트를 따릅니다.

관련 리소스#

환경설정(Preferences)

n8n v2.47
원문 보기

요약

환경설정(Preferences)은 "항상 오류 워크플로를 연결해 줘"처럼 한 번 작성해 두는 짧은 지침입니다. 환경설정은 다음 플랜에서 사용할 수 있습니다. 환경설정은 아직 n8n Cloud Enterprise와 셀프 호스팅 Enterprise에서는 사용할 수 없습니다.

환경설정(Preferences)은 "항상 오류 워크플로를 연결해 줘"처럼 한 번 작성해 두는 짧은 지침입니다. n8n Assistant와 연결된 MCP 클라이언트는 사용자를 위해 워크플로와 에이전트를 만들 때마다 이 지침을 적용합니다.

Note

기능 사용 가능 여부

환경설정은 다음 플랜에서 사용할 수 있습니다.

  • n8n Cloud: Starter, Pro
  • 셀프 호스팅: Community, Registered Community, Business

환경설정은 아직 n8n Cloud Enterprise와 셀프 호스팅 Enterprise에서는 사용할 수 없습니다.

환경설정은 n8n 2.40.0부터 사용할 수 있습니다. n8n Assistant에서 환경설정을 저장하는 기능과 n8n MCP 서버의 환경설정 도구는 n8n 2.42.0부터 사용할 수 있습니다.

Note

프리뷰 상태

환경설정은 에이전트 컨텍스트 관리(agentic context management)의 일부이며, 에이전트 컨텍스트 관리는 프리뷰(Preview) 단계라서 향후 릴리즈에서 변경될 수 있습니다. 프로덕션 환경에서는 의존하지 않는 것이 좋습니다.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

환경설정의 용도#

현재 작업뿐 아니라 모든 작업에서 AI 도구가 따르기를 원하는 규칙에 환경설정을 사용합니다. 다음과 같은 내용이 좋은 환경설정입니다.

  • 노드와 자격 증명 선택: "알림에는 이름이 ops-bot인 Slack 자격 증명을 사용해 줘."
  • 이름 규칙: "노드 이름은 동사로 시작하는 영어로 지어 줘."
  • 작업 정리 방식: "새 워크플로는 Drafts 폴더에 넣어 줘."
  • 피해야 할 패턴: "기본 제공 노드로 처리할 수 있는 작업에는 Code 노드를 사용하지 마."
  • 소통 방식: "변경 사항은 두 문장 이내로 설명해 줘."

현재 작업에 대한 지시는 프롬프트에 작성합니다. "이번 것만 POST 요청으로 만들어 줘"는 환경설정이 아니라 채팅에 속합니다.

n8n이 환경설정을 적용하는 위치#

다음 두 AI 화면이 환경설정을 읽습니다.

화면 환경설정을 읽는 시점
n8n Assistant 메시지를 보낼 때마다 읽습니다. 따라서 저장하거나 수정한 환경설정은 이미 열려 있는 대화에서도 다음 메시지부터 적용됩니다.
n8n MCP 서버에 연결된 MCP 클라이언트 클라이언트가 get_user_preferences 도구를 호출할 때 읽습니다. n8n MCP 서버는 클라이언트에 n8n에서 무언가를 만들거나 변경하기 전에 이 도구를 호출하도록 안내합니다.

환경설정이 사용자가 직접 요청한 내용과 충돌하면 AI 도구는 사용자의 요청을 따르고, 어떤 환경설정을 제외했는지 알려 줍니다.

환경설정 범위#

환경설정의 범위(scope)는 환경설정이 적용되는 대상을 결정합니다. 환경설정을 만들거나 수정할 때 Scope 필드에서 범위를 선택합니다.

범위 레이블 적용 대상 생성, 수정, 삭제 가능한 사용자
Just you · All projects 모든 프로젝트에서 사용자 본인에게만 적용 사용자 본인
Just you · Personal project 개인 프로젝트에서 작업할 때 사용자 본인에게만 적용 사용자 본인
팀 프로젝트 이름(목록에서는 Project로 표시) 해당 프로젝트에서 작업하는 모든 사용자 프로젝트 관리자와 프로젝트 편집자. 프로젝트 뷰어는 볼 수만 있고 변경할 수 없습니다.
Global 인스턴스의 모든 사용자 인스턴스 소유자와 관리자

n8n은 범위에 해당하는 모든 환경설정을 한꺼번에 적용합니다. 대화에서 n8n Assistant는 Global 환경설정, 사용자 본인의 환경설정, 그리고 대화를 연 프로젝트의 환경설정을 받습니다. MCP 클라이언트는 Global 환경설정, 사용자 본인의 환경설정, 그리고 사용자가 읽을 수 있는 모든 프로젝트의 환경설정을 프로젝트별로 묶어서 받습니다. projectId를 전달하는 클라이언트는 모든 프로젝트 대신 해당 프로젝트 한 곳의 환경설정만 받습니다.

환경설정을 다른 범위로 옮기려면 이전 범위에서 삭제할 권한과 새 범위에서 생성할 권한이 모두 필요합니다.

환경설정 제한#

제한 값
환경설정 하나의 길이 2,000자
하나의 범위에 둘 수 있는 환경설정 수 50개
하나의 범위 내 중복 텍스트 허용되지 않습니다. 같은 범위에 이미 저장된 환경설정과 텍스트가 같은 환경설정은 n8n이 거부합니다.

범위가 가득 차면 다른 환경설정을 추가하기 전에 환경설정 하나를 삭제합니다.

설정에서 환경설정 만들기#

  1. Settings > Context를 선택합니다.
  2. Preferences를 선택합니다.
  3. Create preference를 선택합니다.
  4. Preference에 지침을 작성합니다. 동료에게 말하듯이 작성합니다. 예: "항상 오류 워크플로를 연결해서, 무언가 실패하면 Slack으로 알림을 받을 수 있게 해 줘".
  5. Scope에서 환경설정을 적용할 대상을 선택합니다. 각 옵션은 환경설정 범위를 참조하세요.
  6. Save를 선택합니다.

n8n Assistant는 다음 메시지부터 새 환경설정을 적용합니다. MCP 클라이언트는 다음에 get_user_preferences를 호출할 때 적용합니다.

설정에서 환경설정 수정 또는 삭제하기#

Settings > Context > Preferences에는 사용자가 볼 수 있는 모든 환경설정이 나열됩니다. 목록에는 각 환경설정의 Scope, Created by, Last updated 값이 표시됩니다. Created by에는 환경설정을 만든 사람의 이름이 표시되며, AI 도구가 저장한 경우에는 이름 뒤 괄호 안에 출처가 표시됩니다. 예: "Jane Doe (MCP)", "Jane Doe (n8n assistant)".

  • 환경설정을 수정하려면: 환경설정의 Options 메뉴를 열고 Edit를 선택한 다음, 텍스트나 범위를 변경하고 Save를 선택합니다.
  • 환경설정을 삭제하려면: 환경설정의 Options 메뉴를 열고 Delete를 선택합니다.
  • 환경설정 여러 개를 삭제하려면: 목록에서 해당 환경설정을 선택한 다음 Delete selected를 선택합니다.

삭제는 되돌릴 수 없습니다. n8n Assistant와 MCP 클라이언트는 삭제된 환경설정을 즉시 사용하지 않습니다.

환경설정을 변경할 권한이 없으면 n8n은 해당 환경설정을 읽기 전용으로 표시합니다.

n8n Assistant에서 환경설정 저장하기#

"앞으로는 항상 오류 워크플로를 추가해 줘"처럼 n8n Assistant에 지속적으로 적용할 규칙을 알려 주면, n8n Assistant는 그 규칙을 Just you · All projects 범위의 환경설정으로 저장합니다. 현재 작업에만 해당하는 일회성 지시는 저장하지 않습니다.

n8n Assistant가 환경설정을 저장하면 채팅에 저장된 텍스트가 담긴 카드가 표시됩니다. 이 카드에서 다음을 할 수 있습니다.

  • Edit를 선택해 텍스트나 범위를 변경합니다.
  • Edit preference 대화 상자에서 Remove preference를 선택해 환경설정을 삭제합니다.

n8n Assistant가 가장 최근 답변에 적용한 환경설정을 확인하려면 채팅 입력창의 + 메뉴를 열고 Preferences를 선택합니다.

인스턴스 소유자와 관리자는 n8n Assistant가 환경설정을 저장할 수 있는지 여부를 제어합니다. Settings > Assistant > Permissions에서 Save preferences from chat을 Allow(기본값) 또는 Block으로 설정합니다. Block으로 설정하면 n8n Assistant는 저장된 환경설정을 계속 적용하지만 새 환경설정은 저장할 수 없습니다.

MCP 클라이언트에서 환경설정 저장하기#

n8n MCP 서버에 연결된 MCP 클라이언트는 네 가지 도구로 환경설정을 읽고 저장할 수 있습니다.

도구 기능
get_user_preferences 사용자에게 적용되는 환경설정을 읽습니다
save_user_preference Just you · All projects 범위로 새 환경설정을 저장합니다
update_user_preference 환경설정의 텍스트, 범위 또는 둘 다 변경합니다
undo_user_preference MCP 클라이언트가 사용자를 위해 저장한 환경설정을 제거합니다

undo_user_preference는 설정에서 직접 작성한 환경설정, 프로젝트용으로 저장된 환경설정, 인스턴스 전체용으로 저장된 환경설정은 제거할 수 없습니다. 이러한 환경설정은 Settings > Context > Preferences에서 제거합니다.

MCP 클라이언트가 MCP 엘리시테이션(elicitation)을 지원하는 경우, save_user_preference가 환경설정을 저장한 후 n8n이 검토 양식을 표시합니다. 이 양식에서 다음을 할 수 있습니다.

  • 표시된 텍스트를 그대로 수락하거나 먼저 수정합니다.
  • 인스턴스 소유자 또는 관리자라면 범위를 Everyone on this n8n instance로 변경합니다.
  • 양식을 거부해 환경설정을 제거합니다.

응답하지 않고 양식을 닫으면 환경설정은 저장된 상태로 유지됩니다.

환경설정에 대한 MCP 클라이언트 권한#

OAuth로 MCP 클라이언트를 연결하면 n8n은 환경설정에 대한 두 가지 권한을 승인하도록 요청합니다.

동의 화면의 권한 OAuth 스코프 도구
Read AI preferences aiPreference:read get_user_preferences
Save, update and undo AI preferences aiPreference:write save_user_preference, update_user_preference, undo_user_preference

n8n은 인스턴스에서 환경설정이 켜져 있을 때만 이러한 권한을 제공합니다. 환경설정이 켜지기 전에 클라이언트를 연결했다면, 권한을 부여하기 위해 클라이언트를 다시 연결합니다. 클라이언트 액세스 검토 및 해지를 참조하세요.

각 도구의 파라미터와 출력은 MCP 서버 도구 레퍼런스의 사용자 환경설정을 참조하세요.

효과적인 환경설정 작성하기#

AI 도구는 환경설정을 해당 범위의 모든 작업에 적용하므로, 어떤 작업에서도 문제없이 통하도록 작성합니다.

  • 환경설정 하나에 규칙 하나를 작성합니다. 규칙 하나가 여러 규칙이 섞인 문단보다 나중에 수정하거나 삭제하기 쉽습니다.
  • 무엇을 해야 하는지 쓰고, 도움이 된다면 이유도 씁니다. "올바른 자격 증명을 사용해 줘"보다 "고객 이메일에는 이름이 support-inbox인 Gmail 자격 증명을 사용해 줘"가 낫습니다.
  • 노드, 자격 증명, 폴더, 프로젝트의 정확한 이름을 씁니다. AI 도구는 이름을 정확히 일치시켜 찾습니다.
  • 하나의 워크플로에만 맞는 규칙은 피합니다. 이러한 규칙은 프롬프트에 넣습니다.
이렇게 쓰는 대신 이렇게 작성합니다
"웹훅 경로를 /orders로 해 줘." 프롬프트에 둡니다. 하나의 워크플로에만 적용되는 내용입니다.
"오류에 주의해 줘." "새 워크플로는 모두 Error alerts 오류 워크플로에 연결해 줘."
"이름을 잘 짓고, 폴더에 정리하고, Code 노드는 피해 줘." 환경설정 세 개로 나눕니다. 이름 규칙 하나, 폴더 하나, Code 노드 하나입니다.

셀프 호스팅 인스턴스에서 환경설정 켜기#

환경설정은 기본적으로 켜져 있습니다. 인스턴스의 텔레메트리가 꺼져 있거나(N8N_DIAGNOSTICS_ENABLED=false) n8n의 기능 플래그 서비스에 연결할 수 없으면 환경설정은 꺼진 상태로 유지됩니다.

환경설정을 켜려면 N8N_FEATURE_FLAG_OVERRIDES를 설정합니다. 예를 들어 .env 파일에 다음 값을 추가합니다. JSON 객체의 다른 항목은 그대로 유지합니다.

N8N_FEATURE_FLAG_OVERRIDES='{"111_context_preferences":"variant"}'

변경 사항을 적용하려면 n8n을 재시작합니다.

값은 문자열 "variant"여야 합니다. true 같은 불리언 값으로는 환경설정이 켜지지 않습니다.

환경설정이 꺼져 있으면 n8n은 Settings > Context에서 Preferences를 숨기고, n8n Assistant는 환경설정을 읽거나 저장하지 않으며, n8n MCP 서버는 환경설정 도구를 제공하지 않습니다. n8n은 이전에 저장된 환경설정을 유지하고, 환경설정을 다시 켜면 그 환경설정을 다시 적용합니다.

환경설정 문제 해결#

설정에 Preferences가 나타나지 않습니다#

인스턴스가 n8n 2.40.0 이상을 실행 중인지, 그리고 Enterprise 플랜이 아닌지 확인합니다. 텔레메트리가 꺼진 셀프 호스팅 인스턴스라면 셀프 호스팅 인스턴스에서 환경설정 켜기를 참조하세요.

MCP 클라이언트에 환경설정 도구가 표시되지 않습니다#

인스턴스에서 환경설정이 켜져 있는지 확인한 다음, 클라이언트에 Read AI preferences와 Save, update and undo AI preferences 권한이 있는지 확인합니다. 환경설정이 켜지기 전에 클라이언트를 연결했다면 클라이언트의 액세스를 해지한 다음 다시 연결합니다.

n8n Assistant가 환경설정 저장이 차단되었다고 알려 줍니다#

인스턴스 소유자 또는 관리자가 Settings > Assistant > Permissions에서 Save preferences from chat을 Block으로 설정했거나, 인스턴스가 보호된 소스 컨트롤 브랜치에 연결되어 있습니다. 권한이 있다면 Settings > Context > Preferences에서 환경설정을 대신 만듭니다.

AI 도구가 환경설정을 무시합니다#

환경설정의 범위가 작업 중인 프로젝트를 포함하는지 확인합니다. n8n Assistant에서는 팀 프로젝트의 환경설정이 해당 프로젝트에서 연 대화에만 적용됩니다. 환경설정이 프롬프트와 충돌하면 AI 도구는 프롬프트를 따릅니다.

관련 리소스#