문제 해결과 자주 묻는 질문
자주 생기는 연결 문제의 해결법과 자주 묻는 질문의 답변.
AI 앱에서 생기는 문제는 대부분 서버 주소, 아직 허용하지 않은 권한, 한도, 앱이 연결된 워크스페이스 중 하나가 원인입니다. 아래에서 보이는 메시지를 찾아보세요. 자주 묻는 질문의 답변은 페이지 끝에 있습니다.
연결과 로그인
앱이 서버에 접속하지 못하거나 연결에 실패합니다
https://와 /mcp까지 포함해 https://mcp.hiretahoe.com/mcp를 정확히 입력하세요. 회사 네트워크라면 IT팀에 mcp.hiretahoe.com(로그인도 이 주소에서 시작합니다)과 tahoe.workonward.com을 허용해 달라고 요청하세요. 내 컴퓨터에서 실행되는 서버만 쓸 수 있는 앱은 Tahoe에 연결할 수 없습니다.
로그인 창에 요금제나 워크스페이스에서 AI 앱을 쓸 수 없다고 나옵니다
Tahoe MCP는 Starter, Growth, Enterprise 같은 유료 요금제가 필요하며, 체험판 워크스페이스는 연결할 수 없습니다. 이때 로그인 페이지에 “AI 앱은 Tahoe 유료 요금제에서 사용할 수 있습니다. 이 워크스페이스는 아직 유료 요금제가 아닙니다.”라고 나옵니다. 연결한 뒤에 워크스페이스가 유료 요금제가 아니게 되면 앱에 “AI apps are available on paid Tahoe plans. Upgrade this workspace, or ask its owner to, then try again.”(AI 앱은 Tahoe 유료 요금제에서 쓸 수 있습니다. 워크스페이스를 업그레이드하거나 소유자에게 요청한 뒤 다시 시도하세요.)라고 나옵니다. 소유자나 관리자가 AI 앱을 껐거나, 소유자와 관리자만 연결할 수 있도록 설정한 경우에도 작동하지 않습니다. 요금 페이지에서 업그레이드하거나, 소유자나 관리자에게 Settings → AI connectors를 확인해 달라고 요청하세요.
“이 앱을 Tahoe에 연결하지 못했습니다”라고 나옵니다
앱이 연결되기 전에 Tahoe가 로그인을 멈췄고, 페이지에 오류 코드가 표시됩니다. 창을 닫고 AI 앱에서 다시 시도하세요. 계속 같은 문제가 생기면 아래 표를 참고하세요. 영어 페이지에서는 “This app couldn’t connect to Tahoe”로 표시됩니다.
| 오류 코드 | 뜻 | 해결 방법 |
|---|---|---|
invalid_client | Tahoe에서 이 앱의 로그인 정보를 확인하지 못했습니다. | 나중에 다시 시도하세요. 계속되면 앱 개발자에게 문의하세요. |
invalid_request | 앱이 보낸 로그인 요청을 Tahoe에서 읽지 못했습니다. | 다시 시도하고, 계속되면 앱 개발자에게 문의하세요. |
unauthorized_client | 이 앱은 이 방식으로 Tahoe에 로그인할 수 없습니다. | 앱 개발자에게 문의하세요. |
invalid_scope | 앱이 Tahoe에서 제공하지 않는 권한을 요청했습니다. | 다시 시도하거나 앱 개발자에게 문의하세요. |
invalid_target | 앱이 Tahoe에서 알 수 없는 서버 주소로 연결하려고 했습니다. | 앱이 https://mcp.hiretahoe.com/mcp를 정확히 쓰는지 확인하세요. |
unsupported_response_type | 앱이 Tahoe에서 지원하지 않는 방식으로 로그인을 요청했습니다. | 앱 개발자에게 문의하세요. |
access_denied | 연결이 취소되었거나 허용되지 않아 앱이 Tahoe에 접근할 수 없습니다. | 허용하려던 것이라면 다시 연결하세요. |
interaction_required | 앱이 Tahoe 로그인 화면을 보여 주지 않고 연결하려고 했습니다. | 다시 연결하고 직접 앱을 승인하세요. |
server_error | Tahoe에서 문제가 발생했습니다. | 몇 분 후 다시 시도하세요. |
temporarily_unavailable | 지금은 Tahoe에서 새 연결을 처리할 수 없습니다. | 1분 후 다시 시도하세요. |
승인 화면에 localhost가 표시됩니다
Claude Code나 Cursor처럼 내 컴퓨터에서 실행되는 앱은 로그인 결과를 내 컴퓨터에서 받습니다. 그래서 Tahoe는 돌아갈 주소로 localhost를 경고와 함께 보여 줍니다. 정상입니다. 방금 직접 연결을 시작한 경우에만 계속하세요.
갑자기 다시 로그인하라고 합니다
30일에 한 번 이상 사용하면 연결은 최대 90일 동안 유지됩니다. 비밀번호를 바꾸거나 재설정했을 때, 이메일 주소를 바꿨을 때, 워크스페이스에서 제외되었을 때도 다시 로그인해야 합니다. 앱에서 다시 로그인하세요.
Tahoe MCP가 점검 중이라고 나옵니다
Tahoe가 예정된 작업을 하고 있거나 문제를 고치는 중입니다. 잠시 뒤에 다시 시도하세요.
권한과 관리자 설정
앱이 다시 연결하거나 권한을 더 승인하라고 합니다
이메일 발송처럼 아직 허용하지 않은 권한이 필요한 작업입니다. 열리는 Tahoe 페이지에서 승인하세요. 앱이 그 페이지를 열 수 없다면 앱에서 다시 연결하고 Recruiter(리크루터)나 Full access(전체 권한)를 고르세요. Meta Muse처럼 작업 도중에 권한을 요청할 수 없는 앱은 대신 필요한 권한의 이름을 알려 줍니다(“This needs the permission … Disconnect Tahoe in your AI app and connect again, choosing that permission.”). 로그인과 권한
읽기 전용 연결이라 아무것도 바뀌지 않았다고 나옵니다
Read-only(읽기 전용) 프리셋으로 연결했다는 뜻입니다. 이 프리셋은 조회만 하고 아무것도 바꾸지 않습니다. 전체 메시지는 “This connection is read-only, so nothing was changed. To allow changes, reconnect Tahoe and choose Recruiter or Full access.”(읽기 전용 연결이라 아무것도 바뀌지 않았습니다. 변경을 허용하려면 Tahoe를 다시 연결하고 Recruiter나 Full access를 고르세요.)입니다. Settings → Connected apps에서 앱 연결을 해제한 뒤 다시 연결하면서 Recruiter(리크루터)나 Full access(전체 권한)를 고르세요.
워크스페이스 관리자가 기능을 껐다고 나옵니다
“Your workspace admin has turned off …” 같은 메시지는 소유자나 관리자가 AI 앱에서 그 기능을 껐거나, 이 앱을 허용하지 않았다는 뜻입니다. 소유자나 관리자에게 문의하세요. 이 설정은 Settings → AI connectors에서 관리합니다. 관리자 설정
앱이 Gmail, GitHub, LinkedIn, ATS를 연결하라고 합니다
그 계정이 아직 Tahoe에 연결되지 않았습니다. 앱이 알려 준 링크를 열고 브라우저에서 계정을 연결한 뒤 다시 요청하세요. 계정 연결은 AI 앱 안에서 하지 않습니다.
앱에 도구가 너무 많이 보입니다
도구 그룹을 켤 때마다 도구가 늘어나는데, 도구가 많으면 잘 작동하지 않는 앱도 있습니다. Microsoft Copilot Studio는 서버 하나가 추가할 수 있는 도구 수를 제한하므로, Tahoe가 자동으로 간단한 Core 세트를 제공합니다. 도구를 줄이려면 앱에서 다시 연결하고, 필요 없는 그룹을 Off(끔)로, 또는 All(전체) 대신 Core(기본)로 설정하세요. 관리자가 팀에서 쓰지 않는 기능을 꺼서 그 도구들을 없앨 수도 있습니다.
Tahoe 슬래시 명령이 보이지 않습니다
앱이 MCP 프롬프트를 지원하지 않는 경우입니다. 슬래시 명령은 Claude, Claude Code, VS Code, Cursor, Gemini CLI, Goose에서 작동합니다. 다른 앱에서는 평소 쓰는 말로 요청하세요. 슬래시 명령과 스킬
크레딧과 한도
| 보이는 메시지 | 뜻 | 해결 방법 |
|---|---|---|
| “Estimated N credits exceeds your limit of M”(예상 비용 N크레딧이 상한 M을 넘음) | 작업별 상한이 제대로 작동한 것입니다. 아무것도 차감되지 않았습니다. | 요청에 더 높은 상한을 적거나(“최대 30크레딧”) 요청 범위를 줄이세요. |
| “Today’s assistant budget is used”(오늘의 AI 앱 예산을 다 씀) | 워크스페이스의 AI 앱 일일 크레딧 한도에 도달했습니다. | 내일(UTC 자정)까지 기다리거나, 소유자나 관리자에게 한도를 올려 달라고 요청하세요. |
| “Needs X credits; you have Y”(X크레딧이 필요하지만 Y크레딧 보유) | 크레딧이 부족합니다. 아무것도 차감되지 않았습니다. | Settings → Credits에서 충전하거나, 소유자나 관리자에게 결제 링크를 요청하세요. |
| “Daily search limit reached”(일일 검색 한도 도달) | 워크스페이스가 오늘 유료 검색 페이지 100개를 불러왔습니다. | 이미 불러온 페이지는 계속 무료로 다시 열 수 있습니다. 새 페이지는 내일 불러오세요. |
| “Another GitHub search is running”(다른 GitHub 검색이 실행 중) | 워크스페이스마다 GitHub 검색은 한 번에 하나만 실행됩니다. | 끝날 때까지 기다리거나 실행 중인 검색을 취소하세요. |
| “Too many calls this minute. Retry in N seconds.”(이번 1분 동안 요청이 너무 많음) | 연결이 1분당 요청 한도에 도달했습니다. | N초 기다리세요. 대부분의 앱은 알아서 다시 시도합니다. |
모든 가격과 한도는 크레딧과 한도에 정리되어 있습니다.
오류 코드
도구가 요청을 처리하지 못하면 코드, 메시지, 다시 시도해서 해결될 수 있는지, 그리고 경우에 따라 먼저 기다릴 초 수인 retry_after_s를 담은 오류를 돌려줍니다. 보통은 앱이 오류를 쉬운 말로 설명해 줍니다. 거절된 요청에는 크레딧이 차감되지 않습니다.
| 코드 | 뜻 | 다시 시도 | 해결 방법 |
|---|---|---|---|
not_found | 찾을 수 없거나 볼 수 없는 항목입니다. 다른 워크스페이스에 있거나, 채용 공고라면 다른 리크루터가 만든 공고일 수 있습니다. | 아니요 | Settings → Connected apps에서 앱이 연결된 워크스페이스를 확인하세요. |
invalid_input | 요청의 값이 올바르지 않습니다. 메시지에 항목과 허용되는 값이 나옵니다. | 고친 뒤 | 보통 앱이 고쳐서 다시 시도합니다. 그렇지 않으면 요청을 바꿔 말해 보세요. |
not_allowed | 관리자가 AI 앱에서 이 기능을 껐거나, 유료 요금제가 아니거나, 읽기 전용 연결이거나, Tahoe가 잠시 이 기능을 꺼 두었습니다. | Tahoe가 잠시 꺼 둔 경우에만 | 메시지에 따라 소유자나 관리자에게 문의하거나, 업그레이드하거나, Recruiter로 다시 연결하세요. |
insufficient_scope | 아직 허용하지 않은 권한이 필요한 작업입니다. | 승인한 뒤 | 열리는 Tahoe 창에서 승인하거나, 연결을 해제하고 그 권한을 골라 다시 연결하세요. |
role_forbidden | 이 워크스페이스에서 내 역할로는 할 수 없는 작업입니다. | 아니요 | 소유자나 관리자에게 문의하세요. |
credit_ceiling_exceeded | 예상 비용이 작업에 허용된 최대 크레딧보다 높습니다. 아무것도 차감되지 않았습니다. | 상한을 올린 뒤 | 더 많은 크레딧을 허용하거나(“최대 30크레딧”) 요청 범위를 줄이세요. |
insufficient_credits | 크레딧이 부족합니다. 메시지에 필요한 크레딧과 잔액이 나옵니다. 아무것도 차감되지 않았습니다. | 충전한 뒤 | Settings → Credits에서 충전하거나, 소유자나 관리자에게 결제 링크를 요청하세요. |
mcp_budget_exceeded | 워크스페이스의 AI 앱 일일 크레딧 한도를 다 썼습니다. | 내일 | UTC 자정까지 기다리거나, 소유자나 관리자에게 한도를 올려 달라고 요청하세요. |
subscription_required | 활성화된 Tahoe 요금제가 필요합니다. | 아니요 | 요금제를 고르거나 워크스페이스 소유자에게 요청하세요. |
plan_upgrade_required | 더 높은 요금제가 필요합니다. 예를 들어 전화 사전 스크리닝과 팀원 초대에는 Growth가 필요합니다. | 아니요 | 요금제를 업그레이드하세요. |
resume_locked | 이력서의 무료 기간이 끝났습니다. 잠금 해제에 50크레딧이 듭니다. | 잠금을 해제한 뒤 | 크레딧을 쓰려면 앱에 잠금 해제를 요청하세요. |
limit_reached | 요청 속도 한도나, 유료 검색 페이지 하루 100개 같은 일일 한도에 도달했습니다. | 예, retry_after_s 뒤에 | 기다렸다가 다시 시도하세요. 일일 한도라면 다음 날 시도하세요. |
busy | 같은 요청, 다른 GitHub 검색, 또는 유료 작업 2개가 이미 실행 중입니다. | 예, retry_after_s 뒤에 | 다른 작업이 끝날 때까지 기다리세요. |
conflict | 같은 항목이 다른 곳에서 동시에 바뀌었습니다. 메시지에 현재 값이 나옵니다. | 확인한 뒤 | 현재 값을 확인하고 다시 요청하세요. |
connection_required | Gmail, GitHub, LinkedIn, ATS가 Tahoe에 연결되어 있지 않습니다. | 연결한 뒤 | 링크를 열어 브라우저에서 계정을 연결한 뒤 다시 요청하세요. |
unavailable | Tahoe나 이 기능을 잠시 쓸 수 없습니다. 크레딧은 쓰이지 않았습니다. | 대부분 예 | 잠시 뒤 다시 시도하세요. 기능이 꺼져 있다면 메시지에 나옵니다. |
reauthorize | 연결 해제나 비밀번호 변경 등으로 Tahoe 연결이 끝났습니다. | 다시 연결한 뒤 | AI 앱에서 Tahoe를 다시 연결하세요. |
Meta Muse
- Muse는 미국과 캐나다에서만 쓸 수 있습니다.
- Muse는 나중에 권한을 더 요청할 수 없습니다. 도구에 권한이 필요하다고 하면 연결을 해제하고 그 권한이나 Recruiter를 골라 다시 연결하세요.
- Muse는 선별된 도구 30개를 받습니다. 연락처 찾기, 이메일 발송, 채용 공고 게시, 전화 스크리닝, 그리고 GitHub, LinkedIn, ATS, 관리 도구는 Muse에서 쓸 수 없습니다.
항목 찾기
찾을 수 없거나 볼 수 없다고 나옵니다
“Not found, or not visible to you” 메시지는 항목이 없거나, 다른 워크스페이스에 있거나, 채용 공고라면 다른 리크루터가 만든 공고일 때 나옵니다. Settings → Connected apps에서 앱이 어떤 워크스페이스에 연결되어 있는지 확인하세요. 채용 공고라면 내 공고만이 아니라 “워크스페이스의 모든 공고”를 보여 달라고 요청하세요.
이번 주에 Columbus, Ohio의 Field Coordinator 공고에 누가 지원했어?
앱이 찾을 수 없거나 볼 수 없는 항목이라고 답합니다. Jordan이 Settings → Connected apps를 확인해 보니 ChatGPT는 Kestrel Labs Seoul 워크스페이스에 연결되어 있고, Field Coordinator 공고는 Kestrel Labs US에 있습니다. Jordan이 Workspace 열에서 Kestrel Labs US를 고르고 다시 묻자 지원자가 나타납니다.
자주 묻는 질문
Tahoe MCP를 쓰면 추가 비용이 드나요?
아니요. 모든 유료 요금제에 포함되어 있습니다. 작업에 드는 크레딧은 대시보드와 같고, 조회는 무료입니다.
어떤 AI 앱을 쓰는 게 좋을까요?
현재는 Claude와 ChatGPT가 승인 창, 대화형 카드, 로그인까지 가장 폭넓게 지원합니다. Gemini는 미국의 개인 계정과 Gemini Enterprise에서 쓸 수 있습니다. Microsoft Copilot은 Copilot Studio를 통해 간단한 도구 세트로 쓸 수 있습니다. Meta Muse는 미국과 캐나다에서 선별된 도구 세트로 쓸 수 있습니다. AI 앱 연결하기
앱이 모르는 사이에 크레딧을 쓸 수 있나요?
몰래 쓸 수는 없습니다. 모든 유료 작업에는 앱의 승인 창에 표시되는 상한이 있고, 실행 후에는 차감한 크레딧을 알려 줍니다. 워크스페이스에도 일일 한도가 있습니다.
앱이 알아서 후보자에게 이메일을 보낼 수 있나요?
요청할 때만 보내며, 무언가를 보내기 전에 앱이 승인을 받습니다. 이메일은 이미 워크스페이스에 있는 사람에게만, 관리자가 정한 한도 안에서 보낼 수 있습니다.
Tahoe가 내 이메일을 읽을 수 있나요?
아니요. Tahoe는 연결된 Gmail에서 보내기만 할 수 있습니다. 답장을 확인하려면 AI 앱에 Gmail 커넥터를 따로 추가하세요. 이렇게 물어보세요
한국어로 쓸 수 있나요?
네. 한국어로 요청하세요. 프로필 데이터가 영어이므로 검색은 영어로 바꿔 매칭하고, 처음 입력한 문장도 함께 보관합니다.
두 워크스페이스에서 작업할 수 있나요?
네, 연결을 두 개 만들면 됩니다. 연결 하나는 워크스페이스 하나에서 작동합니다. 앱에 Tahoe를 두 번 추가하거나, Settings → Connected apps에서 연결을 다른 워크스페이스로 옮기세요.
직접 만든 코드로 Tahoe를 자동화할 수 있나요?
MCP는 AI 앱에서 자신의 계정으로 로그인해 일하는 사람을 위한 것입니다. 사람 없이 시스템끼리 연동하려면 Tahoe API를 쓰세요.
내 데이터가 AI 모델 학습에 쓰이나요?
Tahoe는 고객 데이터로 AI 모델을 학습시키지 않으며, 데이터를 판매하지도 않습니다. AI 앱이 대화 데이터를 어떻게 쓰는지는 그 앱의 약관과 조직 설정이 정합니다. 개인정보와 보안
아직 해결되지 않았나요?
사용하는 앱, 요청한 내용, 보인 메시지를 적어 [email protected]으로 이메일을 보내 주세요.