# MCP 서버, 웹훅 이벤트와 재전송

2026년 10월 27일

이제 AI 에이전트가 MCP나 REST API로 폼을 설정하고 관리할 수 있고, 웹훅은 엔드포인트가 버거워해도 이벤트를 잃지 않고 제출의 도착부터 삭제까지 따라갑니다.

## 새 기능

### Ikiform MCP 서버

Claude Code, Cursor, VS Code 등 MCP 클라이언트를 비밀 키로 https://ikiform.com/mcp 에 연결하면, 에이전트가 워크스페이스에서 폼을 만들고 연결하고, 제출을 분류하고, 웹훅을 설정하고 디버깅할 수 있습니다.

- REST API와 같은 키, 스코프, 요청 제한을 사용합니다.
- Claude Code 플러그인은 서버와 함께, 삭제나 재전송 전에 에이전트가 먼저 확인하도록 하는 스킬을 추가합니다.
- API 키, 멤버, 알림 수신자, 결제는 대시보드에만 남습니다.

[MCP 서버](https://ikiform.com/ko/docs/mcp)

### API로 폼과 웹훅 관리

이제 REST API로 폼을 수정, 일시 중지, 삭제하고, 필드 스키마를 게시하고, 웹훅 엔드포인트를 만들고 수정하고 끄고 삭제할 수 있습니다.

- 폼 수정으로 이름, 허용 도메인, 리디렉션 URL, 스팸 검사, 요청 제한, 이메일 알림을 바꿀 수 있습니다.
- 새 엔드포인트는 서명 시크릿을 한 번만 반환하고, 시크릿을 교체해도 이전 시크릿은 24시간 동안 작동합니다.

[REST API](https://ikiform.com/ko/docs/api#endpoints)

### 엔드포인트가 받을 이벤트 선택

이제 엔드포인트는 submission.created 외에도, 제출이 스팸으로 옮겨지거나 복원될 때의 submission.updated, 삭제될 때의 submission.deleted, 새 스팸에 대한 submission.spam을 받을 수 있습니다. 새 엔드포인트는 여전히 submission.created만 받습니다.

- 모든 제출 이벤트에 data.sequence가 있어 전송을 올바른 순서로 되돌릴 수 있습니다.
- webhook-id는 재시도와 재전송에서도 같아서 멱등 키로 쓸 수 있습니다.
- 제출을 스팸 아님으로 표시하면 아직 받지 못한 엔드포인트에도 submission.created를 보냅니다.

[웹훅 이벤트](https://ikiform.com/ko/docs/webhooks#events)

### 실패한 전송 재전송

최근 24시간, 3일, 7일 동안 실패한 전송을 엔드포인트 메뉴에서 다시 보낼 수 있으며, 한 번에 최대 1,000개입니다.

- 비활성화된 엔드포인트를 다시 켜면 실패한 전송을 재전송하겠냐고 묻습니다.
- 재전송은 원래의 webhook-id와 sequence를 유지합니다.
- 엔드포인트가 일시 중지된 동안 재전송은 실패를 늘리지 않고 기다립니다.

[실패한 전송 재전송](https://ikiform.com/ko/docs/webhooks#replay)

### 사용자 지정 헤더

엔드포인트에 고정 헤더를 최대 10개까지 추가할 수 있습니다. 예를 들면 Zapier나 n8n용 Authorization 헤더입니다. 값은 암호화되어 저장되며 다시 표시되지 않습니다.

- Ikiform 자체 헤더는 덮어쓸 수 없습니다.
- 엔드포인트 URL을 바꾸면 헤더 값을 다시 입력해야 하므로, 저장된 토큰이 새 URL로 전송되지 않습니다.
- 사용자 지정 헤더는 서명 대상이 아니므로, 가능하다면 계속 webhook-signature를 검증하세요.

[사용자 지정 헤더](https://ikiform.com/ko/docs/webhooks#custom-headers)

### AI 빌더와 클라이언트 사이트를 위한 가이드

Lovable, Bolt, v0, Replit, Base44, Cursor, Claude Code, Windsurf용 새 페이지, AI 앱 빌더가 만든 모든 폼을 프롬프트 하나로 연결하는 가이드, 클라이언트용 사이트 제작 가이드를 추가했습니다.

[AI 앱 빌더](https://ikiform.com/docs/guides/ai-builders) · [클라이언트용 제작](https://ikiform.com/ko/docs/guides/clients)

## 개선

### 버거운 엔드포인트를 더 배려하도록

Ikiform은 한 엔드포인트로 동시에 최대 5개의 요청만 보냅니다. 20번 연속 실패하면 전송을 5분 동안 멈추고, 매번 두 배로 늘려 최대 1시간까지 멈추며, 기다리는 동안에는 재시도 횟수가 줄지 않습니다.

- 1시간 이상 실패하던 엔드포인트가 복구되면 이메일을 보내 드립니다.
- 전송이 일시 중지되었거나 4xx로 거부되거나 실패하고 있으면 엔드포인트 페이지에 한 줄로 표시됩니다.
- 성공한 전송 없이 5일이 지난 엔드포인트는 이전처럼 비활성화되며 이메일이 갑니다.

[엔드포인트 보호](https://ikiform.com/ko/docs/webhooks#endpoint-protection)

### 로그인하면 첫 폼이 준비됩니다

처음 로그인하면 워크스페이스와 첫 폼이 만들어지고 바로 열리며, 초대받은 사람은 초대로 곧장 이동합니다. 폼 페이지에는 복사하거나 Claude, ChatGPT, Cursor에서 열 수 있는 설정 프롬프트가 생겼습니다.

### 설정에서 플랜 해지

플랜 및 사용량에 이제 '플랜 해지'가 있어 결제 포털을 거치지 않아도 됩니다. 플랜은 결제한 기간이 끝날 때까지 계속 작동하며, 그 전까지는 '플랜 재개'로 되돌릴 수 있습니다.

- 구독이 싫다면 같은 단계에서 일회성 제출 팩으로 바꿀 수 있습니다. 크레딧은 만료되지 않습니다.

[환불 정책](https://ikiform.com/refunds#cancelling)
