MCP 서버, 웹훅 이벤트와 재전송
이제 AI 에이전트가 MCP나 REST API로 폼을 설정하고 관리할 수 있고, 웹훅은 엔드포인트가 버거워해도 이벤트를 잃지 않고 제출의 도착부터 삭제까지 따라갑니다.
새 기능
Ikiform MCP 서버
Claude Code, Cursor, VS Code 등 MCP 클라이언트를 비밀 키로 https://ikiform.com/mcp 에 연결하면, 에이전트가 워크스페이스에서 폼을 만들고 연결하고, 제출을 분류하고, 웹훅을 설정하고 디버깅할 수 있습니다.
- REST API와 같은 키, 스코프, 요청 제한을 사용합니다.
- Claude Code 플러그인은 서버와 함께, 삭제나 재전송 전에 에이전트가 먼저 확인하도록 하는 스킬을 추가합니다.
- API 키, 멤버, 알림 수신자, 결제는 대시보드에만 남습니다.
API로 폼과 웹훅 관리
이제 REST API로 폼을 수정, 일시 중지, 삭제하고, 필드 스키마를 게시하고, 웹훅 엔드포인트를 만들고 수정하고 끄고 삭제할 수 있습니다.
- 폼 수정으로 이름, 허용 도메인, 리디렉션 URL, 스팸 검사, 요청 제한, 이메일 알림을 바꿀 수 있습니다.
- 새 엔드포인트는 서명 시크릿을 한 번만 반환하고, 시크릿을 교체해도 이전 시크릿은 24시간 동안 작동합니다.
엔드포인트가 받을 이벤트 선택
이제 엔드포인트는 submission.created 외에도, 제출이 스팸으로 옮겨지거나 복원될 때의 submission.updated, 삭제될 때의 submission.deleted, 새 스팸에 대한 submission.spam을 받을 수 있습니다. 새 엔드포인트는 여전히 submission.created만 받습니다.
- 모든 제출 이벤트에 data.sequence가 있어 전송을 올바른 순서로 되돌릴 수 있습니다.
- webhook-id는 재시도와 재전송에서도 같아서 멱등 키로 쓸 수 있습니다.
- 제출을 스팸 아님으로 표시하면 아직 받지 못한 엔드포인트에도 submission.created를 보냅니다.
실패한 전송 재전송
최근 24시간, 3일, 7일 동안 실패한 전송을 엔드포인트 메뉴에서 다시 보낼 수 있으며, 한 번에 최대 1,000개입니다.
- 비활성화된 엔드포인트를 다시 켜면 실패한 전송을 재전송하겠냐고 묻습니다.
- 재전송은 원래의 webhook-id와 sequence를 유지합니다.
- 엔드포인트가 일시 중지된 동안 재전송은 실패를 늘리지 않고 기다립니다.
사용자 지정 헤더
엔드포인트에 고정 헤더를 최대 10개까지 추가할 수 있습니다. 예를 들면 Zapier나 n8n용 Authorization 헤더입니다. 값은 암호화되어 저장되며 다시 표시되지 않습니다.
- Ikiform 자체 헤더는 덮어쓸 수 없습니다.
- 엔드포인트 URL을 바꾸면 헤더 값을 다시 입력해야 하므로, 저장된 토큰이 새 URL로 전송되지 않습니다.
- 사용자 지정 헤더는 서명 대상이 아니므로, 가능하다면 계속 webhook-signature를 검증하세요.
AI 빌더와 클라이언트 사이트를 위한 가이드
개선
버거운 엔드포인트를 더 배려하도록
Ikiform은 한 엔드포인트로 동시에 최대 5개의 요청만 보냅니다. 20번 연속 실패하면 전송을 5분 동안 멈추고, 매번 두 배로 늘려 최대 1시간까지 멈추며, 기다리는 동안에는 재시도 횟수가 줄지 않습니다.
- 1시간 이상 실패하던 엔드포인트가 복구되면 이메일을 보내 드립니다.
- 전송이 일시 중지되었거나 4xx로 거부되거나 실패하고 있으면 엔드포인트 페이지에 한 줄로 표시됩니다.
- 성공한 전송 없이 5일이 지난 엔드포인트는 이전처럼 비활성화되며 이메일이 갑니다.
로그인하면 첫 폼이 준비됩니다
처음 로그인하면 워크스페이스와 첫 폼이 만들어지고 바로 열리며, 초대받은 사람은 초대로 곧장 이동합니다. 폼 페이지에는 복사하거나 Claude, ChatGPT, Cursor에서 열 수 있는 설정 프롬프트가 생겼습니다.
설정에서 플랜 해지
플랜 및 사용량에 이제 '플랜 해지'가 있어 결제 포털을 거치지 않아도 됩니다. 플랜은 결제한 기간이 끝날 때까지 계속 작동하며, 그 전까지는 '플랜 재개'로 되돌릴 수 있습니다.
- 구독이 싫다면 같은 단계에서 일회성 제출 팩으로 바꿀 수 있습니다. 크레딧은 만료되지 않습니다.