PRESALES API GUIDE

내 Codex에 제안서 노하우를 연결하세요

작성은 사용자의 Codex가 맡고, 프리세일즈는 페이지에 필요한 작성 지침과 템플릿을 제공합니다. 자료 이용권을 발급할 때만 작성 크레딧을 사용합니다.

상품별 충전 가능 여부는 크레딧 관리 화면에서 확인하세요. 자료 준비 상태에 따라 신규 이용이 제한될 수 있습니다.

1. 연결하고, 페이지를 계획하고, 자료를 받으세요

크레딧 충전: 프리세일즈 회원 계정에서 분석 또는 작성 크레딧을 구매합니다.
Codex 연결: 전용 API 키를 발급해 본인의 Codex 실행 환경에 연결합니다.
페이지 계획: Codex가 RFP와 회사 자료를 읽고 목차를 정리합니다. 사용할 페이지 예산을 확인한 뒤 프로젝트를 만듭니다.
자료 이용권 발급: Codex가 서버의 페이지 ID로 필요한 자료를 요청합니다. 신규 발급 1페이지마다 작성 1크레딧이 차감됩니다.
작성과 검토: Codex가 받은 지침·템플릿을 이용해 PPTX를 작성합니다. 미사용 예산은 프로젝트 종료 시 예약을 해제합니다.

프리세일즈가 사용자의 OpenAI API 키를 받거나 대신 문서를 생성하는 방식이 아닙니다. Codex 이용료와 사용 한도는 사용자의 계정에 따릅니다. 기존 프리세일즈 문서 구매·판매는 그대로 이용할 수 있습니다.

2. 크레딧은 자료 이용권을 발급할 때 차감합니다

부가세 포함 크레딧 상품 가격
상품	가격	이용 범위
분석 3크레딧	2,000원	분석 3회
분석 10크레딧	5,900원	분석 10회
작성 100크레딧	99,000원	100페이지 자료 이용권
작성 200크레딧	190,000원	200페이지 자료 이용권

부가세 포함, 일회성 충전입니다. 월정액·자동 결제가 없습니다. 분석 크레딧과 작성 크레딧은 별도 잔액으로 관리합니다.

페이지 기준: PPT 슬라이드 1장을 1페이지로 봅니다. 표지·목차·부록도 자료 이용권을 발급하면 1크레딧입니다.
무료 이용: 잔액·목록·발급 상태 조회, 동일 페이지의 동일 자료 재수령, 받은 자료의 로컬 편집·다운로드에는 추가 차감이 없습니다.
과금 기준: 서버가 자료를 준비하고 페이지 이용권을 발급하면 차감됩니다. 최종 문서에서 페이지를 삭제해도 이미 발급한 이용권은 사용한 것으로 남습니다.
서로 다른 자료: 이미 발급한 페이지의 자료나 작성 목적을 바꾸는 요청은 거절됩니다. 다른 자료가 필요하면 새 페이지 ID로 별도의 이용권을 발급해야 합니다.
집계 범위: 서버는 발급한 이용권을 집계합니다. 사용자의 로컬 문서 페이지 수나 복제한 슬라이드 수를 자동 감시하지 않습니다.

예: 100크레딧 예약 → 78페이지 발급 → 22크레딧 예약 해제

프로젝트를 만들 때 100크레딧을 예약하고, 자료를 받은 78페이지만 사용합니다. 종료 후 남은 22크레딧은 다음 프로젝트에 사용할 수 있습니다. 예약은 최대 30일이며, 예약 만료는 미사용 크레딧의 소멸이 아닙니다.

작성 상품은 작성 지침·템플릿 이용권입니다. 완성된 제안서 납품이나 수주를 보장하는 상품이 아니며, 판매 원본 전체의 다운로드 권한을 포함하지 않습니다.

3. Codex에 프리세일즈 연결하기

크레딧·API 키 관리에서 이름을 정해 키를 발급합니다. 키 전체는 발급 직후 한 번만 표시됩니다.
키를 비밀 저장소에 보관하고, Codex가 실행되는 환경의 PRESALES_API_KEY 환경변수로 전달합니다. 대화창이나 공개 프로젝트 파일에 붙여 넣지 마세요.
Codex 설정 파일 ~/.codex/config.toml에 아래 연결 정보를 추가합니다. 설정에는 키 값이 아닌 환경변수 이름만 저장합니다.
Codex를 다시 시작하고 presales_catalog로 자료 목록을 조회합니다. 목록 조회에는 크레딧이 차감되지 않습니다.

[mcp_servers.presales]
url = "https://presales.co.kr/api/presales-knowhow/mcp"
bearer_token_env_var = "PRESALES_API_KEY"
# 자료 이용권 발급 전에 Codex의 도구 실행 내용을 확인하세요.
default_tools_approval_mode = "prompt"

환경변수가 전달되지 않으면 인증에 실패합니다. 터미널에서 설정한 환경변수가 이미 실행 중인 데스크톱 앱에 자동 전달되지는 않습니다. 사용하는 Codex 실행 환경의 비밀 설정 방법을 확인하세요. 연결 설정은 OpenAI 공식 MCP 안내에서도 확인할 수 있습니다.

프리세일즈 MCP 도구와 차감 기준
도구	기능	크레딧
presales_catalog	사용 가능한 자료 목록 조회	차감 없음
presales_projects	내 프로젝트와 작성 잔액 조회	차감 없음
presales_create_project	페이지 예산 예약·페이지 ID 생성	예약만 진행
presales_get_project	프로젝트·페이지 발급 상태 조회	차감 없음
presales_issue_pages	페이지별 자료 이용권 발급	신규 발급 페이지당 1크레딧
presales_close_project	프로젝트 종료·미사용 예약 해제	차감 없음

Codex에는 “프리세일즈 자료를 이용해 제안서를 작성해 줘. 먼저 목차와 100페이지 이내 예산을 보여 주고, 확인한 뒤 자료 이용권을 발급해 줘.”처럼 요청하세요.

4. 직접 API를 연결하는 경우

HTTPS 요청에 Authorization: Bearer 인증 헤더를 사용합니다. 아래 예시의 환경변수에는 본인의 값을 설정하세요. API 키를 URL의 쿼리나 요청 본문에 넣지 마세요.

자료 목록 조회 · 차감 없음

BASE="https://presales.co.kr/api/presales-knowhow"
curl --fail-with-body "$BASE/catalog" \
  -H "Authorization: Bearer $PRESALES_API_KEY"

응답 bundles에서 자료의 ID·버전·제목·분류·요약을 확인할 수 있습니다.

프로젝트 생성 · 작성 크레딧 예약

curl --fail-with-body "$BASE/projects" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"requestId":"8fcf02cb-0d93-41b8-a7b4-cc177d77dd71","title":"신규 서비스 제안서","budget":100}'

새 프로젝트에는 새 UUID requestId를 사용합니다. 통신 오류로 같은 생성을 다시 요청할 때는 원래 ID와 내용을 그대로 유지합니다. 응답의 project.id와 pages[].id를 보관하세요. 예산은 1~200페이지입니다.

페이지 자료 발급 · 신규 페이지당 1크레딧

# 응답에서 받은 project.id, pages[0].id와 catalog의 bundle.id를 사용합니다.
# PROJECT_ID, PAGE_ID, BUNDLE_ID를 먼저 해당 값으로 설정하세요.
curl --fail-with-body "$BASE/projects/$PROJECT_ID/pages" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data @- <<JSON
{"pages":[{"pageId":"$PAGE_ID","bundleId":"$BUNDLE_ID","purpose":"사업 이해와 추진 방향"}]}
JSON

한 번에 1~10페이지를 요청할 수 있습니다. 응답의 grants에 페이지별 자료가 담기고, charged는 이번 요청에서 새로 차감한 크레딧 수입니다. 동일한 pageId·bundleId·purpose로 재요청하면 중복 차감 없이 같은 자료를 받습니다.

프로젝트 종료 · 미사용 예약 해제

curl --fail-with-body "$BASE/projects/$PROJECT_ID/close" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{}'

응답의 released는 해제한 예약량입니다. GET /projects는 프로젝트 목록과 작성 잔액을, GET /projects/프로젝트ID는 페이지별 발급 상태를 반환합니다. 종료 뒤에도 이미 발급한 동일 자료는 다시 받을 수 있습니다.

5. 오류가 나면 새 요청을 만들기 전에 확인하세요

통신이 끊겨도 서버에서 발급이 끝났을 수 있습니다. 프로젝트를 조회한 다음 같은 요청 ID와 페이지 ID, 같은 내용으로 다시 요청하세요. 새 페이지 ID로 재시도하면 새 이용권으로 처리되어 차감될 수 있습니다.

API 오류 코드별 대응
HTTP	오류 코드	대응
400	invalid_request	요청 형식·UUID·페이지 예산을 확인하세요.
401	invalid_api_key	키 값과 폐기 여부, Codex 실행 환경의 환경변수를 확인하세요.
403	account_inactive / session_required	회원 상태를 확인하세요. 키 관리에는 사이트 로그인이 필요합니다.
404	feature_disabled / not_found	서비스 개통 상태와 프로젝트 주소를 확인하세요.
402	insufficient_credits	작성 크레딧을 충전하거나 다른 프로젝트의 미사용 예약을 해제하세요.
409	idempotency_conflict	동일 요청 ID 또는 페이지 ID에 다른 내용을 보냈습니다. 기존 요청을 조회하세요.
409	project_closed / bundle_unavailable	종료된 프로젝트에 새 페이지를 발급할 수 없습니다. 자료의 제공 상태도 확인하세요.
429	rate_limited	반복 호출을 멈추고 Retry-After가 있으면 해당 시간 뒤 재시도하세요.
503	service_unavailable	자료·결제 서비스가 준비되지 않았거나 일시 중단되었습니다. 자동 반복 결제를 하지 마세요.

위 HTTP 상태는 REST API 기준입니다. MCP 도구 호출은 응답의 isError와 content 안의 오류 코드를 확인하세요. 키 발급·폐기는 로그인한 사이트에서 진행합니다. Codex용 API 키로 다른 키를 발급하거나 결제할 수 없습니다.

6. 키 보관과 고객지원

기기별로 다른 키를 발급하고 사용하지 않는 키는 폐기하세요. 키가 노출되었거나 분실되면 해당 키를 폐기한 뒤 새 키로 연결합니다. 기존 키 전체를 다시 조회하는 기능은 없습니다.

프리세일즈 자료는 작성 참고 자료입니다. Codex가 만든 내용은 제출 전에 사실·수치·RFP 충족 여부를 검토하세요. 프리세일즈에 회사 자료 원문을 보낼 필요는 없으며, 요청 제목과 페이지 목적에는 불필요한 개인정보·기밀을 포함하지 마세요.

도움이 필요하면 help@presales.co.kr로 오류 코드, 발생 시각, 프로젝트 또는 결제 번호를 알려주세요. API 키·카드 번호·고객 원문은 보내지 마세요.

페이지를 준비하고 있습니다

장바구니와 이동 정보는 유지됩니다.

1. 연결하고, 페이지를 계획하고, 자료를 받으세요

크레딧 충전: 프리세일즈 회원 계정에서 분석 또는 작성 크레딧을 구매합니다.
Codex 연결: 전용 API 키를 발급해 본인의 Codex 실행 환경에 연결합니다.
페이지 계획: Codex가 RFP와 회사 자료를 읽고 목차를 정리합니다. 사용할 페이지 예산을 확인한 뒤 프로젝트를 만듭니다.
자료 이용권 발급: Codex가 서버의 페이지 ID로 필요한 자료를 요청합니다. 신규 발급 1페이지마다 작성 1크레딧이 차감됩니다.
작성과 검토: Codex가 받은 지침·템플릿을 이용해 PPTX를 작성합니다. 미사용 예산은 프로젝트 종료 시 예약을 해제합니다.

2. 크레딧은 자료 이용권을 발급할 때 차감합니다

부가세 포함 크레딧 상품 가격
상품	가격	이용 범위
분석 3크레딧	2,000원	분석 3회
분석 10크레딧	5,900원	분석 10회
작성 100크레딧	99,000원	100페이지 자료 이용권
작성 200크레딧	190,000원	200페이지 자료 이용권

부가세 포함, 일회성 충전입니다. 월정액·자동 결제가 없습니다. 분석 크레딧과 작성 크레딧은 별도 잔액으로 관리합니다.

페이지 기준: PPT 슬라이드 1장을 1페이지로 봅니다. 표지·목차·부록도 자료 이용권을 발급하면 1크레딧입니다.
무료 이용: 잔액·목록·발급 상태 조회, 동일 페이지의 동일 자료 재수령, 받은 자료의 로컬 편집·다운로드에는 추가 차감이 없습니다.
과금 기준: 서버가 자료를 준비하고 페이지 이용권을 발급하면 차감됩니다. 최종 문서에서 페이지를 삭제해도 이미 발급한 이용권은 사용한 것으로 남습니다.
서로 다른 자료: 이미 발급한 페이지의 자료나 작성 목적을 바꾸는 요청은 거절됩니다. 다른 자료가 필요하면 새 페이지 ID로 별도의 이용권을 발급해야 합니다.
집계 범위: 서버는 발급한 이용권을 집계합니다. 사용자의 로컬 문서 페이지 수나 복제한 슬라이드 수를 자동 감시하지 않습니다.

예: 100크레딧 예약 → 78페이지 발급 → 22크레딧 예약 해제

3. Codex에 프리세일즈 연결하기

크레딧·API 키 관리에서 이름을 정해 키를 발급합니다. 키 전체는 발급 직후 한 번만 표시됩니다.
키를 비밀 저장소에 보관하고, Codex가 실행되는 환경의 PRESALES_API_KEY 환경변수로 전달합니다. 대화창이나 공개 프로젝트 파일에 붙여 넣지 마세요.
Codex 설정 파일 ~/.codex/config.toml에 아래 연결 정보를 추가합니다. 설정에는 키 값이 아닌 환경변수 이름만 저장합니다.
Codex를 다시 시작하고 presales_catalog로 자료 목록을 조회합니다. 목록 조회에는 크레딧이 차감되지 않습니다.

[mcp_servers.presales]
url = "https://presales.co.kr/api/presales-knowhow/mcp"
bearer_token_env_var = "PRESALES_API_KEY"
# 자료 이용권 발급 전에 Codex의 도구 실행 내용을 확인하세요.
default_tools_approval_mode = "prompt"

프리세일즈 MCP 도구와 차감 기준
도구	기능	크레딧
presales_catalog	사용 가능한 자료 목록 조회	차감 없음
presales_projects	내 프로젝트와 작성 잔액 조회	차감 없음
presales_create_project	페이지 예산 예약·페이지 ID 생성	예약만 진행
presales_get_project	프로젝트·페이지 발급 상태 조회	차감 없음
presales_issue_pages	페이지별 자료 이용권 발급	신규 발급 페이지당 1크레딧
presales_close_project	프로젝트 종료·미사용 예약 해제	차감 없음

4. 직접 API를 연결하는 경우

자료 목록 조회 · 차감 없음

BASE="https://presales.co.kr/api/presales-knowhow"
curl --fail-with-body "$BASE/catalog" \
  -H "Authorization: Bearer $PRESALES_API_KEY"

응답 bundles에서 자료의 ID·버전·제목·분류·요약을 확인할 수 있습니다.

프로젝트 생성 · 작성 크레딧 예약

curl --fail-with-body "$BASE/projects" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{"requestId":"8fcf02cb-0d93-41b8-a7b4-cc177d77dd71","title":"신규 서비스 제안서","budget":100}'

페이지 자료 발급 · 신규 페이지당 1크레딧

# 응답에서 받은 project.id, pages[0].id와 catalog의 bundle.id를 사용합니다.
# PROJECT_ID, PAGE_ID, BUNDLE_ID를 먼저 해당 값으로 설정하세요.
curl --fail-with-body "$BASE/projects/$PROJECT_ID/pages" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data @- <<JSON
{"pages":[{"pageId":"$PAGE_ID","bundleId":"$BUNDLE_ID","purpose":"사업 이해와 추진 방향"}]}
JSON

프로젝트 종료 · 미사용 예약 해제

curl --fail-with-body "$BASE/projects/$PROJECT_ID/close" \
  -H "Authorization: Bearer $PRESALES_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{}'

5. 오류가 나면 새 요청을 만들기 전에 확인하세요

API 오류 코드별 대응
HTTP	오류 코드	대응
400	invalid_request	요청 형식·UUID·페이지 예산을 확인하세요.
401	invalid_api_key	키 값과 폐기 여부, Codex 실행 환경의 환경변수를 확인하세요.
403	account_inactive / session_required	회원 상태를 확인하세요. 키 관리에는 사이트 로그인이 필요합니다.
404	feature_disabled / not_found	서비스 개통 상태와 프로젝트 주소를 확인하세요.
402	insufficient_credits	작성 크레딧을 충전하거나 다른 프로젝트의 미사용 예약을 해제하세요.
409	idempotency_conflict	동일 요청 ID 또는 페이지 ID에 다른 내용을 보냈습니다. 기존 요청을 조회하세요.
409	project_closed / bundle_unavailable	종료된 프로젝트에 새 페이지를 발급할 수 없습니다. 자료의 제공 상태도 확인하세요.
429	rate_limited	반복 호출을 멈추고 Retry-After가 있으면 해당 시간 뒤 재시도하세요.
503	service_unavailable	자료·결제 서비스가 준비되지 않았거나 일시 중단되었습니다. 자동 반복 결제를 하지 마세요.

6. 키 보관과 고객지원

도움이 필요하면 help@presales.co.kr로 오류 코드, 발생 시각, 프로젝트 또는 결제 번호를 알려주세요. API 키·카드 번호·고객 원문은 보내지 마세요.

1. 연결하고, 페이지를 계획하고, 자료를 받으세요

2. 크레딧은 자료 이용권을 발급할 때 차감합니다

3. Codex에 프리세일즈 연결하기

4. 직접 API를 연결하는 경우

자료 목록 조회 · 차감 없음

프로젝트 생성 · 작성 크레딧 예약

페이지 자료 발급 · 신규 페이지당 1크레딧

프로젝트 종료 · 미사용 예약 해제

5. 오류가 나면 새 요청을 만들기 전에 확인하세요

6. 키 보관과 고객지원

7. 제안서 API 안내 공유하기

1. 연결하고, 페이지를 계획하고, 자료를 받으세요

2. 크레딧은 자료 이용권을 발급할 때 차감합니다

3. Codex에 프리세일즈 연결하기

4. 직접 API를 연결하는 경우

자료 목록 조회 · 차감 없음

프로젝트 생성 · 작성 크레딧 예약

페이지 자료 발급 · 신규 페이지당 1크레딧

프로젝트 종료 · 미사용 예약 해제

5. 오류가 나면 새 요청을 만들기 전에 확인하세요

6. 키 보관과 고객지원

7. 제안서 API 안내 공유하기