제한 및 오류

MCP 서버는 API, 웹사이트와 같은 할당량을 사용하며, 요청을 거부할 때는 어시스턴트가 그대로 전달할 수 있는 문장으로 이유를 알려 줍니다.

제한

	무료 계정	유료 요금제
일일 검색 횟수	100	요금제의 일일 검색 횟수(API, 웹사이트와 공유)
쿼리당 최대 행 수	1,000	요금제 한도
스니펫 포함 시 쿼리당 최대 행 수	20	요금제 한도. 스니펫 검색 1회가 차감됩니다
속도	계정당 분당 10회(API와 공유). 할당량 및 속도 제한을 참고하세요

어시스턴트에게 account를 호출해 달라고 하면 내 계정의 정확한 수치를 확인할 수 있습니다. page와 rows를 곱한 값은 쿼리당 최대 행 수를 넘을 수 없습니다. 검색 횟수는 UTC 자정에 초기화됩니다.

거부된 검색은 프로토콜 오류가 아닙니다. 도구는 isError: true, 어시스턴트가 사용자에게 전달할 수 있는 메시지, 그리고 구조화된 데이터 안의 코드로 응답합니다.

코드	의미
`empty_query`	`query`가 없습니다.
`page_too_deep`	`page`와 `rows`를 곱한 값이 요금제의 쿼리당 최대 행 수를 넘습니다.
`too_many_requests`	1분에 10회를 넘게 호출했습니다. 기다려야 할 시간(초)은 `retry_after`에 있습니다.
`quota_exceeded`	오늘의 검색 횟수를 모두 사용했습니다. 다시 사용할 수 있는 시각(UTC 자정)은 `resets_at`에 있습니다.
`snippet_quota_exceeded`	오늘의 스니펫 검색 횟수를 모두 사용했습니다. 스니펫 없는 검색은 계속할 수 있습니다.

증상	의미
어시스턴트가 다시 로그인하라고 하거나 401을 보고합니다	토큰이 없거나, 프로필 페이지에서 삭제 또는 연결 해제된 토큰입니다. 다시 연결하거나 새 토큰을 발급하세요.
PublicWWW 로그인 페이지가 나오기 전에 OAuth가 실패합니다	클라이언트가 먼저 자신을 등록하려 하는데, PublicWWW는 이를 지원하지 않습니다. 이 클라이언트에는 토큰을 사용하세요.
PublicWWW에서 허용 화면 대신 오류 페이지가 나옵니다	클라이언트의 식별 문서를 읽을 수 없거나, 문서에 돌아갈 주소가 없습니다. 아무 권한도 부여되지 않았습니다. 나중에 다시 시도하거나 토큰을 사용하세요.