페이지를 준비하고 있습니다
장바구니와 이동 정보는 유지됩니다.
페이지를 준비하고 있습니다
장바구니와 이동 정보는 유지됩니다.
PRESALES API GUIDE
수주되는 제안서의 노하우를 제공합니다. 작성은 사용자의 Codex가 맡고, 프리세일즈는 실무 문서에서 정리한 작성 노하우와 페이지별 템플릿을 API로 제공합니다. 페이지 자료 이용권을 새로 발급할 때 작성 1크레딧을 사용합니다. 일회성 충전 방식으로 월정액·자동 결제가 없습니다.
처음이라면 Codex로 RFP를 읽고 제안서 목차를 만드는 순서와 로그인 없는 공개 샘플을 먼저 확인하세요.
상품별 충전 가능 여부는 크레딧 관리 화면에서 확인하세요. 자료 준비 상태에 따라 신규 이용이 제한될 수 있습니다.
프리세일즈가 사용자의 OpenAI API 키를 받거나 대신 문서를 생성하는 방식이 아닙니다. Codex 이용료와 사용 한도는 사용자의 계정에 따릅니다. 기존 프리세일즈 문서 구매·판매는 그대로 이용할 수 있습니다.
PRESALES Proposal Knowhow 1.3.2가 공식 디렉터리에 공개되어 있습니다. 위 설치 버튼으로 플러그인을 설치한 뒤 프리세일즈 연결을 시작하세요. 설치·연결·자료 목록 조회는 무료입니다. 지원되는 설치 화면은 사용하는 앱과 계정에 따라 다를 수 있으며 MCP 직접 연결도 이용할 수 있습니다.
AI 간편 연결을 이용할 수 있습니다. 연결을 시작하면 프리세일즈의 로그인·권한 확인 화면이 열립니다. 처음 가입하는 경우 기존 회원가입과 같은 필수 정보·약관 확인을 마친 뒤 연결을 계속합니다.
권한을 승인하면 AI로 돌아가 자료를 요청할 수 있습니다. 비밀번호나 장기 API 키를 AI 대화에 입력하지 않아도 됩니다. 연결 권한은 자료·프로젝트·작성 잔액 조회와 페이지 자료 발급에 한정됩니다. 자동 결제나 회원 정보 수정 기능은 포함하지 않습니다.
Codex 연결 방법을 확인하세요. 연결한 앱은 AI 연결 관리에서 해제할 수 있습니다. 사이트 로그아웃과 AI 연결 해제는 별개입니다.
“프리세일즈 자료를 이용해 제안서를 작성해 줘. 먼저 목차와 사용할 페이지 예산을 보여 주고, 내 승인 후에만 자료 이용권을 발급해 줘.”처럼 요청하세요. 스킬·플러그인은 설치된 환경에서 활용되며 모든 AI 사용자의 자동 연결이나 추천을 보장하지 않습니다.
PPT 작성은 사용자의 Codex가 수행합니다. 프리세일즈는 실무 문서에서 정리한 글꼴·색상·여백·표·도형의 구성 가이드를 제공합니다. 이 경로에서는 프리세일즈의 생성 모델을 호출하지 않으며, Codex 이용료와 사용 한도는 고객 계정에 따릅니다.
원본 PPTX·원본 이미지·예시 사업 본문을 제공하지 않습니다. 고객의 RFP와 확인된 회사 자료를 사용해 새 내용을 작성하세요. 예시 기업·지역·실적·인증을 실제 고객의 근거로 사용하지 마세요.
| 출력 형식 | 적용 방식 |
|---|---|
| A4 세로 | 210 × 297mm. A3의 왼쪽 A4와 오른쪽 A4를 각각 독립된 한 장으로 구성합니다. 이웃 면을 한 장에 축소해 넣지 않습니다. |
| A3 가로 | 420 × 297mm. 두 면의 제목·본문·쪽 번호 영역을 구분한 인쇄용 구성을 사용합니다. |
| 16:9 발표형 | 가로 화면에 맞게 내용을 다시 배치합니다. 인쇄용 작은 글자를 그대로 축소하지 않고 내용이 길면 페이지 분할을 먼저 계획합니다. |
목차·본문 등 유료 페이지의 새 자료 이용권 1건 발급마다 작성 1크레딧입니다. 표지·간지는 과금에서 제외하며 표지 디자인은 제공하지 않습니다. 왼쪽·오른쪽을 A4 두 장으로 작성하려면 서로 다른 페이지 ID 두 개를 계획합니다. 같은 페이지의 같은 자료·목적·배치를 재수령하거나 로컬에서 수정할 때에는 추가 차감이 없습니다. 서버는 발급한 이용권을 집계하며 최종 로컬 PPT 장수를 자동 측정하지 않습니다.
양식 목록의 presentations에서 실제 제공 중인 스타일·버전·출력 형식을 확인하세요. 기존 발급 자료는 그대로 재수령할 수 있습니다. 새 자료 발급 전에 페이지 계획과 역할을 확인하세요.
pagePlan으로 표지·간지를 포함한 전체 순서를 보내고, 유료 대상 페이지 수를 budget으로 보냅니다. 스타일을 사용하면 presentation도 지정합니다. 재개할 때 같은 요청 ID와 선택값을 사용하고, 양식을 자동 교체하지 않습니다.{
"requestId": "8fcf02cb-0d93-41b8-a7b4-cc177d77dd71",
"title": "A4 제안서",
"budget": 2,
"pagePlan": [
{
"role": "cover"
},
{
"role": "body"
},
{
"role": "body"
},
{
"role": "section"
}
],
"presentation": {
"styleId": "presales-practical",
"version": "1.0.0",
"format": "a4-portrait"
}
}페이지 발급에는 layout.role과 layout.panel을 지정합니다. 아래 ID는 예시이므로 프로젝트 응답의 서로 다른 페이지 ID와 실제 자료 목록의 ID로 바꾸세요. MCP에서는 projectId도 함께 전달합니다.
{
"pages": [
{
"pageId": "11111111-1111-4111-8111-111111111111",
"bundleId": "33333333-3333-4333-8333-333333333333",
"purpose": "추진 방향",
"layout": {
"role": "body",
"panel": "left"
}
},
{
"pageId": "22222222-2222-4222-8222-222222222222",
"bundleId": "33333333-3333-4333-8333-333333333333",
"purpose": "실행 방안",
"layout": {
"role": "body",
"panel": "right"
}
}
]
}유료 자료 발급 역할은 contents(목차), body(본문), key-point(핵심 메시지), table(표), process(절차), architecture(구성도), schedule(WBS·일정), organization(조직). 표지(cover)·간지(section)는 페이지 계획에만 포함하고 유료 자료를 요청하지 않습니다. A4·16:9는 left 또는 right, A3는 spread를 사용합니다.
Codex는 발급된 presentation 가이드를 읽고 편집 가능한 텍스트·표·도형을 만들어야 합니다. 필요한 글꼴이 없으면 대체 사실을 알리고 줄바꿈을 다시 확인하세요. 실제 파일 생성, 글자 넘침·한글·표 편집·이미지 교체와 PowerPoint 표시를 검수하고, 확인하지 못한 항목은 미검증으로 표시하세요.
회원가입과 필수 동의를 완료한 계정에서 분석 크레딧을 충전합니다. 분석 3크레딧은 2,000원, 분석 10크레딧은 5,900원입니다. 분석·작성 크레딧 충전 시 적립금 1원을 구매대금 1원으로 사용하며 카드와 함께 결제하거나 적립금만으로 충전할 수 있습니다. 실제 결제수단의 이용 가능 여부는 충전 화면의 준비 상태를 확인하세요.
충전 화면은 사용 가능한 적립금을 먼저 적용해 결제 예정 내역을 보여줍니다. 사용액은 직접 바꾸거나 0원을 선택할 수 있습니다. 상품 총액·적립금 사용액·예상 잔액·카드 청구액·지급 수량을 확인한 뒤 결제하세요. 적립금 전액 결제는 카드 결제창 없이 완료됩니다. 카드 결제는 서버에서 승인과 충전을 확인한 뒤 사용할 수 있습니다. 현재 이용 가능한 결제수단과 분석 준비 상태는 충전 화면에 표시됩니다.
분석은 프리세일즈 문서 분석에서 진행합니다. 시작할 때 1크레딧을 예약하고 결과 저장 성공 시 소진합니다. 실패·취소 시 해당 예약이 반환되며 현금이나 적립금이 다시 차감되지 않습니다.
작성용 MCP 도구에는 분석 실행이나 자동 충전 기능이 없습니다. API 키 발급 자체에는 구매가 필수는 아니며, 유료 작성 자료 발급에는 작성 잔액이 필요합니다. 작성 100크레딧 99,000원에 적립금 10,000원을 사용하면 카드액은 89,000원이며 100크레딧 전부를 받습니다. 실제 잔액이 3,000원이면 카드액은 96,000원입니다. 가입 쿠폰은 충전에 적용되지 않습니다.
크레딧 관리에서 원화 적립금 내역, 크레딧 사용 내역, 거래명세를 확인합니다. 사이트 거래명세와 카드 매출전표는 구분되며 적립금 사용액을 국세청 현금영수증 금액으로 표시하지 않습니다. 환급은 구매 상세에서 신청하면 관리자가 사용 내역과 원 결제수단을 검토합니다.
| 상품 | 가격 | 이용 범위 |
|---|---|---|
| 분석 3크레딧 | 2,000원 | 분석 3회 |
| 분석 10크레딧 | 5,900원 | 분석 10회 |
| 작성 100크레딧 | 99,000원 | 100페이지 자료 이용권 |
| 작성 200크레딧 | 190,000원 | 200페이지 자료 이용권 |
부가세 포함, 일회성 충전입니다. 월정액·자동 결제가 없습니다. 분석 크레딧과 작성 크레딧은 별도 잔액으로 관리합니다.
전체 100쪽이 표지 1쪽·간지 5쪽·목차 2쪽·본문 92쪽이면 유료 자료는 94쪽입니다. 전부 발급하면 작성 100개 중 6개가 남습니다.
예약 예: 유료 100크레딧 예약 → 78페이지 발급 → 22크레딧 예약 해제
프로젝트를 만들 때 100크레딧을 예약하고, 자료를 받은 78페이지만 사용합니다. 종료 후 남은 22크레딧은 다음 프로젝트에 사용할 수 있습니다. 예약은 최대 30일이며, 예약 만료는 미사용 크레딧의 소멸이 아닙니다.
작성 상품은 작성 지침·템플릿 이용권입니다. 완성된 제안서 납품이나 수주를 보장하는 상품이 아니며, 판매 원본 전체의 다운로드 권한을 포함하지 않습니다.
OAuth 간편 연결을 이용했다면 API 키를 별도로 발급할 필요가 없습니다. 직접 API 키를 관리하는 연결 방식을 선택할 때 아래 단계를 따르세요.
PRESALES_API_KEY 환경변수로 전달합니다. 대화창이나 공개 프로젝트 파일에 붙여 넣지 마세요.~/.codex/config.toml에 아래 연결 정보를 추가합니다. 설정에는 키 값이 아닌 환경변수 이름만 저장합니다.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 안내에서도 확인할 수 있습니다.
| 도구 | 기능 | 크레딧 |
|---|---|---|
| presales_catalog | 사용 가능한 자료 목록 조회 | 차감 없음 |
| presales_projects | 내 프로젝트와 작성 잔액 조회 | 차감 없음 |
| presales_create_project | 페이지 예산 예약·페이지 ID 생성 | 예약만 진행 |
| presales_plan_project | 미발급 페이지 계획 확정·기존 발급 페이지 보존 | 예약 수량 조정 |
| presales_get_project | 프로젝트·페이지 발급 상태 조회 | 차감 없음 |
| presales_issue_pages | 페이지별 자료 이용권 발급 | 신규 발급 페이지당 1크레딧 |
| presales_close_project | 프로젝트 종료·미사용 예약 해제 | 차감 없음 |
Codex에는 “프리세일즈 자료를 이용해 제안서를 작성해 줘. 먼저 목차와 100페이지 이내 예산을 보여 주고, 확인한 뒤 자료 이용권을 발급해 줘.”처럼 요청하세요.
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":2,"pagePlan":[{"role":"cover"},{"role":"contents"},{"role":"body"},{"role":"section"}]}'새 프로젝트에는 새 UUID requestId를 사용합니다. 통신 오류로 같은 생성을 다시 요청할 때는 원래 ID와 내용을 그대로 유지합니다. 응답의 project.id와 pages[].id를 보관하세요. 예산은 1~200페이지입니다.
# 응답에서 받은 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는 페이지별 발급 상태를 반환합니다. 종료 뒤에도 이미 발급한 동일 자료는 다시 받을 수 있습니다.
통신이 끊겨도 서버에서 발급이 끝났을 수 있습니다. 프로젝트를 조회한 다음 같은 요청 ID와 페이지 ID, 같은 내용으로 다시 요청하세요. 새 페이지 ID로 재시도하면 새 이용권으로 처리되어 차감될 수 있습니다.
| 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 | 종료된 프로젝트에 새 페이지를 발급할 수 없습니다. 자료의 제공 상태도 확인하세요. |
| 409 | presentation_disabled / presentation_required | 양식 제공 상태와 기존 프로젝트의 양식·배치를 확인하세요. 입력을 지우거나 새 이용권을 만들어 우회하지 마세요. |
| 409 | page_plan_required / page_plan_immutable / page_role_conflict | 전체 페이지 계획과 역할을 확인하세요. 기존 발급 ID를 보존해 계획을 제출하고 첫 발급 후에는 계획을 바꿀 수 없습니다. |
| 429 | rate_limited | 반복 호출을 멈추고 Retry-After가 있으면 해당 시간 뒤 재시도하세요. |
| 503 | service_unavailable | 자료·결제 서비스가 준비되지 않았거나 일시 중단되었습니다. 자동 반복 결제를 하지 마세요. |
위 HTTP 상태는 REST API 기준입니다. MCP 도구 호출은 응답의 isError와 content 안의 오류 코드를 확인하세요. 키 발급·폐기는 로그인한 사이트에서 진행합니다. Codex용 API 키로 다른 키를 발급하거나 결제할 수 없습니다.
기기별로 다른 키를 발급하고 사용하지 않는 키는 폐기하세요. 키가 노출되었거나 분실되면 해당 키를 폐기한 뒤 새 키로 연결합니다. 기존 키 전체를 다시 조회하는 기능은 없습니다.
프리세일즈 자료는 작성 참고 자료입니다. Codex가 만든 내용은 제출 전에 사실·수치·RFP 충족 여부를 검토하세요. 프리세일즈에 회사 자료 원문을 보낼 필요는 없으며, 요청 제목과 페이지 목적에는 불필요한 개인정보·기밀을 포함하지 마세요.
도움이 필요하면 help@presales.co.kr로 오류 코드, 발생 시각, 프로젝트 또는 결제 번호를 알려주세요. API 키·카드 번호·고객 원문은 보내지 마세요.