개발자 문서 · MCP

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

싸인딜은 MCP(Model Context Protocol) 서버예요. Claude·Codex 같은 MCP 호환 AI에 연결하면, 대화하다가 그 자리에서 차용증을 만들고 카카오 알림톡으로 발송할 수 있어요. 실발송은 항상 미리보기(dry-run) → 명시적 승인 → 발송 흐름을 거쳐요.

MCP Streamable HTTP OAuth 추진 중

빠른 시작

3단계면 연결돼요

API 키를 발급받아 클라이언트 설정에 넣고, AI에게 말하면 끝이에요.

1 API 키 발급

대시보드에서 키를 발급받아요. 첫 건 무료가 포함돼요. 키는 서버 측에 안전하게 보관하고 클라이언트 노출을 피하세요.

2 MCP 서버 등록

AI 클라이언트의 mcpServers 설정에 싸인딜을 추가해요(아래 예시 참고).

3 대화로 호출

AI에게 말하면 tool이 자동 선택돼요. 미리보기를 보여주고, 승인하면 카톡으로 발송돼요.

Claude Desktop / Codex — mcpServers 설정

설정 파일(예: claude_desktop_config.json)에 아래를 추가하세요. 원격 MCP 서버를 Streamable HTTP로 연결해요.

{
  "mcpServers": {
    "signdeal": {
      "type": "http",
      "url": "https://mcp.signdeal.kr",
      "headers": {
        "Authorization": "Bearer <발급받은 API 키>"
      }
    }
  }
}

로컬 브리지(stdio)가 필요한 클라이언트라면 mcp-remote로 원격 서버를 연결할 수 있어요.

{
  "mcpServers": {
    "signdeal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.signdeal.kr"],
      "env": {
        "SIGNDEAL_API_KEY": "<발급받은 API 키>"
      }
    }
  }
}

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

Tool 레퍼런스

8개 tool 요약

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

싸인딜 MCP tool 목록과 역할. 모든 발송 계열 tool은 dry-run 결과와 confirmation token을 거쳐야 실행돼요.
Tool	역할	주요 입력
`list_templates`	사용 가능한 계약 양식 목록 조회(차용증 등). 양식 ID·필수 필드를 반환해요.	type?
`create_contract_draft`	자연어/필드로 차용증 초안 생성. 채권자·채무자·금액·이자·기한을 채워요.	template_id, fields
`autoplace_signature_fields`	문서를 읽고 서명·날짜·금액 칸을 AI가 자동 배치(채권자 ①·채무자 ②).	draft_id
`preview_contract`	발송 전 미리보기(dry-run). 내용·받는 사람·서명필드·예상 요금을 1장으로 반환해요.	draft_id
`send_contract`	카카오 알림톡으로 서명 요청 발송(카톡 없으면 SMS 전환). confirmation token 필수.	draft_id, recipients, confirm
`get_contract_status`	수신·열람·서명·체결 단계를 실시간 조회해요.	contract_id
`download_completed_pdf`	체결 완료 문서의 보존본 PDF와 감사추적인증서를 받아요.	contract_id
`verify_document`	검증 ID/해시로 위변조 여부·서명자·서명 시각을 확인해요(가입 불필요).	verify_id \| hash

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

발송 안전 흐름

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

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

인증 · OAuth

현재는 API 키(Bearer) 인증을 지원해요.

API 키(Bearer) — 대시보드에서 발급. 모든 요청에 Authorization: Bearer … 헤더로 전달해요.
키는 서버 측 환경변수로 관리하고, 공개 저장소·클라이언트에 노출하지 마세요.
OAuth 2.1 기반 동적 인증은 추진 중이에요(MCP Authorization 규격). 적용되면 키 수동 발급 없이 클라이언트에서 안전하게 연결돼요.

OAuth는 아직 제공 전이에요. "추진 중"으로만 안내하며, 적용 시 이 문서와 공지에서 알려드려요.

API 키 발급받기 홈에서 MCP 소개 보기 개발자 문의