설정
설정은 센터가 바깥과 연결되는 방법, 요원별 모델과 정기 깨우기, 설치 인증, 표시 언어를 정하는 화면입니다. 처음 설치한 뒤와 연결이 끊겼을 때 가장 많이 찾게 됩니다.
설정은 어떤 때 쓰나요
설정은 “센터를 처음 연결할 때”와 “요원 운영 방식을 바꿀 때” 여는 화면입니다. 평소 일을 시킬 때는 열 필요가 없습니다.
- 외부 AI 서비스(Claude, ChatGPT 등)가 내 센터에 접속하게 하려면 외부 연결 탭을 씁니다.
- 요원이 쓸 모델과 정기 깨우기를 정하거나 리셋 기준을 바꾸려면 LIVE 및 웨이크업 탭을 씁니다.
- 설치 인증을 새로 받거나 다시 연결하려면 Gate 탭을 씁니다.
- 화면 언어를 바꾸려면 설정 창 맨 위의 언어 칸을 씁니다.
화면 구성
사이드바 시스템 줄 맨 아래의 ‘⚙ 설정’ 버튼으로 열며, 맨 위 오른쪽에 언어 칸, 그 아래에 탭 줄이 있습니다. 탭은 외부 연결, LIVE 및 웨이크업, AMC, Gate 순서이고, 설치 형태에 따라 AP 탭이 하나 더 나타납니다.
assets/turtlecenter/ui-settings-1.png · 권장 크기 1600×900맨 위 오른쪽 언어 칸과 탭 줄(외부 연결, LIVE 및 웨이크업, AMC, Gate)이 보이는 화면.| 탭 | 용도 | 일반 사용자가 쓰나요 |
|---|---|---|
| 외부 연결 | 인터넷 쪽에서 내 센터로 들어오는 길(터널) 만들기 | 예, 처음 한 번 |
| LIVE 및 웨이크업 | 요원별 모델, 정기 깨우기, 리셋 기준 글자 수 | 예, 운영 방식을 바꿀 때 |
| AMC | 새 세션이 정상으로 열리는지 확인하고 쿠키 삭제 | 점검할 때만 |
| Gate | 설치 토큰으로 인증하고 연결 상태 확인 | 예, 설치와 재인증 때 |
| AP | 보호 키와 모델 ID 등록, 연결 확인, 관찰 시작·중지 | 설치 형태에 따라 나타나며 점검용 |
언어
설정 창 맨 위 오른쪽의 언어 칸에 언어를 쓰고 Enter를 누르면 화면 언어가 바뀝니다. 지원하는 언어는 한국어와 영어이고, 칸에는 ‘한국어’ 또는 ‘English’로 표시됩니다.
| 항목 | 하는 일 | 바꾸면 생기는 일 | 주의 |
|---|---|---|---|
| 언어 칸 | 센터 화면의 표시 언어를 정합니다. | 바뀐 언어가 요원들에게도 전달되어 “다음 변경 전까지 이 언어로 답하라”는 안내가 갑니다. | 지원하지 않는 언어를 쓰면 칸 옆에 ‘지원 불가’가 표시되고 바뀌지 않습니다. |
외부 연결 탭
외부 연결 탭은 ngrok 터널로 내 센터의 MCP 주소를 인터넷에 공개하는 곳입니다. 외부 AI 서비스가 이 주소로 센터에 접속하며, 연결 상태를 한눈에 보고 문제의 원인을 줄마다 확인할 수 있습니다.
assets/turtlecenter/ui-settings-2.png · 권장 크기 1600×900연결 상태, 토큰 입력칸, 단추 4개, 아래 상태 줄이 모두 보이는 화면. 토큰 값은 비워 둔 상태로 찍습니다.입력칸과 단추
| 항목 | 하는 일 | 바꾸면 생기는 일 | 주의 |
|---|---|---|---|
| ngrok authtoken | ngrok 대시보드에서 받은 authtoken을 입력합니다. | ‘토큰 저장 및 연결’을 누르면 저장하고 바로 연결을 시도합니다. | ngrok API 키나 에이전트 인증 토큰은 쓸 수 없습니다. 저장한 토큰은 다시 보여 주지 않습니다. |
| 에이전트 인증 토큰 | 공개 주소에 인증을 걸어 둔 경우, 외부 접속용 토큰을 입력합니다. | 먼저 내 컴퓨터의 로컬 연결창구(127.0.0.1:5716)에서 인증이 통과하는지 확인하고, 통과한 경우에만 이 Windows 계정 전용으로 암호화해 저장합니다. | ngrok authtoken과 다른 값입니다. 비워 두면 이미 저장된 값을 씁니다. |
| 공개 도메인 (선택) | 쓰고 싶은 공개 주소를 직접 지정합니다. | 비워 두면 ngrok이 실제로 만든 주소를 그대로 씁니다. | 도메인만 씁니다(예: 이름.ngrok-free.dev). 경로(/mcp)는 넣지 않습니다. 형식이 틀리면 ‘공개 도메인 형식이 올바르지 않습니다.’가 나옵니다. |
| 토큰 저장 및 연결 | 입력한 토큰을 저장하고 연결합니다. | 연결에 성공하면 상태가 ‘연결됨’으로 바뀝니다. | 처리 중에는 자동으로 다시 시도하지 않습니다. |
| 토큰 교체 | 저장된 토큰을 새 토큰으로 바꿉니다. | 새 토큰으로 다시 연결합니다. | 바꾸기 전 토큰은 복구되지 않으니 새 토큰을 먼저 준비해 두세요. |
| 연결 테스트 | 지금 연결이 되는지 확인합니다. | 상태 줄이 새로 갱신됩니다. | 설정은 바뀌지 않습니다. |
| 연결 해제 | 외부 연결을 끊습니다. | 외부 AI 서비스가 센터에 접속할 수 없게 됩니다. | 끊은 뒤에는 ‘토큰 저장 및 연결’로 다시 연결합니다. |
상태 줄 읽는 법
상태 줄은 연결이 되기까지의 단계를 위에서 아래로 보여 주므로, 처음 이상이 나온 줄이 원인입니다.
| 줄 이름 | 정상일 때 | 이상일 때 |
|---|---|---|
| 연결 상태 | 연결됨 | 연결 중 · 연결 안 됨 · 토큰 미설정 · 인증 실패 · 연결 검사 실패 · 인증 정보 필요 |
| ngrok 인증 | 설정됨 · 값 숨김 | 설정되지 않음 · 인증 실패 |
| 공개 MCP URL | 외부에서 접속할 주소가 표시됨 | ‘사용할 수 없음’ |
| ngrok 설치 | 설치됨 · 경로 | 설치되지 않음, 또는 WindowsApps 별칭만 있음. ngrok.exe를 C:\Program Files\ngrok 또는 %ProgramData%\TurtleMcpEdge\Tools\ngrok에 두어야 합니다. |
| 로컬 MCP | 정상 | 응답 없음(포트 미리스닝, 연결 거부, 시간 초과). 센터 쪽 연결창구가 꺼져 있다는 뜻입니다. |
| ngrok Agent | 실행됨 | 실행 안 됨, 또는 서비스는 실행 중이나 에이전트 응답 없음 |
| 터널 상태 | 정상 | 실패 · 터널 없음 · 인증 대기 |
| Provider 응답 | - | ‘ngrok 계정 사용 한도 초과’가 나오면 센터가 아니라 ngrok 계정의 한도 문제입니다. |
| MCP 인증 모드 / 검증 | 인증 없음 또는 인증 필요, 검증 통과 | 인증 정보 필요 · 미검증 · 인증 실패 |
| 필요 조치 | 없음 | 아래에서 설명 |
공개 주소가 바뀌었을 때
공개 주소가 바뀌면 ‘필요 조치’ 줄에 해야 할 일이 코드로 표시됩니다. 두 가지가 있습니다.
NEEDS_EDGE_READINESS_URL_UPDATE: TurtleMcpEdge의--readiness-public-url값을 현재 공개 MCP 주소로 바꿔야 합니다.NEEDS_CONNECTOR_URL_UPDATE: Claude나 ChatGPT에 등록해 둔 커넥터의 MCP 주소를 현재 공개 주소로 바꿔야 합니다.
ngrok 모니터
ngrok 모니터는 선택한 기간에 외부에서 센터로 들어온 요청을 요원별로 세어 보여 주는 화면입니다. ‘시작’과 ‘종료’ 시각을 고르고 ‘새로고침’을 누르면 호출·성공·실패·평균 시간(ms)이 요원별로 나오고, 아래에는 최근 요청 50건이 시각·메서드·경로·상태·걸린 시간으로 나옵니다. 요청 하나를 고르면 오른쪽에 요청과 응답의 헤더·본문이 표시되며, ‘Inspector 열기’로 ngrok 점검 화면을 따로 열 수 있습니다. 5분마다 자동으로 새로 고쳐집니다. 확인필요 이 모니터가 설정 창의 어느 탭에 나오는지는 화면 확인 후 적습니다.
LIVE 및 웨이크업 탭
이 탭은 요원마다 쓸 모델과 정기 깨우기를 정하고, 요원이 쌓은 글자 수가 어디까지 가면 정리할지 기준을 정하는 곳입니다. ‘깨우기’는 정해진 간격마다 요원에게 정해 둔 문구를 보내 일을 이어 가게 하는 기능입니다.
assets/turtlecenter/ui-settings-3.png · 권장 크기 1600×900위쪽 ‘보스 활성’ 체크와 리셋 임계값 세 칸, 가운데 요원별 표, 아래 ‘설정 저장’ 단추가 보이는 화면.요원별 표
표는 요원마다 한 줄이고, 앞쪽 체크를 켠 줄만 저장됩니다. 화연·소람과 센터 요원이 한 줄씩 나옵니다.
| 열 | 정하는 것 | 값의 범위 | 주의 |
|---|---|---|---|
| 대상 | 이 줄을 적용할지 여부(체크)와 요원 이름 | 체크 켜짐 / 꺼짐 | 체크를 끄면 그 요원은 저장 대상에서 빠집니다. |
| 간격(분) | 몇 분마다 깨울지 | 1분 ~ 10,080분(7일). 새 줄의 처음 값은 5분입니다. | 너무 짧게 하면 요원이 쉴 틈 없이 신호를 받습니다. |
| 전달 메시지 | 깨울 때 요원에게 보낼 문구 | 비워 둘 수 없음 | 문구가 비어 있으면 저장되지 않습니다. |
| Codex 모델 | 요원이 쓸 모델 | 내 컴퓨터에 설치된 Codex가 알려 주는 목록에서 선택 | 센터 요원 줄에만 적용되고, 화연·소람 줄은 ‘—’로 표시됩니다. 목록을 불러오지 못하면 모델 설정이 잠깁니다. |
| 추론 레벨 | 답하기 전에 얼마나 깊이 생각하게 할지 | Codex가 알려 주는 목록에서 선택 | 센터 요원 줄에만 적용됩니다. |
| 다음 실행 / 간격 / 백오프 | (읽기 전용) 다음 깨우는 시각, 실제 간격, 현재 단계 | 설정값 · 적응 15분 · 적응 30분 · 적응 60분 | 실패가 이어지면 간격이 15분, 30분, 60분으로 자동으로 늘어나는 단계(적응)가 표시됩니다. |
| 리셋 임계값(글자) | 요원별 리셋 기준 글자 수 | 1 이상 | 위쪽 세 칸의 값이 요원 줄에 채워집니다. |
모델 기본값은 gpt-5.6-sol, 추론 레벨 기본값은 medium입니다. 저장된 설정 파일이 없을 때 이 값이 쓰입니다.
리셋 임계값(글자)
리셋 임계값은 요원 이름 옆 숫자(방에 넣어 준 글자 수의 누적)와 견주는 기준이며, 새 설치의 기본값은 소람 150,000자, 화연 100,000자, 코덱스(센터 요원) 150,000자입니다. 표 위쪽에 ‘소람 리셋 임계값(글자)’, ‘화연 리셋 임계값(글자)’, ‘코덱스 리셋 임계값(글자)’ 세 칸이 있고, 각 칸의 값이 같은 종류의 요원 줄에 적용됩니다. 숫자가 이 기준에 가까워졌다는 것은 그 요원의 대화가 길어졌다는 뜻이므로, 이름 옆 숫자가 빨갛거나 기준에 가까우면 요원 방에서 리셋을 검토하세요.
이전 버전에서 올린 설정에 코덱스 기준이 맞지 않거나 옛 기본값이 남아 있으면, 저장된 값을 열 때 새 기본값 150,000으로 바뀌고 “코덱스 레거시 임계값이 불일치하거나 구 기본값이므로 새 기본값 150,000을 적용했습니다.”라는 안내가 나옵니다. 확인필요 기준에 도달했을 때 센터가 자동으로 리셋하는지, 표시만 하는지는 동작을 확인한 뒤 적습니다.
야간 모드
‘보스 활성 — 예약 웨이크업 실행 중지’ 체크를 끄고 저장하면 야간 모드로 바뀝니다. 야간 모드는 새 간격으로 시작하고, 자리를 비운 사이 놓친 실행을 나중에 몰아서 하지 않습니다. 체크를 켠 상태에서는 예약 깨우기가 실행되지 않습니다.
저장
값을 바꾼 뒤에는 반드시 ‘설정 저장’을 눌러야 반영됩니다. 저장되면 ‘저장 완료 · ○개 대상’이 표시되고, 저장에 실패하면 ‘설정을 저장하지 못했습니다.’가 나옵니다. 탭을 처음 열 때 저장된 설정이 있으면 ‘○개 대상 복원됨’이 표시되고, 저장된 대상이 없으면 ‘저장된 대상 없음’이 표시됩니다. 모델 목록은 열 때 ‘설치된 Codex 모델 목록을 불러오는 중…’을 거쳐 ‘Codex 모델 목록 준비 완료 · ○개 모델’이 되어야 고를 수 있습니다.
AMC 탭
AMC 탭은 요원의 새 세션이 정상으로 열리는지 확인하고, 필요하면 쿠키를 지우는 점검 화면입니다. 요원을 고르면 ‘○○_뉴세션’ 단추로 새 세션 확인을 시작하고, ‘○○ 쿠키 삭제’ 단추로 그 요원 방의 쿠키를 지웁니다. 결과는 아래 줄에 ‘요원: 결과’와 방에서 읽은 글자 수(DOM ○자)로 나옵니다.
- 새 세션 확인이 30초를 넘으면 ‘뉴세션 확인이 30초를 초과했습니다. 다시 시도할 수 있습니다.’가 나옵니다.
- 창을 닫으면 진행 중인 확인이 취소됩니다.
- 쿠키를 지우면 해당 방의 로그인이 풀릴 수 있으므로, 점검 안내를 받았을 때만 쓰세요.
확인필요 쿠키 삭제 뒤 다시 로그인해야 하는지, 어떤 요원이 대상인지는 화면 확인 후 적습니다.
Gate 탭
Gate 탭은 설치 토큰으로 이 센터를 인증하고, 지금 인증 상태가 어떤지 보여 주는 곳입니다. 주소를 직접 쓰는 칸은 없고, 인증 서버 주소는 설치 때 정해집니다.
assets/turtlecenter/ui-settings-4.png · 권장 크기 1600×900상태, 설치자 ID, 설치 토큰, 최근 오류, ‘연결’과 ‘재연결’ 단추가 보이는 화면. 토큰 칸은 비워 둡니다.| 항목 | 하는 일 | 주의 |
|---|---|---|
| 상태 | 지금 인증이 어디까지 됐는지 보여 줍니다. | 아래 상태표를 보세요. |
| 설치자 ID | 이 센터의 설치자 번호가 표시됩니다. | 읽기 전용입니다. |
| 설치 토큰 | 발급받은 설치 토큰을 입력합니다. | 입력한 글자는 가려서 표시되고, 인증을 시작하면 칸이 비워집니다. 새 토큰을 입력하고 재연결하면 기존 등록이 교체됩니다. |
| 최근 오류 | 가장 최근 인증 실패의 이유가 표시됩니다. | 없으면 ‘없음’입니다. |
| 연결 | 설치 토큰으로 처음 인증합니다. | 토큰을 입력했고 아직 등록되지 않았을 때만 눌립니다. |
| 재연결 | 저장된 등록으로 인증 세션을 다시 이어 갑니다. | 새 토큰을 입력하고 누르면 그 토큰으로 등록을 바꿉니다. 토큰 없이 누르면 저장된 등록으로 다시 연결합니다. |
상태 표시
| 표시 | 뜻 | 어떻게 하나요 |
|---|---|---|
| 설치 토큰 필요 | 아직 토큰으로 인증하지 않았습니다. | 토큰을 입력하고 ‘연결’을 누릅니다. |
| 인증 중 / 저장된 인증 확인 중 | 인증 서버와 확인하는 중입니다. | 잠시 기다립니다. |
| 인증됨 | 인증이 확인됐습니다. | 이어서 AMC 수신이 진행됩니다. |
| AMC 수신 중 | 요원에게 줄 공통 기억을 받는 중입니다. | 기다립니다. |
| 인증됨 · AMC 수신 완료 | 정상 상태입니다. | 할 일이 없습니다. |
| 인증 세션 만료 | 인증 시간이 지나 다시 이어야 합니다. | ‘재연결’을 누릅니다. |
| 인증 연결 불가 | 인증 서버에 닿지 못했습니다. | 네트워크를 확인하고 ‘재연결’을 누릅니다. |
자주 만나는 오류 안내
| 화면 문구(요약) | 뜻과 대처 |
|---|---|
| 설치 토큰을 확인할 수 없습니다 | 입력이 틀렸습니다. 다시 확인하거나 새 토큰을 발급받습니다. |
| 설치 토큰의 유효기간이 끝났습니다 | 새 토큰을 발급받습니다. |
| 설치 토큰이 폐기되었습니다 | 관리자에게 새 토큰을 요청합니다. |
| 설치 권한이 비활성화되어 있습니다 | 관리자에게 활성화를 요청한 뒤 다시 시도합니다. |
| 설치 정보와 발급 대상이 일치하지 않습니다 | 새 설치 코드를 발급받아 입력합니다. |
| 인증 서버에 연결할 수 없습니다 | 네트워크와 Gate 주소를 확인한 뒤 다시 시도합니다. |
| 인증 처리 중 오류가 발생했습니다 | 잠시 후 한 번 다시 시도하고, 계속되면 오류 코드와 발생 시각을 관리자에게 알립니다. |
AP 탭
AP 탭은 보호 키와 모델을 등록하고 연결을 확인하는 점검용 화면이며, 설치 형태에 따라 보이지 않을 수 있습니다. 일반 사용에는 필요하지 않습니다.
| 항목 | 하는 일 |
|---|---|
| 보호 키 | 보호 키를 입력하는 칸입니다. |
| 모델 ID | 정확한 모델 ID를 입력합니다. 비어 있으면 ‘정확한 모델 ID를 입력하세요.’가 나옵니다. |
| 키 등록 | 보호 키를 등록합니다. 등록 뒤에는 연결 확인이 필요합니다. |
| 연결 확인 | 등록한 키와 모델로 연결이 되는지 확인합니다. |
| 키 해제 | 등록한 보호 키를 해제합니다. |
| 관찰 시작 / 관찰 중지 | 방 관찰을 시작하거나 멈춥니다. |
| 상태, 최근 연결, 최근 관찰, 최근 API 결과, 동작 결과 | 모델, 키 등록 여부, 연결 확인 여부, 마지막 오류를 읽기 전용으로 보여 줍니다. |
확인필요 일반 고객 배포본에서 AP 탭이 보이는지, 어떻게 안내할지 정한 뒤 정리합니다.