개발자 문서 · MCP

싸인딜을 AI에
연결하세요 (MCP)

Claude·Codex 같은 MCP 호환 AI에 연결하면, 대화하다가 차용증을 만들고 카카오 알림톡으로 보낼 수 있어요. 실발송은 미리보기와 명시적 승인을 거칩니다.

MCP Streamable HTTP OAuth 2.1

빠른 시작

3단계면 연결돼요

AI 클라이언트가 싸인딜 공식 메타데이터를 읽고 OAuth 로그인·동의를 거쳐 MCP 서버에 연결합니다.

1 AI 문서 발견

AI는 https://signdeal.kr/.well-known/ai-plugin.json와 /ai 문서를 읽고 연결 방식을 확인합니다.

2 OAuth 로그인·동의

사용자는 https://auth.signdeal.kr/oauth/authorize에서 로그인하고 권한 범위를 승인합니다.

3 대화로 호출

AI는 https://mcp.signdeal.kr/mcp에 Bearer access token으로 연결하고 tool을 자동 등록합니다.

AI discovery 기준 URL

AI에게는 보통 https://signdeal.kr를 전달하면 됩니다. AI가 아래 공개 문서를 읽고 OAuth와 MCP 연결 지점을 찾습니다.

{
  "site": "https://signdeal.kr",
  "ai_plugin": "https://signdeal.kr/.well-known/ai-plugin.json",
  "oauth_issuer": "https://auth.signdeal.kr",
  "mcp_server": "https://mcp.signdeal.kr/mcp",
  "tool_registry": "https://signdeal.kr/ai/tools"
}

수동 설정이 필요한 클라이언트는 원격 MCP 서버를 직접 등록할 수 있습니다. OAuth access token은 사용자 동의 후 발급됩니다.

{
  "mcpServers": {
    "signdeal": {
      "type": "http",
      "url": "https://mcp.signdeal.kr/mcp",
      "authorization_server": "https://auth.signdeal.kr"
    }
  }
}

지원 클라이언트: Claude(Desktop/Code) · Codex 등 MCP 호환 도구
전송: Streamable HTTP(원격)
미리보기(dry-run) → 승인 → 발송의 2단계 안전 흐름이 서버단에서 강제 적용
감사추적·본인확인은 발송 tool에서 항상 적용

Tool 레퍼런스

10개 tool 요약

싸인딜 MCP 서버가 노출하는 tool이에요. AI는 대화 맥락에 맞는 tool을 자동으로 선택해요. 실제 발송·체결은 항상 명시적 승인 토큰을 요구해요.

싸인딜 MCP tool 목록과 역할. 모든 발송 계열 tool은 dry-run 결과와 confirmation token을 거쳐야 실행돼요.
Tool	역할	주요 입력
`list_templates`	사용 가능한 계약 양식 목록 조회(차용증 등). 양식 ID·필수 필드를 반환해요.	type?
`generate_contract_from_text`	자연어에서 계약 슬롯·서명 앵커·검토 페이로드·리스크 경고를 생성해요.	text, contract_type?
`create_draft`	검토된 본문과 슬롯으로 계약 초안을 만들고 발송 준비 상태로 저장해요.	contract_type, title, body_markdown, slots?
`add_signer`	서명자를 추가하고 계약 유형·금액에 맞는 본인확인 하한을 적용해요.	contract_id, name, phone_e164, role_label
`set_signature_fields_auto`	생성 시 저장된 앵커를 기준으로 서명 필드를 확정해요.	contract_id
`send_for_signature`	dry-run 미리보기와 confirmation token을 만들고, 승인 토큰이 있을 때만 실제 발송해요.	contract_id, channel?, dry_run, confirmation_token?
`check_status`	계약 상태와 서명자 진행 현황을 조회해요.	contract_id
`get_signed_document`	체결 완료 후 보존본 PDF와 문서 해시를 받아요.	contract_id

tool 이름·스키마는 안정화 과정에서 변경될 수 있어요. 정식 출시 시점의 OpenAPI/JSON 스키마를 이 문서에서 함께 공개해 드려요.

발송 안전 흐름

실수로 계약이 나가지 않도록, 발송은 항상 두 단계를 거쳐요.

1) dry-run. send_for_signature가 발송 없이 미리보기와 결제가를 반환해요.
2) 승인. 미리보기에서 발급된 confirmation_token을 다시 전달해야 실제 발송돼요.
본인확인·타임스탬프·감사추적인증서는 서버단에서 강제돼요. 클라이언트가 끌 수 없어요.
전자계약 불가 문서(유언·혼인신고·일부 등기)는 draft 단계에서 차단돼요.

인증 · OAuth

AI 연결은 OAuth 2.1 Authorization Code + PKCE를 기본으로 합니다.

OAuth 2.1 — 사용자가 로그인하고 권한 범위를 승인하면 access token이 발급됩니다.
PKCE S256 — 공개 AI 클라이언트도 client secret 없이 안전하게 연결할 수 있습니다.
MCP Bearer token — MCP 요청은 Authorization: Bearer oat_... 형식으로 검증됩니다.

수동 API 키는 기업 서버 연동 보조 경로입니다. AI 연결의 기본 경로는 OAuth입니다.

OAuth로 연결 시작 홈에서 MCP 소개 보기 개발자 문의

싸인딜을 AI에연결하세요 (MCP)