@signforge/mcp-server

SignForge 무료 전자 서명 플랫폼을 기반으로 Claude Desktop, Claude Code, Cursor 및 기타 AI 에이전트에서 직접 전자 서명을 위해 문서를 전송하세요.

기능

이 MCP 서버는 AI 에이전트를 SignForge의 전자 서명 API에 연결합니다. AI 어시스턴트는 다음을 수행할 수 있습니다:

서명용 문서 전송 — PDF 업로드, 서명자 지정 및 한 단계로 전송
엔벨로프 관리 — 전송, 무효화, 삭제 및 상태 확인
문서 다운로드 — 서명된 PDF, 감사 인증서 및 ZIP 아카이브
템플릿 사용 — 미리 채워진 필드가 있는 재사용 가능한 템플릿에서 엔벨로프 생성
웹훅 관리 — 실시간 엔벨로프 이벤트 구독
임베드 URL 생성 — 임베드 가능한 서명 환경 생성

빠른 시작

1. API 키 받기

signforge.io에 가입하고 개발자 설정에서 API 키를 생성하세요.

2. AI 클라이언트 구성

아래에서 클라이언트를 선택하고 구성을 추가하세요:

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

구성 파일 위치:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code

claude mcp add signforge -- npx -y @signforge/mcp-server

그런 다음 셸에서 환경 변수를 설정하세요:

export SIGNFORGE_API_KEY="your-api-key-here"

Cursor

Cursor MCP 설정(.cursor/mcp.json)에 추가하세요:

{
  "mcpServers": {
    "signforge": {
      "command": "npx",
      "args": ["-y", "@signforge/mcp-server"],
      "env": {
        "SIGNFORGE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Direct (npx)

SIGNFORGE_API_KEY="your-api-key-here" npx -y @signforge/mcp-server

3. 클라이언트 재시작

Claude Desktop, Claude Code 또는 Cursor를 재시작하여 새 MCP 서버를 적용하세요.

도구

엔벨로프 관리

도구	설명
`create_and_send`	PDF를 업로드하고 서명자를 추가한 후 전자 서명을 위해 전송합니다. 로컬 파일 경로 또는 base64 인코딩된 PDF를 허용합니다.
`check_status`	엔벨로프 상태를 확인합니다 — 서명 진행 상황, 타임스탬프 및 사용 가능한 문서를 확인하세요.
`list_envelopes`	상태 필터링(`draft`, `sent`, `completed`, `voided`, `expired`)을 사용하여 엔벨로프를 나열합니다.
`send_envelope`	서명을 위해 초안 엔벨로프를 전송합니다.
`void_envelope`	선택적 사유와 함께 활성 엔벨로프를 무효화(취소)합니다.
`delete_envelope`	초안 또는 무효화된 엔벨로프를 영구적으로 삭제합니다.

문서 다운로드

도구	설명
`download_signed`	완료된 엔벨로프의 서명된 PDF를 로컬 파일로 다운로드합니다.
`download_certificate`	전체 감사 추적이 포함된 감사 인증서 PDF를 다운로드합니다.
`download_archive`	서명된 PDF, 인증서 및 모든 문서가 포함된 ZIP 아카이브를 다운로드합니다.

임베디드 서명

도구	설명
`get_embed_url`	앱 내 서명 환경을 위한 임베드 가능한 서명 URL을 생성합니다.

템플릿

도구	설명
`list_templates`	재사용 가능한 문서 템플릿을 나열합니다.
`create_from_template`	선택적으로 미리 채워진 필드 값을 사용하여 템플릿에서 엔벨로프를 생성합니다. 즉시 전송하거나 초안으로 저장하세요.

웹훅

도구	설명
`create_webhook`	엔벨로프 이벤트(전송됨, 조회됨, 서명됨, 완료됨, 만료됨, 무효화됨, 거부됨)를 구독합니다.
`list_webhooks`	구성된 모든 웹훅을 나열합니다.
`delete_webhook`	ID로 웹훅을 삭제합니다.

대화 예시

서명을 위해 문서 전송

You: Send my NDA at ~/Documents/nda.pdf to jane@example.com (Jane Smith) for signature.

AI: I'll send that NDA for signature now.

[Uses create_and_send tool]

Done! I've created and sent the envelope:
- Envelope ID: a1b2c3d4-...
- Status: sent
- Jane Smith (jane@example.com) will receive a signing link via email.

상태 확인 및 다운로드

You: Has Jane signed the NDA yet?

AI: Let me check.

[Uses check_status tool]

Yes! Jane signed it on April 7 at 2:15 PM. The envelope is now completed.

You: Great, download the signed copy and the audit certificate.

[Uses download_signed tool]
[Uses download_certificate tool]

Done! Files saved:
- Signed PDF: ~/Documents/nda-signed.pdf
- Audit Certificate: ~/Documents/nda-certificate.pdf

미리 채워진 필드가 있는 템플릿 사용

You: Send our standard consulting agreement to bob@acme.com.
     Pre-fill the company name as "Acme Corp" and the start date as "May 1, 2026".

AI: I'll create that from your consulting agreement template.

[Uses list_templates tool — finds "Consulting Agreement" template]
[Uses create_from_template tool — with prefill_fields and send_immediately: true]

Done! Envelope created and sent:
- Title: Consulting Agreement
- Recipient: bob@acme.com
- Pre-filled: company = "Acme Corp", start_date = "May 1, 2026"
- Status: sent

엔벨로프 수명 주기 관리

You: List my sent envelopes.

[Uses list_envelopes tool with status: "sent"]

You: Void the contract for Project Alpha — the deal fell through.

[Uses void_envelope tool with reason]

You: Now delete it.

[Uses delete_envelope tool]

Done — envelope voided and deleted.

웹훅 설정

You: Set up a webhook to notify my server when documents are signed or completed.

[Uses create_webhook tool]

Webhook created:
- URL: https://api.yourapp.com/webhooks/signforge
- Events: envelope.signed, envelope.completed
- Secret: whsec_abc123... (save this for signature verification!)

환경 변수

변수	필수	기본값	설명
`SIGNFORGE_API_KEY`	예	—	SignForge API 키입니다. signforge.io/dashboard/developers에서 받으세요.
`SIGNFORGE_API_URL`	아니요	`https://signforge.io/api/v1`	API 기본 URL입니다. 자체 호스팅 인스턴스나 스테이징 환경에서만 변경하세요.

샌드박스 모드

샌드박스 모드에서 생성된 API 키는 실제 이메일을 보내지 않는 테스트 엔벨로프를 생성합니다. 개발 및 테스트 중에는 샌드박스 모드를 사용하세요.

문제 해결

"SIGNFORGE_API_KEY environment variable is required" MCP 클라이언트 구성에 SIGNFORGE_API_KEY를 설정했는지 확인하세요. 위의 설정 지침을 참조하세요.

"SignForge API error (401)" API 키가 유효하지 않거나 만료되었습니다. signforge.io/dashboard/developers에서 새 키를 생성하세요.

"SignForge API error (403)" API 키에 이 작업에 대한 권한이 없습니다. 키의 범위를 확인하세요.

"SignForge API error (429)" 속도 제한에 도달했습니다. 잠시 기다린 후 다시 시도하세요.

Claude Desktop에 서버가 표시되지 않음

구성 JSON이 유효한지 확인하세요(후행 쉼표 없음)
Claude Desktop을 완전히 재시작하세요(종료 후 다시 열기)
Claude Desktop의 개발자 콘솔에서 MCP 서버 로그를 확인하세요

링크

SignForge — 무료 전자 서명 플랫폼
API 문서 — 전체 API 참조
GitHub — 소스 코드
MCP 프로토콜 — 모델 컨텍스트 프로토콜 사양

라이선스

MIT

SignForge