Zaru 실행마다 필요한 연결만 주기

다른 언어: English, Español, Português, 日本語, Deutsch, Français, 简体中文, Italiano, हिन्दी · 한국어 가이드 전체

공개: Zaru는 100monkeys AI, Inc.가 만들고 있으므로 이 가이드는 만든 쪽의 설명으로 읽어 주세요. 이 가이드는 저희 AI 에이전트 하나가 2026년 10월 29일에 읽은 Zaru 문서(영어)의 Profiles 페이지와 이 사이트의 문구를 바탕으로 초안을 쓰고 회사가 검토했으며, 이 한국어판은 영어 원문 가이드의 번역입니다. 아래에 인용한 규칙과 메시지는 모두 그 페이지의 것이며, 인용은 영어 그대로 두고 옆에 번역을 붙였습니다. 페이지가 어떻게 동작하는지 말하지 않는 부분은 지어내지 않고 그렇다고 밝힙니다.

Zaru가 여러분의 메일함, 캘린더, GitHub 토큰을 갖게 되면, 어떤 대화나 실행, 일정이 그중 무엇을 건드려도 되는지가 문제가 됩니다. 프로필은 이것을 한 번의 선택으로 답합니다. 여러분의 연결과 그 연결이 쓸 수 있는 도구에 이름을 붙인 묶음입니다. 프로필도 선택한 연결도 없는 실행은 어느 연결에도 닿지 않습니다. 이 가이드는 프로필을 만들고, 도구를 좁히고, 대화, 일정, MCP 클라이언트에서 사용합니다.

프로필이란

문서의 설명: 프로필은 "your own named set of connections (a mailbox, a calendar account, a Carbon Forge (formerly Nuclear Notes) token, a GitHub token and so on, any number of any kind) with a list of the tools they may use, and optional defaults."(메일함, 캘린더 계정, Carbon Forge(옛 Nuclear Notes) 토큰, GitHub 토큰 등 종류와 개수에 상관없는 여러분만의 이름 붙은 연결 묶음으로, 그 연결이 쓸 수 있는 도구 목록과 선택적인 기본값을 함께 가집니다.) 이것을 쓸모 있게 만드는 규칙은 Profiles 페이지 자체의 목록 위에 적혀 있습니다. "A run, a schedule or an API key reaches only the connections a profile names. Without one it reaches none."(실행, 일정, API 키는 프로필이 지정한 연결에만 닿습니다. 프로필이 없으면 어디에도 닿지 않습니다.)

1단계. 계정을 만들고 쓰는 것을 연결하기

Get Zaru free를 누르세요. 가입에는 이름과 이메일만 있으면 됩니다. 사이트 설명대로 Vault에서 이메일과 캘린더를 연결하세요. 프로필에는 이미 가진 연결만 넣을 수 있으므로 먼저 연결하세요.

2단계. Vault의 Profiles 열기

목록은 /vault/profiles에 있으며, 프로필마다 연결과 도구 수를 보여 줍니다. New profile을 누르세요. 나중에 프로필을 고칠 때도 같은 양식을 씁니다.

3단계. 작업 이름을 붙이고 연결 고르기

이름은 1~64자이고 여러분의 프로필 사이에서 유일해야 합니다. 계정이 아니라 일에 맞춰 이름을 붙이세요. 문서의 예시 이름은 "Fundraising"입니다. 그다음 작업에 필요한 연결을 체크하세요. 양식은 연결을 종류별로 묶어 보여 줍니다. 나중에 취소하거나 삭제한 연결은 removed로 목록에 남고, 프로필에는 "A connection in this profile was removed."(이 프로필의 연결 하나가 제거되었습니다.)가 표시됩니다.

4단계. 도구 좁히기

각 항목은 mail.reply 같은 정확한 도구 이름이거나, carbon-forge.*처럼 <family>.*로 쓴 도구 계열입니다. 빈 목록은 "All tools these connections allow"(이 연결들이 허용하는 모든 도구)를 뜻합니다. 문서의 예시 프로필은 다음을 허용합니다.

"tools": ["carbon-forge.*", "mail.draft", "mail.reply", "mail.list", "mail.read"]

양식은 여러분의 승인을 기다리는 도구에 "Needs your approval"(승인 필요) 표시를 붙입니다. 프로필은 좁히기만 합니다. 요금제가 허용하지 않는 항목은 "A profile can only narrow the tools your plan allows; <pattern> is not one of them."(프로필은 요금제가 허용하는 도구를 좁힐 수만 있습니다. <pattern>은 그중 하나가 아닙니다.)으로 거부됩니다.

5단계. 프로필이 바꾸지 않는 것 알아 두기

프로필은 연결이 속한 계열의 도구를 다룹니다. mail.*, calendar.*, 그리고 그 밖의 것은 github.*처럼 제공자의 계열입니다. fs.*, cmd.run, web.* 같은 도구는 프로필이 다루지 않고 보안 컨텍스트만이 결정합니다. 또한 허용된 도구라도 승인 게이트를 거칩니다. mail.send, mail.reply, mail.forward, mail.delete, mail.archive는 프로필 내용과 관계없이 여러분의 답을 기다립니다. 그러니 mail.reply는 있고 mail.send는 없는 프로필은 실행이 스레드 안에서 답장하게 하되 답장마다 여러분을 기다리게 하고, 새 메시지는 즉시 거부합니다.

6단계. 기본값 더하기

선택 항목 세 개가 입력을 줄여 줍니다. 여러분의 git 저장소 바인딩 중 하나인 기본 repository, "when a Carbon Forge call names none"(Carbon Forge 호출이 워크스페이스를 지정하지 않을 때) 쓰이는 기본 Carbon Forge 워크스페이스, 그리고 이 프로필로 하는 대화를 위한 최대 4,000자의 instructions입니다. Zaru는 프로필 이름, 워크스페이스, 여러분의 지시를 전달받습니다.

7단계. 대화에서 선택하기

채팅 입력란 위의 대화 패널을 여세요. Context 섹션에는 None, 그다음 Profiles, 그다음 종류별 연결이 나옵니다. 프로필을 고르면 선택했던 연결이 해제되고, 입력란 위의 줄에 "Profile: <name>"이 표시됩니다. 프로필은 대화와 함께 저장되므로 이후의 차례와 그것이 시작한 실행도 이 프로필을 씁니다. 실행은 프로필 하나 또는 선택한 연결 중 하나만 가지며 둘 다는 가질 수 없습니다. "Choose one profile, or choose connections without a profile; not both."(프로필 하나를 고르거나, 프로필 없이 연결을 고르세요. 둘 다는 안 됩니다.)

8단계. 일정과 API 키에 쓰기

일정 양식은 프로필 또는 선택한 연결을 저장하며 둘 다는 저장하지 않고, 프로필의 저장소와 워크스페이스가 양식을 채웁니다. Settings → API Keys에서는 키마다 행에서 프로필을 고르며, 맨 앞은 None입니다. 프로필이 없는 키는 여러분의 어떤 연결에도 닿지 않습니다.

9단계. MCP 클라이언트에서 선택하기

클라이언트는 연결의 모든 요청마다 예약된 키 @profile 하나만 담은 헤더로 프로필을 보냅니다.

x-zaru-contexts: {"@profile":"0000daeb-ae45-4d06-9712-9d498a653b24"}

이 ID는 문서의 예시이니 여러분 프로필의 ID를 쓰세요. @profile을 다른 키와 함께 보내면 400으로 답합니다.

10단계. 거부 메시지 읽기

프로필이 다루는 호출은 그 순간의 프로필에 비추어 하나하나 검사됩니다. 프로필 밖의 도구는 TOOL_NOT_IN_PROFILE로 거부됩니다. "This tool is not in the profile chosen for this run."(이 도구는 이 실행에 선택된 프로필에 없습니다.) Zaru Web은 프로필로 가는 링크가 있는 카드를 보여 주므로, 도구를 추가하거나 그대로 둘 수 있습니다. 다른 실행이 시작한 실행은 시작한 실행이 고른 연결을 결코 넘어서지 않습니다. 프로필이 있는 실행에서 고른 "Always allow"(항상 허용)는 그 프로필에만 적용되며, 프로필을 삭제하면 취소됩니다.

문서가 말하지 않는 것

MCP 헤더에 넣을 프로필 ID를 찾는 곳. REST 응답에는 들어 있지만, Zaru Web이 보여 주는지는 페이지에 없습니다.
MCP 클라이언트의 설정에서 프로필을 고르는 방법. 헤더의 형태는 나오지만 클라이언트 설정은 나오지 않습니다.
프로필을 고치면 이미 진행 중인 실행이 바뀌는지. 호출은 "as it stands at that moment"(그 순간의 상태로) 검사되지만, 연결은 시작할 때 실행의 것이 됩니다.
이 사이트는 프로필을 언급하지 않습니다. 문서가 유일한 출처입니다.