API · MCP 개발자 연동

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

REST API와 MCP로 ERP·CRM 등 자사 시스템에서 계약을 자동으로 만들고 보내세요. Claude·Codex 같은 AI 도구가 직접 호출하게 만들 수도 있어요. 이메일+휴대폰 인증만 마치면 sk_ API 키 발급·MCP 연결이 무료로 열려요. 요금은 정직하게 — 월정액·API 이용료 0원이고, 발송 1건만 발송권에서 차감돼요.

MCP 10 tool REST API sk_ API 키 발송권만 차감 OAuth 예정
API 키 발급(인앱) 개발자·MCP 문서 보기

AI 작성·API·MCP 연동은 이메일+휴대폰 인증만 하면 무료로 열려요(/app/verify). 인증 전에도 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·MCP·AI 무료, 이용료 0원

API·MCP를 쓴다고 따로 요금이 붙지 않아요. 정확히 말하면 — 이메일+휴대폰 인증을 마치면 API·MCP·AI 작성이 무료로 열리고, 발송 1건만 보유 발송권에서 차감돼요. 웹앱에서 보내는 것과 똑같이 1건이 차감되는 방식이에요.

API 이용을 위한 월 구독료·가입비·연 약정이 없어요. 여러 전자서명 서비스가 API를 월 구독형 상위 플랜(공개 요금 기준 월 수만~십수만 원대)에 넣어 제공하는 것과 달리, 싸인딜은 API 때문에 매달 내는 돈이 0원이에요. 과금은 단 하나 — 계약서 발송 1건당 발송권 차감(건당 약 200원부터, 100건 29,900원·200건 49,900원·300건 59,900원, VAT 별도). REST API 키(sk_)·MCP 연결 모두 동일하고, OAuth 2.1 공개 연결(준비 중)도 열리면 별도 연결 이용료 없이 제공할 예정이에요. (타사 비교는 2026년 7월 기준 각사 공개 요금이며, 플랜·옵션에 따라 다를 수 있어요)

인증 전에도 가능

PDF 업로드 발송

  • 가진 PDF 양식을 업로드해 서명·날짜 칸을 배치하고 발송해요(개인·기업 모두 가입 시 100건 무료).
  • 휴대폰 본인확인·타임스탬프·감사추적인증서가 기본 포함돼요.
  • AI 작성·API·MCP는 이메일+휴대폰 인증 후 무료로 열려요.

이메일+휴대폰 인증

API·MCP·AI 무료로 열림

+0원

이메일+휴대폰 인증만 하면 API·MCP·AI 작성이 무료로 열려요 — 발송 1건만 보유 발송권에서 차감돼요.

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

"모든 게 100% 공짜"가 아니라, API·MCP·AI 호출 자체에는 별도 과금이 없다는 뜻이에요. 발송은 건수만큼 발송권을 소진해요(가입 시 100건 무료). 발송권 충전(카드 결제)은 정식 오픈 준비 중이며, 기업·대량 도입은 상담도 받아요.

연동 흐름

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

계약을 만들고(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는 한 줄 설정

이메일+휴대폰 인증(/app/verify)을 마치면 인앱 콘솔에서 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건만 발송권에서 차감돼요. 호출 경로·필드명·tool 스키마는 안정화 과정에서 변경될 수 있어요.

자주 묻는 질문

연동 전에 자주 묻는 것들

API·MCP를 쓰면 추가 요금이 붙나요?
API·MCP 호출 자체에는 추가 요금이 없어요. 이메일+휴대폰 인증을 마치면 API·MCP·AI 작성이 무료로 열리고, 계약 1건을 발송할 때만 보유 발송권 1건이 차감돼요(웹앱 발송과 동일). 인증 전에도 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 둘러보기 요금 보기