연결과 인증

연결 열쇠를 만들고 허용 범위를 고르고 환경변수로 쓰는 방법입니다.

연결 화면 찾기

외부 AI 도구가 내 계정의 기능을 쓰려면 연결 열쇠가 필요합니다. 설정의 AI 도구 연결 화면(/settings/connections)에서 만들고 관리합니다. 계정 메뉴의 설정에서 들어갑니다.

화면은 위에서 아래로 이렇게 구성됩니다.

이름을 적습니다. 어느 도구나 기기에서 쓰는지 알아볼 수 있게 1~128자로 적습니다.
허용할 기능에서 필요한 것만 체크합니다. 체크하지 않은 기능은 이 열쇠로 열리지 않습니다. 하나도 고르지 않으면 만들 수 없습니다.
만료를 고릅니다. 30일 뒤 만료(기본)와 90일 뒤 만료가 있고, 만료 없는 열쇠는 만들 수 없습니다.
필요하면 지출 한도 (체리) 와 한도 기간 (UTC 기준) 을 정합니다. 기간은 하루 또는 한 달입니다. 비워 두면 한도가 없습니다.
연결 열쇠 만들기를 누릅니다.

만들어지면 열쇠 값이 한 번만 보입니다. 연결 열쇠 복사로 복사한 뒤 복사했어요, 닫기를 누르세요. 닫거나 새로고침하면 다시 볼 수 없습니다. 값은 mzpt_로 시작합니다.

주의

열쇠 값을 잃어버리면 복구할 수 없습니다. 새 열쇠를 만들고 이전 열쇠는 끊으세요.

허용 범위는 열쇠마다 정합니다. 체크 항목의 이름과 설명은 화면 그대로입니다.

기능별 호출 한도와 도구 목록은 도구와 안전장치와 로그인과 키에 있습니다.

설정 코드에는 열쇠 값을 직접 쓰지 않고 이름만 적습니다. 이 이름은 MELLOWZ_STUDIO_TOKEN입니다.

연결 화면의 AI 도구에 연결하기에서 연결할 도구를 고릅니다. Claude Code, Claude 앱 커스텀 커넥터, Codex, Cursor, Devin Desktop (Cascade), Gemini CLI, Hermes가 있습니다.
쓸 기능을 고릅니다. 한 번에 등록하려면 한 번에 등록하기 (연결 하나) 를 켜고, 열쇠를 만들 때 쓸 기능을 모두 체크했는지 확인합니다.
만든 열쇠 값을 터미널 환경변수 MELLOWZ_STUDIO_TOKEN에 넣습니다.
화면이 보여 주는 설정 코드를 설정 복사로 복사해, 화면에 적힌 설정 위치에 붙여 넣습니다.
도구에서 한 번 호출한 뒤 연결 확인을 누릅니다. "연결됐어요"가 나오면 이 열쇠가 방금 쓰였다는 뜻입니다. 확인은 화면을 연 뒤 최대 3번까지 누를 수 있습니다.

열쇠를 환경변수로 넣기 — bash
export MELLOWZ_STUDIO_TOKEN="<복사한 열쇠 값>"

주의

도구에 따라 설정 파일 안에 이름을 자동으로 바꿔 주지 못하는 경우가 있습니다. 화면이 경고를 띄우면, 자리표시자를 열쇠로 바꿔 넣고 그 파일을 다른 사람과 공유하지 마세요. Claude 앱 커스텀 커넥터는 파일이 아니라 도구의 연결 화면 입력 칸에 붙여 넣습니다.

내 연결 열쇠 목록에서 열쇠마다 이름, 상태(사용 중, 만료됨, 끊김), 마지막 사용, 만료 시각, 지출 한도 사용량을 봅니다.

한도 수정: 지출 한도를 바꾸거나, 금액을 비우고 저장해 해제합니다. 한도를 낮춰도 이미 쓴 합은 그대로이고 새 한도는 다음 생성부터 적용됩니다.
끊기: 확인 창에서 한 번 더 누르면 그 열쇠를 쓰는 도구가 바로 접속할 수 없게 됩니다. 되돌릴 수 없습니다.
모든 연결 끊기: 열쇠와 승인된 앱을 한 번에 모두 끊습니다. 어디에 연결했는지 기억나지 않거나 노출이 의심될 때 씁니다.
승인된 앱: 로그인 동의 화면에서 직접 허용한 외부 앱입니다. 열쇠와 따로 관리되며 연결 해제로 끊습니다.

열쇠는 값을 고칠 수 없으니 새로 만들어 바꿉니다.

서버는 열쇠가 잘못된 이유를 구분해서 알려 주지 않습니다. 형식이 틀렸거나, 없거나, 끊겼거나, 만료됐거나, 허용하지 않은 기능이면 모두 같은 401을 받습니다. 목록에서 상태를 먼저 확인하세요.

응답	의미	확인
401, "personal token이 유효하지 않아요."	연결 열쇠가 쓸 수 없는 상태입니다.	목록에서 상태가 사용 중인지, 허용한 기능에 이 도구가 쓰는 기능이 있는지 봅니다.
401, "인증 헤더는 하나만 보내 주세요."	인증 헤더가 두 종류 함께 왔습니다.	`Authorization: Bearer <열쇠>` 하나만 보냅니다.
403, "이 표면에 대한 권한이 없어요."	로그인 동의로 연결한 도구가 허용 범위 밖 기능을 불렀습니다.	동의 화면에서 필요한 기능을 허용합니다.
429, `RATE_LIMITED`	인증 요청이 너무 많습니다. 응답의 `Retry-After`(초) 뒤에 다시 보냅니다.	잘못된 열쇠로 반복 호출하는 설정이 없는지 봅니다.

더 많은 증상과 해결은 문제 해결에 있습니다.