API · MCP 개발자 연동

계약을 우리 시스템에서
자동으로, 추가요금 없이

REST API와 MCP로 ERP·CRM 등 자사 시스템에서 계약을 자동으로 만들고 보내세요. Claude·Codex 같은 AI 도구가 직접 호출하게 만들 수도 있어요. sk_ API 키만 발급하면 시작돼요. 요금은 정직하게 — 유료 플랜 회원은 API·MCP 호출 추가요금이 0원이고, 발송 1건만 발송권에서 차감돼요.

MCP 8 tool REST API sk_ API 키 API 추가요금 0원 OAuth 예정
API 키 발급(인앱) 개발자·MCP 문서 보기

베타·얼리액세스 단계예요. AI 작성·API·MCP 연동은 유료 플랜 전용이고, 무료 회원은 PDF 업로드 발송을 써요. 발송 결제 충전은 순차 오픈돼요. 호출 경로·필드명은 정식 출시 전 바뀔 수 있어요.

무엇을 할 수 있나요

REST API와 MCP, 두 가지 연동 경로

자체 서버에 통합하려면 REST API를, AI 도구가 대화로 계약을 다루게 하려면 MCP를 쓰세요. 두 경로 모두 같은 백엔드와 같은 안전 모델(dry_run → confirmation_token)을 공유해요.

REST API

자사 시스템(ERP·CRM·백오피스)에서 계약 초안 생성 → 서명자 추가 → 발송까지 직접 호출해요. 생성·발송 요청에는 Idempotency-Key로 중복을 막아요.

https://api.signdeal.kr/v1

MCP 서버

Claude·Codex 등 MCP 호환 AI에 싸인딜을 연결하면, 자연어 한 줄로 초안·서명필드 배치·발송 준비까지 이어져요. AI가 직접 tool을 호출해요.

https://mcp.signdeal.kr · Streamable HTTP

상태 추적·웹훅

계약 상태(진행·체결·거절·만료)를 조회하고, 변화는 서명된 웹훅으로 받아요. 같은 백엔드라 웹앱·API·MCP 어디서 보내도 한 곳에서 관리돼요. 웹훅 예정

요금

유료 회원 API 추가요금 0원

API·MCP를 쓴다고 따로 요금이 붙지 않아요. 정확히 말하면 — 유료 플랜(발송권 충전) 회원은 API·MCP 호출에 추가 요금이 없고, 발송 1건은 보유 발송권에서 차감돼요. 웹앱에서 보내는 것과 똑같이 1건이 차감되는 방식이에요.

무료 회원

PDF 업로드 발송

  • 가진 PDF 양식을 업로드해 서명·날짜 칸을 배치하고 발송해요(개인 5건·기업 월 10건 무료).
  • 휴대폰 본인확인·타임스탬프·감사추적인증서가 기본 포함돼요.
  • AI 작성·API·MCP 연동은 포함되지 않아요(유료 플랜 전용).

유료 플랜 전용

유료 회원 API 추가요금 0원

+0원

유료 플랜(발송권 충전) 회원은 API·MCP 호출에 추가 요금이 없어요 — 발송 1건은 보유 발송권에서 차감돼요.

  • 호출당 API 요금 없음 — REST·MCP 호출 자체에는 별도 과금이 붙지 않아요.
  • 계약 1건을 발송할 때 보유 발송권 1건이 차감돼요(웹앱 발송과 동일).
  • AI 작성·API·MCP 연동은 유료 플랜 전용 기능이에요.
  • 충전 단가는 요금 기준(100건 29,900원~, VAT 별도). 받는 사람은 가입·결제 없이 영원히 무료예요.

베타·얼리액세스 단계라 발송권 충전 결제는 순차 오픈돼요. "API 100% 무료"가 아니라, 유료 회원의 API·MCP 호출에 별도 과금이 없다는 뜻이에요. 발송은 채널·건수만큼 발송권을 소진해요.

연동 흐름

생성 → 미리보기 → 승인 후 발송

계약을 만들고(create), 미리보기(dry_run)로 수신자·채널·예상 결제를 확인한 뒤, 발급된 confirmation_token을 다시 전달해야 실제 발송(send)이 실행돼요. 이 2단계는 서버단에서 강제돼요.

  • 1) 생성 — POST /v1/contracts로 표준양식 기반 초안을 만들어요.
  • 2) 미리보기 — POST /v1/contracts/{id}/send는 기본 dry_run=true로 미리보기와 confirmation_token을 돌려줘요.
  • 3) 발송 — 같은 호출에 confirmation_token을 실으면 실제로 발송되고, 발송권 1건이 차감돼요.
  • MCP에서는 같은 흐름을 send_for_signature tool로 다뤄요. 계약 취소(void)는 안전을 위해 REST·웹앱 전용이에요.

정확한 경로·필드명·tool 스키마는 정식 출시 전 변경될 수 있어요. 확정 스펙은 개발자 문서의 OpenAPI·MCP 문서로 공개해 드려요.

인증 · 키 발급

sk_ API 키로 인증, MCP는 한 줄 설정

인앱 콘솔에서 sk_ API 키를 발급하고 Authorization: Bearer 헤더로 전달해요. AI 도구는 MCP 서버 주소를 설정에 추가하면 바로 연결돼요.

REST — sk_ API 키(Bearer)

  • 인앱 개발자 연동(/app/mcp)에서 키를 발급해요. live/test 환경과 권한 범위(scope)를 나눠요.
  • 키 평문은 발급 시 한 번만 보여줘요. 서버 측 환경변수로 보관하고 클라이언트·공개 저장소에 노출하지 마세요.
  • MCP Authorization 규격 기반 OAuth 2.1 동적 인증은 순차 오픈 예정이에요. 예정

MCP — mcpServers 설정

{
  "mcpServers": {
    "signdeal": {
      "url": "https://mcp.signdeal.kr"
    }
  }
}

로컬 stdio만 지원하는 클라이언트는 mcp-remote 브리지로 원격 서버에 붙어요. 자세한 설정·tool 목록은 개발자 문서·연동에서 확인해요.

안전 · 법적효력

API로 보내도 같은 정책, 같은 증거

웹앱이든 API·MCP든 같은 백엔드 정책을 거쳐요. 본인확인·검토 게이트·증거 기록은 클라이언트가 끌 수 없어요.

2단계 발송 게이트

dry_run 미리보기 → confirmation_token 승인 없이 실제 발송이 안 돼요. 서버단에서 강제돼요.

본인확인·증거 기록

휴대폰 본인확인, 타임스탬프, 감사추적인증서(시각·IP)가 함께 적용돼요. 고액 계약은 본인확인 하한이 자동 상향돼요.

법적 효력·무결성

요건을 갖춘 전자계약은 종이와 같은 효력을 가져요(전자서명법 제3조·전자문서법 제4조의2). 증거는 추가만 가능한(append-only) 해시체인으로 보존돼요.

전자계약으로 대체할 수 없는 문서(유언·혼인신고·일부 등기 등)는 초안 단계에서 차단돼요. 자세한 내용은 안전·법적효력·보안에서 확인해요.

API·MCP 연동, 지금 시작해요

인앱에서 sk_ 키를 발급하고 개발자 문서대로 연결해요. 팀 도입·규모 산정이 필요하면 상담도 받아요.

바로 연동하기

인앱 개발자 연동에서 API 키를 발급하고, 문서의 빠른 시작을 따라 해요.

API 키 발급(인앱)

개발자·MCP 문서 보기

기업 도입 상담

발송 규모·팀 권한·연동 방식을 함께 검토해요. 문의 폼이 가장 빠르고 메일도 받아요.

도입 상담 신청하기

싸인딜은 베타·얼리액세스 단계예요. AI 작성·API·MCP 연동은 유료 플랜 전용이고, 무료 회원은 PDF 업로드 발송을 써요. API·MCP 호출에는 추가 요금이 없으며 발송 1건만 발송권에서 차감돼요. AI 생성물은 작성을 돕는 참고용이며, 호출 경로·필드명·tool 스키마는 정식 출시 전 변경될 수 있어요.

자주 묻는 질문

연동 전에 자주 묻는 것들

API·MCP를 쓰면 추가 요금이 붙나요?
유료 플랜(발송권 충전) 회원은 API·MCP 호출 자체에 추가 요금이 없어요. 계약 1건을 발송할 때 보유 발송권 1건이 차감되며, 이는 웹앱에서 발송할 때와 동일해요. AI 작성·API·MCP 연동은 유료 플랜 전용 기능이고, 무료 회원은 PDF 업로드 발송을 써요.
REST API와 MCP 중 무엇을 써야 하나요?
자체 서버·백오피스(ERP/CRM)에 통합하려면 REST API를, Claude·Codex 같은 AI 도구가 대화로 계약을 다루게 하려면 MCP 서버를 연결하세요. 두 경로 모두 같은 백엔드와 같은 안전 모델(dry_run→confirmation_token)을 공유해요.
AI나 자동화가 사람 승인 없이 발송하나요?
아니요. 발송은 기본이 dry_run=true 미리보기이고, 실제 발송에는 미리보기에서 발급된 confirmation_token이 필요해요. 이 2단계는 서버단에서 강제되어 클라이언트가 끌 수 없어요.
어떻게 인증하나요?
현재는 sk_ API 키(Bearer) 인증을 지원해요. 인앱 콘솔에서 키를 발급하고 Authorization 헤더로 전달하세요. MCP Authorization 규격 기반 OAuth 2.1 동적 인증은 순차 오픈 예정이며, 적용 시 문서와 공지로 안내해 드려요.
개발자·MCP 문서 기업·API 둘러보기 요금 보기