개발자 빠른 시작

AI 사용량 추적 API 및 통합

하나의 프로젝트와 이벤트로 시작하세요. 워크플로가 이미 실행되는 곳에 가시성을 더하세요.

하나의 프로젝트. 읽기 전용 맥락.

신호를 대화로 가져오세요.

두 연결 모두 계측된 사용량, 자동화 상태, 내부 고객 청구 추정치를 읽습니다. 먼저 전용 프로젝트 읽기 키를 만드세요. 공급자 API 키는 필요하지 않습니다.

로컬 Codex 플러그인

로컬 플러그인 다운로드

다운로드에는 INSTALL.md가 포함됩니다. 압축을 푼 후 다음을 실행하세요 npm ci --prefix server 해당 폴더에서 실행하세요. 아래 예시는 전체 애플리케이션 소스 구조를 사용합니다.

포함된 항목 사용 plugin/ 소스 패키지. 서버 의존성을 설치한 후 Codex 호스트가 지원하는 로컬 플러그인 절차로 패키지를 등록하세요.

npm ci --prefix plugin/server

# In your MCP host's secure environment:
TRACEWELL_URL=https://tracewell.bhsoftwareproductions.com
TRACEWELL_READ_KEY=YOUR_PROJECT_READ_KEY

패키지는 다음 위치에 로컬 stdio 서버를 선언합니다 plugin/mcp.json. 설정 세부 정보는 다음에 포함됩니다 docs/PLUGIN.md. 소스가 제공된다고 호스트에 플러그인이 설치된 것은 아닙니다.

ChatGPT 또는 호환 MCP 호스트

호스팅 엔드포인트와 OAuth 인증으로 사용자 지정 MCP 연결을 추가하세요. Tracewell 동의 페이지를 검토하고 전용 프로젝트 읽기 키를 승인하세요. 공급자 비밀 키나 읽기 키를 채팅에 붙여넣지 마세요.

호스팅 MCP 엔드포인트https://tracewell.bhsoftwareproductions.com/mcp

호스트, 계정, 관리자가 사용자 지정 MCP 연결을 지원해야 합니다. 소유자가 호스팅 OAuth 출처와 영구 저장을 설정해야 합니다. 이 페이지는 연결이 설치되었는지 검증하지 않습니다.

공식 ChatGPT 설정 가이드 열기

직접 전송한 메타데이터만.

JavaScript SDK · Python SDK

이 도구는 공급자 계정, 채팅 구독, 모든 대화를 검색하지 않습니다. 다른 프로젝트를 연결하려면 별도의 전용 읽기 키와 연결을 사용하세요.

프로젝트 읽기 키 만들기

프로젝트 만들기

워크스페이스에서 고객 및 프로젝트를 선택하고 업무 이름과 월별 USD 예산을 정하세요. 인증과 API가 설정된 경우에만 실제 워크스페이스 모드를 사용하세요.

프로젝트 열기 →

범위가 지정된 키 발급

해당 프로젝트의 수집 키를 만드세요. 비밀 키를 한 번 복사하여 서버에 보관하세요. 브라우저 코드에 넣거나 공급자 자격 증명을 Tracewell에 전송하지 마세요.

사용 메타데이터 보내기

curl https://YOUR_HOST/api/v1/usage \
  -H 'Authorization: Bearer YOUR_PROJECT_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"eventId":"unique-event-id","provider":"custom",
       "model":"my-model","costUsd":0.042}'

안전한 재시도를 위해 고유하고 고정된 eventId를 사용하세요. costUsd 또는 inputRatePerMillion과 outputRatePerMillion 모두를 토큰 수와 함께 제공하세요. 명시적인 가격 없이는 비용이 알 수 없음으로 유지됩니다. 모든 공급자·모델 이름을 지원합니다.

결과 보고

POST /api/v1/runs
{
  "eventId": "unique-run-id",
  "automationId": "YOUR_AUTOMATION_ID",
  "status": "success",
  "recordsProcessed": 12,
  "durationMs": 3400
}

먼저 자동화를 만드세요. 누락된 실행은 예상 간격에 5분을 더한 후 평가됩니다. 실패하거나 부족한 결과는 앱 내 알림을 생성합니다. 알림은 정보를 제공하며 상위 워크로드를 중단하지 않습니다.

Codex에 맥락 더하기

위 상자의 연결 빠른 시작을 사용하여 로컬 Codex 플러그인이나 호스팅 OAuth MCP 엔드포인트를 연결하세요. 둘 다 전용 프로젝트 읽기 권한으로 프로젝트 요약, 사용량, 자동화 결과, 내부 고객 청구 추정치를 제공합니다. 호스트 설정과 승인은 명시적으로 수행됩니다.

계측한 이벤트만 읽습니다. 채팅 구독을 검색하거나 모든 Codex·ChatGPT 대화를 검사하거나 계정 청구에서 비용을 추론하지 않습니다. API 호출을 측정하려면 수집 엔드포인트로 메타데이터를 보내세요. 공급자 비밀 키는 Tracewell 키와 별도로 관리하세요.

읽기 전용 프로젝트 키 만들기 →

페이로드를 간결하게

문서화된 메타데이터 필드만 허용됩니다. 프롬프트, 완성 응답, 공급자 비밀 키, 임의 필드는 거부됩니다. JSON 요청은 16 KB로 제한됩니다. 이벤트 ID의 범위는 프로젝트와 이벤트 유형입니다.