개발자 문서
개발자 문서

MCP 오류 코드

MCP 호출이 실패하는 두 가지 방식과, 코드별 원인·해결 방법입니다.

실패는 두 자리 중 하나로 돌아옵니다.

  • 요청이 성립하지 않으면 JSON-RPC error 로 옵니다(형식, 없는 도구, 자격증명 고르기, 기관 연동 꺼짐, 동시 실행, 로그인 진행 중).
  • 그 밖의 실패는 result.isError 로 옵니다(인증, 권한, 한도, 요금제에 없는 도구, 약관 동의 같은 정책 거절과 쓰기 확인, 작업 실패, 시간 초과).

두 자리 모두 HTTP 200 으로 오고, 예외는 인증 정보가 없거나 잘못된 경우 등이며 아래 HTTP 상태 표에 있습니다.

실패가 돌아오는 자리

요청이 막힘error 로 돌아옴
언제
형식 오류, 없는 도구, 자격증명 고르기, 기관 연동 꺼짐, 동시 실행, 로그인 진행 중
자리
error.code · error.message
판단
코드로 분기합니다
정책 거절과 작업 실패result.isError 로 돌아옴
언제
인증, 권한, 한도, 요금제에 없는 도구, 약관 동의, 쓰기 확인, 작업 실패, 대기 시간 초과
자리
result.isError, result.content(첫 블록 문장, 둘째 블록 JSON), result._meta
판단
둘째 블록 JSON 의 error_code 로 가릅니다. 작업이면 safe_to_retry 로 다시 부를지 정합니다
요청 단계에서 막히면 JSON-RPC error 로, 작업을 시작한 뒤 실패하면 result.isError 로 돌아옵니다.

JSON-RPC 표준 코드

코드뜻원인·해결
-32700본문을 읽지 못함JSON 형식이 깨졌습니다.
-32600요청 형식 오류jsonrpc·method·id 형식을 확인합니다.
-32601없는 메서드initialize · ping · tools/list · tools/call 중 하나를 씁니다.
-32602파라미터 오류X-MCP-Env-Scope 에 real_test 나 production 이 아닌 값을 넣었거나, 인수 형식이 틀렸거나, 도구가 쓸 자격증명을 고르지 못했습니다. 없는 작업 아이디를 읽으려 한 경우와 재시도 키가 겹친 경우도 이 코드로 옵니다. 기관에 쓰기를 하는 도구의 확인 단계는 이 코드가 아니라 result.isError 로 옵니다(아래 「쓰기 확인」 표). 원인은 error.data.error_code 로 가르고 아래 표 둘을 봅니다.
-32603서버 내부 오류잠시 뒤 다시 시도하고, 계속되면 서비스문의로 알려 주세요.

-32602 — 자격증명을 고르지 못했을 때

error.data.error_code뜻할 일
PRIMARY_ACCOUNT_LINK_NOT_FOUND등록한 자격증명이 없습니다.작업이 시작되지 않고 사용 토큰도 쓰지 않습니다. error.data.link_url 의 등록 화면을 사용자에게 알리고, 등록했다고 하면 같은 도구를 다시 부릅니다.
ACCOUNT_LINK_ID_REQUIRED이 상품은 자격증명을 자동으로 고르지 않습니다.등록이 없다는 뜻이 아닙니다. error.data.link_url 의 목록에서 쓸 자격증명의 id 를 복사해 도구 인수 account_link_id 로 넣고 다시 부릅니다.
MULTIPLE_ACTIVE_ACCOUNT_LINKS쓸 수 있는 자격증명이 여러 개라 하나를 고르지 않습니다. 대표로 지정한 것이 있어도 같습니다.쓸 자격증명을 정해 그 id 를 account_link_id 로 넣습니다.
INVALID_ACCOUNT_LINK_IDaccount_link_id 가 UUID 형식이 아닙니다.목록의 값을 그대로 복사해 넣습니다.
CREDENTIAL_OWNERSHIP_DENIED지정한 자격증명을 쓸 수 없습니다.없는 것, 다른 계정의 것, 다른 상품의 것, 사용을 중단한 것은 구별 없이 같은 응답입니다. 목록에서 다시 고릅니다.

-32602 — 조회 대상과 재시도 키 오류

error.data.error_code뜻할 일
JOB_NOT_FOUND결과를 다시 읽는 도구(xdata__job__result)에 넣은 job_id 의 작업이 이 연결의 계정과 환경에 없습니다. 없는 아이디, 다른 계정의 작업, 다른 환경(데모와 정식)의 작업은 같은 응답입니다.job_id 를 앞선 응답에서 그대로 옮겼는지, 작업을 만든 환경과 같은 환경으로 부르는지 확인합니다.
RESOURCE_NOT_FOUND결과를 다시 읽는 도구(xdata__job__result)에 넣은 pack_run_id 의 팩 실행이 이 연결의 계정과 환경에 없습니다. 없는 아이디, 다른 계정, 다른 환경의 실행은 같은 응답입니다.pack_run_id 를 앞선 응답에서 그대로 옮겼는지, 실행을 시작한 환경과 같은 환경으로 부르는지 확인합니다. error.data.safe_to_retry 는 false 입니다.
IDEMPOTENCY_KEY_CONFLICT같은 재시도 키로 인수나 자격증명이 다른 요청이 이미 접수됐습니다. 키는 여러 기관 조회를 한 번에 부르는 팩 도구에서는 idempotency_key 이고, 인수 목록에 request_idempotency_key 가 있는 그 밖의 도구에서는 request_idempotency_key 입니다. 새 작업은 하나도 시작하지 않습니다.같은 요청을 다시 하는 것이면 처음 입력한 인수 그대로 요청하고, 새 요청이면 그 키를 새 값으로 바꾸거나 입력하지 않습니다. error.data.safe_to_retry 는 false 입니다. 규칙은 재시도의 「도구 호출(MCP)의 재시도」 에 있습니다.

XBOSS 코드 — error 로 옴

코드뜻원인·해결
-32000해당 기관 연동이 꺼져 있음운영에서 잠시 막아 둔 상태입니다. error.data.error_code 는 어느 상품이든 POLICY_FEATURE_DISABLED 이고, 다시 불러도 풀리지 않습니다. 서비스문의로 알려 주세요.
-32002없는 도구tools/list 에 있는 이름인지 확인합니다. 꺼져 있거나 이름이 틀렸을 때이고, 요금제에 없는 도구는 아래 -32001 정책 거절로 옵니다. 메시지는 '<이름>' 도구를 지금 쓸 수 없습니다. 로 시작합니다.
-32008동시 실행 한도같은 기관에 진행 중인 작업이 많습니다. 끝난 뒤 다시 부릅니다.
-32009로그인 진행 중같은 기관 로그인이 이미 진행 중입니다. 잠시 뒤 다시 부릅니다.

정책 거절(-32001)은 도구를 부르면 result.isError 로 옵니다

인증, 권한, 한도, 요금제에 없는 도구, 약관 동의처럼 사람이나 앱이 먼저 움직여야 하는 거절은 도구를 불렀을 때 result.isError 결과로 옵니다.

지연 인증이 켜진 연결에서는 tools/list 가 거절이어도 연결을 끊지 않습니다.

인증 정보가 없거나 잘못된 경우의 401 과 OAuth 권한 부족의 403 은 그대로 HTTP 상태와 WWW-Authenticate 로 옵니다(아래 HTTP 상태 표).

XBOSS 코드 -32001 — result.isError 로 옴

코드뜻원인·해결
-32001인증·권한·한도정식 환경인데 현재 공개 요금제가 아니거나, 사용 토큰 한도(하루, 데모는 체험 총량도, 정식 환경은 한 달도)를 넘었거나, 짧은 시간에 너무 많이 불렀거나, 지금 요금제에 포함되지 않은 도구를 불렀습니다(그 도구가 이 환경에서 판매 중일 때 — error.data.error_code 는 POLICY_PROVIDER_FORBIDDEN, error.data.link_url 은 요금제 변경 화면 주소). error.data.link_url 은 다른 경우에도 옵니다. 결제가 일시 중지됐거나 정식 환경에서 요금제가 필요할 때(POLICY_PAID_REQUIRED)는 결제 화면, 갱신된 이용약관에 다시 동의해야 할 때(COMPLIANCE_TOS_VERSION_OUTDATED)는 콘솔의 프로필 화면, 조직이 정지되거나 폐쇄됐을 때(error.data.error_code 가 AUTHZ_FORBIDDEN 이고 error.data.reason 이 organization_not_active)는 콘솔 결제 관리 화면, 위임장 서명이 필요할 때(COMPLIANCE_TRANSFER_MANDATE_REQUIRED)는 콘솔 연동 관리 화면, 이 키로 쓸 수 없는 환경을 불렀을 때(POLICY_ENV_FORBIDDEN)는 데모 환경이면 콘솔 프로필 화면이고 정식 환경이거나 데모 기간이 끝났으면 결제 화면 주소입니다. 키가 잘못됐으면 이 결과가 아니라 HTTP 401 입니다(아래 HTTP 상태 표). 한도를 넘으면 error.data.error_code 가 POLICY_QUOTA_EXCEEDED 이고 error.data.reset_hint 가 다시 채워지는 시각입니다. 다만 데모의 체험 총량이 다 찬 경우(error.data.reason 이 demo_total_tokens_exhausted)는 다시 채워지지 않아 reset_hint 가 오지 않으니, 그때는 요금제를 시작해야 이어 쓸 수 있습니다. 옛 이름 QUOTA_EXCEEDED 는 error.data.legacy_error_code 에 함께 담겨 오니, 분기에는 error_code 를 쓰세요. 너무 잦으면 POLICY_RATE_LIMIT_EXCEEDED 이고(옛 이름 RATE_LIMIT_EXCEEDED 는 legacy_error_code), error.data.retry_after_seconds 가 있으면 길어도 그 초 안에 다시 부를 수 있습니다. 계정 없이 쓰는 맛보기가 막혔으면 TASTE_DAILY_LIMIT 또는 TASTE_GLOBAL_LIMIT 입니다(바로 아래 맛보기 표). 나머지 상황은 error.data.reason 으로 가릅니다 — 오류 코드 의 reason 표.

-32001 — 계정 없이 쓰는 맛보기가 막혔을 때

error.data.error_code뜻할 일
TASTE_DAILY_LIMIT이 호출자의 오늘 맛보기 몫을 다 썼습니다.error.data.retry_after_seconds 가 한국 시간 자정까지 남은 초입니다. 몫은 다음 날 다시 열리고, 가입하면 기다리지 않고 이어서 쓸 수 있습니다. say_to_user 의 가입 안내를 사용자에게 전합니다.
TASTE_GLOBAL_LIMIT서비스 전체가 함께 쓰는 맛보기 몫이 찼거나, 같은 AI 앱의 손님들이 나눠 쓰는 몫이 찼습니다. 호출한 쪽이 한 일은 없습니다.잠시 뒤 다시 부르거나 가입합니다. error.data.retry_after_seconds 가 한국 시간 자정까지 남은 초이고, say_to_user 에 기다릴 시간과 가입 안내가 함께 있습니다.

쓰기 확인 — result.isError 로 옴

둘째 블록 JSON 의 error_code뜻할 일
WRITE_CONFIRMATION_REQUIRED기관에 쓰기를 하는 도구 중 사용자의 확인이 필요한 도구를 확인값 없이 불렀습니다. 그런 도구의 첫 호출은 늘 이렇게 돌아옵니다.작업이 시작되지 않고 사용 토큰도 쓰지 않습니다. 첫 블록에 신청 내용의 미리보기 문장이 있고, 둘째 블록 JSON 의 confirmation_token 에 확인값이, preview 에 미리보기 객체가 있습니다. 미리보기를 사용자에게 그대로 보여 주고 확인을 받은 뒤, 같은 인수에 confirmation_token 으로 그 값을 넣어 다시 부릅니다. 확인값은 10분 안에 한 번만, 확인한 인수와 같은 인수에만 쓸 수 있습니다.
WRITE_CONFIRMATION_INVALID확인값이 만료됐거나, 이미 썼거나, 확인한 내용과 인수가 달라졌습니다. 어느 쪽인지는 알려 주지 않습니다.confirmation_token 없이 다시 부르면 새 확인값과 미리보기를 받습니다. 사용자의 확인을 다시 받은 뒤 그 값을 넣어 부릅니다.

result.isError 로 오는 실패

경우문구의 시작할 일
팩 실행이 아직 끝나지 않음팩 실행(pack_run_id <pack_run_id>)이 아직 끝나지 않았습니다.결과를 다시 읽는 도구(xdata__job__result)에 pack_run_id 를 넣었을 때입니다. 이 도구는 결과를 읽기만 하고 팩 실행을 진행시키지 않습니다. REST 로 시작한 실행은 두 번째 블록의 status_url 을 부르면 진행되고, 끝나면 이 도구로도 같은 결과를 받습니다. 시작한 뒤 deadline_seconds 초가 지나도록 끝나지 않은 실행은 시간 초과로 닫힙니다.
대기 시간 초과요청이 60초 안에 끝나지 않았습니다(작업 번호 …).작업은 서버에서 계속 돕니다. 두 번째 블록의 result_tool_call 을 그대로 부르면(xdata__job__result 도구에 같은 job_id) 작업을 다시 돌리지 않고 사용 토큰도 쓰지 않고 결과를 읽습니다 — 아직 돌고 있으면 잠시 기다렸다가 알려 주므로 조금 뒤 다시 부르면 됩니다. API 키로 연동한 서비스는 status_url 의 REST 조회로도 읽습니다. safe_to_retry 가 false(기관에 쓰기를 하는 작업)면 원래 도구를 다시 부르지 말고 이 조회로 처리 여부를 확인합니다.
세션 만료세션이 만료됐거나 없습니다(오류 <원인 코드>).두 번째 블록의 next_action 에 적힌 로그인 도구를 먼저 부릅니다. 되돌릴 수 없는 작업이면 다시 보내기 전에 기관 화면에서 처리 여부를 확인합니다.
작업 실패작업이 실패했습니다(오류 <원인 코드>).원인 코드는 두 번째 블록의 error_code 에도 있습니다 — 오류 코드 표에서 원인을 봅니다.

HTTP 상태

상태언제
200정상 응답과 위 오류들 — 본문을 열어 확인합니다. 인증 정보 없이 tools/list 를 부르면 401 이 아니라 200 으로 공개 도구 목록이 옵니다. 맛보기로 열어 둔 도구는 인증 정보 없이 tools/call 을 불러도 하루 몫 안에서 200 으로 결과가 옵니다(MCP 연동 개요의 「계정 없이 맛보기」).
202알림(id 없는 요청)을 받았습니다. 본문은 비어 있거나 null 이며 읽을 것이 없습니다.
400지원하지 않는 MCP-Protocol-Version 헤더입니다.
401인증 정보 없이 맛보기로 열려 있지 않은 도구를 부르거나(tools/call), 맛보기 몫이 다 찼거나, 보낸 인증 정보가 잘못됐습니다. WWW-Authenticate 헤더가 함께 옵니다. ChatGPT 처럼 openai/* 메타를 보내는 앱은 인증 정보 없이 도구를 부르면 401 대신 200 과 isError 결과로 같은 안내를 받습니다.
403허용되지 않은 Origin 에서 브라우저로 호출했습니다. OAuth 토큰에 이 호출에 필요한 권한(scope)이 없을 때도 403 이고, WWW-Authenticate 에 insufficient_scope 가 실립니다.
405GET /mcp 은 지원하지 않습니다. POST 로 보냅니다.

다음 행동 안내 칸

일부 오류에는 error.data["xdata.kr/next"] 가 함께 옵니다.

  • 앱은 say_to_user 를 사용자에게 전하고, action_url 이 있으면 그 화면을 열도록 안내하면 됩니다.
  • 모든 오류에 있지는 않습니다. 아래 단계 표의 경우에만 실리고, 동시 실행 한도(-32008)나 로그인 진행 중(-32009) 같은 나머지 오류에는 없으며, 이 칸이 없으면 message 를 읽습니다.
  • 오류의 원인은 이 칸이 아니라 error.code 와 error.data 의 error_code 또는 reason 으로 판단합니다.

인증 정보 없이 도구를 부른 요청이 isError 결과로 돌아오는 경우(위 HTTP 상태 표의 401)와 정책 거절에서는 같은 칸이 result._meta["xdata.kr/next"] 에 실립니다.

여러 기관 조회를 한 번에 부르는 팩 도구에서는 이 칸이 있는 오류가 조회별 오류의 data(legs[].error.data) 안에 실립니다.

claim 과 phone_later 는 MCP 가 아니라, AI 에이전트가 사용자의 이메일로 계정을 만드는 REST 가입 응답의 본문에 같은 모양으로 실립니다(칸 이름은 next).

칸의 구성

칸뜻
stage안내의 종류입니다. 아래 표의 값 중 하나입니다. 새 값이 늘 수 있으니 모르는 값이면 say_to_user 만 전하세요.
say_to_user사용자에게 전할 한국어 문장입니다.
who안내를 따라 움직일 쪽입니다. user 는 사람이 해야 하는 일(가입, 자격증명 등록)이라 앱이 대신하지 말고 문장을 전합니다. agent 는 앱이 그 걸음을 직접 하는 일입니다(필요하면 인자를 넣어 다시 호출합니다). 사용자에게 시킬 일이 없을 수도 있습니다.
action_url사용자가 열 화면 주소입니다. 주소가 필요 없는 안내에는 없습니다.

단계

stagewho언제 오나안내하는 것
signupuser인증 정보가 없거나 알아볼 수 없는 형식의 인증 정보로 도구를 불렀을 때입니다(-32001, HTTP 401). 맛보기로 열어 둔 도구는 하루 몫 안에서 인증 정보 없이도 성공하므로 이 단계가 오지 않고 아래 taste 가 옵니다.가입 화면 주소와 무료로 쓸 수 있는 사용량입니다.
tasteagent계정 없이 맛보기로 열어 둔 도구를 불러 성공했을 때입니다. 오류가 아니라 알림이라 호출은 막히지 않고, 성공 응답의 result._meta 에 실립니다.이 조회가 쓴 사용 토큰과 가입하면 받는 하루 사용량입니다. action_url 은 가입 화면입니다.
taste_outagent계정 없이 쓰는 맛보기 몫을 오늘 다 썼거나(TASTE_DAILY_LIMIT), 서비스 전체 또는 같은 AI 앱의 손님들이 함께 쓰는 맛보기 몫이 찼을 때(TASTE_GLOBAL_LIMIT)입니다(-32001). 코드별 설명은 아래 맛보기 표에 있습니다.가입을 권하는 문장입니다. 전체 상한일 때는 다시 열리는 때를 함께 알립니다. action_url 은 가입 화면입니다.
quota_outagent남은 사용 토큰이 이번 호출에 모자랄 때입니다(result.isError). 데모 환경은 하루 몫과 조직 전체의 체험 총량이고, 정식 환경은 한도가 있는 요금제의 하루 몫과 한 달 몫입니다.한도가 다시 채워지는 시각과 요금제를 올리는 방법입니다. 데모의 체험 총량은 다시 채워지지 않아 요금제를 시작해야 이어 쓸 수 있습니다. action_url 은 콘솔 결제 화면입니다. 가장 큰 요금제에서 한 달 몫을 다 써 올릴 요금제가 없으면(reason 이 no_larger_self_serve_plan) 웹사이트 서비스 문의 화면입니다.
link_credentialuser 또는 agent등록한 자격증명이 없을 때와, 이 도구가 자격증명 id 를 인수로 받는데 넣지 않았을 때입니다(-32602). 앞의 경우는 user 이고 뒤의 경우는 agent 입니다. 블로그 글쓰기 작업이 블로그 로그인 연결이 끊겨 실패했을 때(result.isError, 작업 실패)도 user 로 옵니다.user 일 때는 자격증명을 등록하는 화면 주소입니다. agent 일 때는 쓸 자격증명의 id 를 확인하는 목록 주소이고, 앱이 그 id 를 account_link_id 로 넣어 다시 부릅니다. 같은 주소가 error.data.link_url 에도 있습니다. 블로그 작업 실패일 때 action_url 은 콘솔에서 연결 창을 바로 여는 주소이고, 둘째 블록에는 link_url 이 없습니다.
choose_bank_accountagent계좌를 고르는 칸(bank_account_credential_id)이 선택인 은행 조회를 그 칸 없이 불렀는데 연동한 계좌가 여러 개라 서버가 대신 고르지 않아 작업이 실패했을 때입니다(작업 실패, RESOURCE_CONFLICT). REST 는 작업 조회 응답의 error.next 칸으로 같은 안내가 옵니다.사용자에게 전할 문장(say_to_user)과 고를 수 있는 계좌 목록(choices: bank_account_credential_id, 가린 계좌번호 masked_account_no, 기본 계좌 여부 is_default)입니다. 앱이 하나를 골라(어느 계좌인지 정하기 어려우면 가린 계좌번호로 사용자에게 묻고) 그 bank_account_credential_id 를 넣어 같은 도구를 다시 부릅니다. action_url 은 없습니다. 목록은 작업이 실패한 뒤의 연동 계좌라 그 사이 계좌를 더하거나 뺐으면 그때와 다를 수 있습니다.
quota_lowagent도구 호출이 성공했고 오늘 남은 사용 토큰이 하루 몫의 절반보다 적을 때입니다. 오류가 아니라 알림이라 호출은 막히지 않고, 성공 응답의 result._meta 에 실립니다.남은 사용 토큰과 다시 채워지는 시각, 요금제를 올리는 방법입니다. action_url 은 콘솔 결제 화면입니다.
claimuserMCP 가 아니라 REST 에이전트 가입 응답 본문의 next 칸에 실립니다. 에이전트가 소유자 이메일로 계정을 만들었을 때와, 그 이메일에 이미 계정이 있을 때입니다.새 계정이면 사람이 계정을 넘겨받는 화면, 이미 계정이 있으면 사람이 키를 발급하는 콘솔 키 관리 화면이 action_url 입니다. 앱이 대신할 수 없습니다.
phone_lateruserMCP 가 아니라 REST 계정 넘겨받기 확인(confirm)이 끝났을 때 응답 본문의 next 칸에 실립니다.연락처는 지금 넣지 않아도 된다는 안내입니다. 막지 않고 권하는 안내이며 앱이 대신할 수 없습니다. action_url 은 콘솔 기본정보 화면입니다.
suspendeduser두 경우입니다(둘 다 result.isError). AI 에이전트가 가입시킨 계정의 키로 불렀는데 계정을 넘겨받은 사람이 콘솔 키 관리에서 계속 쓰기를 아직 누르지 않았을 때(REST 는 AUTHZ_FORBIDDEN 과 reason credential_takeover_pending), 그리고 조직이 정지되거나 폐쇄됐을 때입니다(REST 는 AUTHZ_FORBIDDEN 과 reason organization_not_active, HTTP 403 본문의 next 칸에도 같은 안내). reason 은 오류 코드의 reason 표에 있습니다.키 확인 대기면 사람이 계속 쓰기를 누르면 같은 키로 이어진다는 안내이고(키를 다시 발급할 필요가 없습니다) action_url 은 콘솔 키 관리 화면입니다. 조직 정지면 결제와 계정 상태를 확인하라는 안내이고 action_url 은 콘솔 결제 관리 화면입니다. 둘 다 앱이 대신할 수 없습니다.
consentuser이용약관이 바뀌어 사람이 다시 동의해야 해서 호출이 거절됐을 때입니다(COMPLIANCE_TOS_VERSION_OUTDATED). 도구를 부르면 result.isError 로 오고, REST 는 같은 경우 HTTP 403 본문의 next 칸으로 옵니다. tools/list 는 이 안내를 _meta["xdata.kr/refusal"] 과 _meta["xdata.kr/next"] 에 싣습니다.갱신된 이용약관에 동의해야 한다는 문장(say_to_user)과 콘솔 프로필 화면 주소(action_url)입니다. 동의는 사람이 콘솔에서 하며 앱이 대신할 수 없습니다. 콘솔은 동의가 옛 버전이면 어느 화면이든 재동의 창을 먼저 냅니다. 앱은 문장을 사용자에게 그대로 전하고 주소를 건넨 뒤, 사용자가 동의했다고 하면 같은 호출을 다시 합니다. 결제 동의로 호출이 거절되는 경우는 없어 이 단계가 오지 않습니다.

응답 예시

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32001,
    "message": "인증 정보가 없습니다. 아직 계정이 없다면 https://xboss.biz/auth/signup 에서 가입하세요. 현재 데모 혜택은 요금제 화면에서 확인할 수 있습니다. 이미 가입했다면 https://console.xdata.kr/keys 에서 키를 발급해 'Basic base64(client_id:client_secret)' 형식으로 입력해 주세요.",
    "data": {
      "xdata.kr/next": {
        "stage": "signup",
        "say_to_user": "아직 계정이 없다면 https://xboss.biz/auth/signup 에서 가입하세요. 현재 데모 혜택은 요금제 화면에서 확인할 수 있습니다.",
        "who": "user",
        "action_url": "https://xboss.biz/auth/signup"
      }
    }
  }
}

tools/list 가 도구 목록을 돌려주면 주소는 맞습니다.

Authorization 헤더를 보냈다면 인증도 맞지만, 헤더 없이 부르면 공개 도구 목록이 오므로 _meta["xdata.kr/lane"].source 가 anonymous 인지 확인합니다.

원인 코드가 PROVIDER_OUTCOME_UNCONFIRMED 면 다시 부르지 말고 기관 화면에서 처리 여부를 확인합니다.