MCP REST API 연동 선택 가이드

계약서, AI로 보낼까
API로 자동화할까?

사람이 Claude·Codex 같은 AI 도구로 대화하며 계약을 보내려면 MCP로 연결합니다. 서버·백오피스에서 주기적·대량 발송을 자동화하려면 REST API로 연동합니다. 둘은 경쟁 관계가 아니라 쓰는 사람과 상황이 달라요. 아래 비교표와 결정 가이드로 우리에게 맞는 방식을 고르세요 — 두 방식 모두 같은 싸인딜 백엔드와 같은 안전 모델을 공유해요.

MCP · 대화형 AI REST API · 시스템 자동화 OAuth 2.1 발송 전 미리보기 승인 베타·얼리액세스
연동 가이드 보기 API·연동 자세히

싸인딜은 베타·얼리액세스 단계예요. AI 작성·API·MCP 연동은 유료 플랜 전용이고, 무료 회원은 PDF 업로드 발송을 써요. 호출 경로·필드명·tool 스키마는 정식 출시 전 바뀔 수 있어요.

한눈에 비교

MCP vs REST API

대화형 AI 도구에는 MCP를, 시스템 자동화에는 REST API를 씁니다. 같은 백엔드를 공유하므로 두 방식을 함께 써도 돼요.

싸인딜 연동 방식 비교 — 쓰는 사람과 목적에 따라 골라요. 두 방식 모두 같은 안전 모델(미리보기 승인)을 거쳐요.
구분 AI 도구 (MCP) 시스템 자동화 (REST API)
누가 쓰나 Claude·Cursor·Codex 등 대화형 AI를 쓰는 사람 ERP·CRM·백오피스·노코드(Zapier 등) 시스템
연결 방식 설정 → 커넥터(MCP)에 서버 주소 https://mcp.signdeal.kr/mcp 추가, 또는 "이 MCP 서버를 OAuth로 연결해줘"라고 요청 api.signdeal.kr 엔드포인트로 REST 호출
인증 OAuth 2.1 API 키(sk_) 또는 OAuth
대표 사용예 사람이 대화로 계약 초안 작성·발송 준비 시스템에서 계약 자동 생성·발송
실시간 대화 O X
대량·주기 자동화 △ (가능하나 대화 기반) O
시작점 /docs /api.html · /openapi.json

표 내용은 표준·일반 안내를 위한 참고용이며 법률 자문이 아니에요. 베타 단계라 호출 경로·필드명은 정식 출시 전 바뀔 수 있어요. 확정 스펙은 개발자 문서의 OpenAPI·MCP 문서로 공개돼요.

결정 가이드

이럴 땐 이걸 고르세요

상황에 맞춰 짧게 정리했어요. 헷갈리면 대화형이면 MCP, 시스템 자동화면 API라고 기억하세요.

MCP를 고르세요

  • Claude·Codex로 대화하면서 계약 초안을 만들고 발송을 준비하고 싶다면 → MCP를 연결하세요.
  • 건마다 사람이 검토·확인하되 작성 시간을 줄이고 싶다면 → MCP로 초안까지 만들고 사람이 승인하세요.
  • 개발 없이 AI 도구 설정 한 줄로 시작하고 싶다면 → 커넥터에 MCP 주소를 추가하세요.

REST API를 고르세요

  • ERP·CRM에서 조건이 맞으면 자동으로 계약을 생성·발송하고 싶다면 → REST API로 연동하세요.
  • 대량·주기 발송이나 야간 배치가 필요하다면 → 사람 개입 없이 도는 REST API가 맞아요.
  • Zapier·Make 같은 노코드로 잇고 싶다면 → REST API를 호출하세요(전용 노코드 커넥터는 순차 오픈 예정 예정).

둘 다 필요하다면? 같은 백엔드라 MCP와 REST API를 함께 써도 돼요. 대화형 작업은 MCP로, 시스템 자동화는 API로 나눠 쓰고 계약은 한 곳에서 관리돼요.

공통 안전장치 — 두 방식 모두 실제 발송은 미리보기 승인(confirmation)을 거쳐요. AI나 시스템이 사람 확인 없이 바로 보내지 않아요.

더 알아보기

고른 방식에 따라 아래에서 시작하세요. 정확한 스펙과 요금은 각 문서에서 확인해요.

연동 가이드 (/docs)

MCP·REST 연결부터 인증·발송 흐름까지 단계별로 안내해요. MCP를 고른 분의 시작점이에요.

연동 가이드 열기 →

API·연동

REST API·MCP 연동 개요와 요금(호출 추가요금 0원), sk_ 키 발급 안내를 담았어요.

/api.html 보기 →

개발자·MCP

MCP tool 목록, REST 빠른 시작, 안전 모델(dry_run→confirmation_token), 코드 샘플이 있어요.

/developers.html 보기 →

대화형 계약

말로 계약을 만들고 보내는 흐름을 보여줘요. MCP가 어떤 경험을 주는지 감을 잡기 좋아요.

/ai-conversation.html 보기 →

요금

발송권 충전 단가와 무료·유료 차이를 확인해요. API·MCP 호출에는 추가 요금이 없어요.

/pricing.html 보기 →

OpenAPI 스펙

REST 엔드포인트의 기계가 읽는 명세예요. 코드 생성·검증에 바로 쓸 수 있어요.

/openapi.json 열기 →

자주 묻는 질문

연동을 고르기 전에 자주 묻는 것들

AI로 계약 보내려면 MCP·API 중 뭘 써야 하나요?
사람이 Claude·Codex 같은 AI 도구로 대화하며 계약을 보내려면 MCP로 연결하세요. 서버·백오피스(ERP·CRM)에서 주기적·대량 발송을 자동화하려면 REST API로 연동하세요. 두 방식 모두 같은 백엔드와 같은 안전 모델(미리보기 승인)을 공유해요.
MCP와 API 둘 다 쓸 수 있나요?
네, 함께 쓸 수 있어요. 두 경로 모두 같은 백엔드를 거치므로 대화형 작업은 MCP로, 시스템 자동화는 REST API로 나눠 쓰고 계약은 한 곳에서 관리돼요.
개발 없이도 자동화되나요?(노코드)
Zapier·Make 같은 노코드 도구로 REST API를 호출해 일부 자동화를 구성할 수 있어요. 다만 API 키 발급 등 초기 연결 설정은 필요하고, 전용 노코드 커넥터는 순차 오픈 예정이에요.
MCP와 API는 비용 차이가 있나요?
API·MCP 호출 자체에는 추가 요금이 없어요. 연결 방식과 무관하게 계약을 실제로 발송할 때 보유 발송권 1건이 차감돼요. AI 작성·API·MCP 연동은 유료 플랜 전용 기능이고, 무료 회원은 PDF 업로드 발송을 써요.
연동 가이드 보기 개발자·MCP 문서 요금 보기

이 페이지는 일반 안내를 위한 표준 참고용이며 법률 자문이 아니에요. 싸인딜은 베타·얼리액세스 단계라 일부 기능은 순차 오픈되고, 호출 경로·필드명·tool 스키마는 정식 출시 전 바뀔 수 있어요.