인증
기존 워크스페이스 API 키를 사용합니다.
Codex는 Bearer 토큰용 환경 변수에서 API 키를 읽습니다. API 키를 브라우저 코드, URL, 저장소, 지원 메시지에 넣지 마세요.
READER MCP 가이드
Codex·Cursor·Antigravity에
Reader 도구 하나를 연결합니다.
기존 워크스페이스 API 키로 Codex, Cursor, Google Antigravity에 OngsooLabs MCP 서버를 연결합니다. 현재는 URL 읽기 도구 하나를 제공합니다.
Reader MCP
Production에서 사용 가능
크레딧 사용
성공한 Reader 결과에만 1크레딧을 사용합니다.
인증 실패, 잘못된 입력, 안전 정책 또는 요청 제한으로 거부된 요청에는 크레딧이 차감되지 않습니다.
첫 범위
현재 검증된 클라이언트 3종과 Reader 도구 1개를 지원합니다.
Claude Code는 접근 제한으로 확인 중입니다. 현재는 Reader 도구 1개만 제공합니다.
CODEX 설정
MCP 서버를 등록합니다.
https://ongsoolabs.com/mcp지정된 환경 변수에 API 키를 저장한 뒤 Codex 설정에 다음 서버 항목을 추가하세요.
[mcp_servers.ongsoolabs]
url = "https://ongsoolabs.com/mcp"
bearer_token_env_var = "ONGSOOLABS_API_KEY"reader_read_url
public HTTP/HTTPS URL → Reader result공개 HTTP 또는 HTTPS URL 하나를 읽고 표준 Reader 결과를 에이전트에 반환합니다.
| 파라미터 | 필수 여부 | 설명 |
|---|---|---|
url | 필수 | 최대 2,048자의 절대 형식 공개 HTTP 또는 HTTPS URL 하나입니다. |
idempotency_key | 필수 | 논리적 호출 하나를 위한 UUID-D 또는 대문자 ULID입니다. 정확히 같은 재시도에만 재사용하세요. |
재시도와 처리 기록
논리적 호출 하나를 안전하게 재시도합니다.
이전 결과: 같은 호출 식별값과 URL로 재시도하면 900초 동안 추가 크레딧 없이 이전 완료 결과를 반환합니다. 이후에는 새 식별값을 사용하세요.
실패: 처리 기록이 만료되면 크레딧 차감 없이 IDEMPOTENCY_RESULT_EXPIRED를 반환합니다. 안전하지 않은 URL과 거부된 입력도 크레딧이 차감되지 않습니다.