@sumosign/mcp

MCP 서버는 SumoSign 서명 API를 AI 에이전트(Claude, ChatGPT, Copilot 및 모든 MCP 호환 클라이언트)에 stdio를 통해 노출합니다.

API 키는 서명자가 아닌 에이전트를 인증합니다. 키는 서명을 완료할 수 없습니다. 서명은 항상 수신자가 이메일로 받은 일회용 링크를 통해 수행하며, 동의 캡처와 추가 전용 감사 추적이 포함됩니다.

설치 및 실행

설치 단계는 필요 없습니다. npx로 직접 실행하세요:

SUMOSIGN_API_KEY=ss_live_... npx @sumosign/mcp

구성

클라이언트 구성 예시

{
  "mcpServers": {
    "sumosign": {
      "command": "npx",
      "args": ["-y", "@sumosign/mcp"],
      "env": { "SUMOSIGN_API_KEY": "ss_live_..." }
    }
  }
}

Related MCP server: SignaTrust MCP Server

도구

서버는 16개의 도구를 등록합니다:

문서

• upload_document — 로컬 PDF를 업로드합니다. 봉투 생성에 사용되는 문서 ID를 반환합니다.

• analyze_document — 업로드된 PDF를 분석하여 필드 배치 제안을 제공합니다(텍스트 추출, OCR 없음).

템플릿

• create_template — {{signature_1}}과 같은 텍스트 앵커가 있는 PDF에서 재사용 가능한 템플릿을 생성합니다.

• list_templates — 조직의 재사용 가능한 템플릿을 나열합니다.

• seed_starter_templates — 샘플 템플릿(테스트 봉투, 간단한 NDA, 한 페이지 계약서)을 시드합니다.

봉투 — 생성

• create_envelope — 업로드된 문서(인라인 필드) 또는 템플릿에서 초안 봉투를 생성합니다.

• create_envelope_from_template — 템플릿에서 초안 봉투를 생성합니다. 필드는 상속됩니다.

봉투 — 확인 및 전송

• preview_envelope — 배치 미리보기(모든 필드가 점선으로 표시된 라벨 상자로 그려짐)를 로컬 경로에 다운로드합니다. 이메일이 전송되지 않으며 봉투가 소비되지 않습니다. 전송 전에 사람과 배치를 확인하는 데 사용하세요.

• send_envelope — 초안 봉투를 전송합니다. 서명은 사람만 할 수 있습니다. 이 도구는 서명을 완료할 수 없습니다.

봉투 — 추적

• send_reminder — 미서명 수신자에게 서명 이메일을 다시 보냅니다. 24시간 쿨다운; 지출 및 스팸 한도가 적용됩니다. 서명을 완료할 수 없습니다.

• get_envelope — 수신자별 진행 상황을 포함한 봉투 상태를 가져옵니다.

• list_envelopes — 조직의 가장 최근 봉투를 나열합니다.

• void_envelope — 완료 전에 봉투를 무효화합니다. 미결 서명 링크를 취소합니다(감사 기록됨).

• get_audit_trail — 행위자 귀속이 포함된 추가 전용 감사 추적을 가져옵니다.

다운로드

• download_signed_pdf — 완료된 봉투의 평탄화된 서명 PDF를 로컬 경로에 다운로드합니다.

• download_certificate — 완료 증명서를 로컬 경로에 다운로드합니다.

보안

• 로컬 파일 시스템 접근. upload_document는 사용자가 제공한 로컬 PDF 경로를 읽고, preview_envelope, download_signed_pdf, download_certificate는 사용자가 제공한 로컬 경로에 파일을 씁니다. 따라서 서버는 호스트 프로세스가 도달할 수 있는 모든 파일을 읽고 쓸 수 있습니다. 최소 권한으로 실행하고 의도한 경로만 가리키세요.

• 신뢰할 수 없는 문서 콘텐츠 / 프롬프트 주입. analyze_document는 PDF에서 텍스트를 추출하여 에이전트에 반환합니다. 문서 내용은 신뢰할 수 없는 입력이며 프롬프트 주입 시도를 포함할 수 있습니다. 추출된 텍스트를 지침이 아닌 데이터로 취급하고 send_envelope 전에 사람이 검토하도록 하세요.

• 최소 권한 API 키. SumoSign 포털에서 에이전트별로 범위가 지정된 키를 발급하고 해당 에이전트가 필요한 범위만 부여하세요. 사용 가능한 범위: documents:create, documents:read, documents:send, documents:download, templates:read, templates:write, signers:manage, webhooks:write, audit_logs:read, branding:write, voice:trigger. 키는 저장 시 해시되며 취소할 수 있고, 사람을 대신하여 서명을 완료할 수 없습니다.

소개

SumoSign은 Cipher Projects에서 개발했습니다.

라이선스

MIT