Fillout.io MCP Server

Fillout.io MCP 서버

Fillout.io API를 위한 MCP 서버로, 양식 관리, 응답 처리 및 분석을 지원합니다.

토큰 설정

1. Fillout.io API 키를 받으세요:
   • Fillout.io 계정에 로그인하세요
   • 계정 설정 → API 및 웹훅으로 이동하세요.
   • "새 API 키 만들기"를 클릭하세요.
   • 새로운 API 키를 복사하세요
2. API 키 정보:
   • 프로덕션 키는 fo_live_ 로 시작합니다.
   • 테스트 키는 fo_test_ 로 시작합니다.
   • 테스트 키는 테스트 양식에서만 작동합니다.
   • API 키는 계정의 모든 리소스에 대한 액세스를 제공합니다.
3. 구성에서 your-fillout-api-key API 키로 바꾸세요.

⚠️ 보안 참고 사항:

• API 키를 안전하고 비공개로 유지하세요
• 개발에 테스트 키 사용
• 환경 변수에 키 저장
• 주기적으로 키를 회전하세요
• 버전 제어에 키를 커밋하지 마십시오.

토큰 문제 해결

일반적인 오류 메시지

1. "잘못된 API 키가 제공되었습니다" 또는 "인증에 실패했습니다"
   • 원인 : API 키가 누락되었거나, 형식이 잘못되었거나, 유효하지 않습니다.
   • 해결책 :
     • 키가 fo_live_ 또는 fo_test_ 로 시작하는지 확인하세요.
     • 추가 공백이나 문자가 있는지 확인하세요
     • 환경 변수가 올바르게 설정되었는지 확인하세요
     • 필요한 경우 새 키를 만듭니다.
2. "라이브 폼과 함께 사용되는 테스트 모드 키"
   • 원인 : 프로덕션 양식과 함께 테스트 키( fo_test_ ) 사용
   • 해결책 :
     • 프로덕션 양식에 라이브 키 사용
     • 개발을 위한 테스트 양식 생성
     • 적절한 키 유형으로 전환
3. "요금 한도를 초과했습니다"
   • 원인 : API 요청이 너무 많음
   • 해결책 :
     • 요청 제한 구현
     • 대시보드에서 사용량 확인
     • 요청 패턴 최적화

검증 단계

1. API 키 형식 확인:지엑스피1
2. 테스트 API 키:
   curl -H "Authorization: Bearer your-api-key" \ https://api.fillout.com/v1/api/forms

특징

양식 관리

• 모든 양식 나열
• 양식 세부 정보 받기
• 새로운 양식 만들기
• 양식 삭제
• 양식 설정 업데이트

응답 처리

• 양식 응답 제출
• 양식 제출 받기
• 응답 필터링
• 응답 내보내기

해석학

• 응답률
• 완료 시간
• 제출 추세

도구

1. list_forms
   • 접근 가능한 모든 양식을 가져오세요
   • 매개변수:
     • limit (선택 사항): 반환할 양식 수
     • offset (선택 사항): 페이지 번호 오프셋
   • 반환: 폼 객체 배열
2. get_form
   • 자세한 양식 정보를 얻으세요
   • 매개변수:
     • formId (문자열): 양식 식별자
   • 반환: 질문 및 설정을 포함한 양식 세부 정보
3. create_form
   • 새로운 양식을 만듭니다
   • 매개변수:
     • name (문자열): 양식 이름
     • description (선택적 문자열): 양식 설명
     • questions (배열): 질문 객체의 배열
       • type : 질문 유형(예: '단답형', '객관식')
       • name : 질문 텍스트
       • required : 질문이 필수인지 여부
       • choices : 다중 선택형 질문에 대한 선택 사항 배열
   • 반환: 생성된 폼 객체
4. get_form_responses
   • 양식 제출 받기
   • 매개변수:
     • formId (문자열): 양식 식별자
     • filters (선택 사항): 응답 필터
     • pageSize (선택 사항): 페이지당 결과
     • afterDate (선택 사항): 제출 날짜로 필터링
     • beforeDate (선택 사항): 제출 날짜로 필터링
     • status (선택 사항): 완료 상태로 필터링
   • 반환: 양식 응답 배열
5. submit_form_response
   • 새로운 응답을 제출하세요
   • 매개변수:
     • formId (문자열): 양식 식별자
     • responses (배열): 답변 배열
       • questionId : 질문 식별자
       • value : 응답 값
     • calculations (선택 사항): 사용자 정의 계산
   • 반품: 제출 확인

설정

Claude Desktop과 함께 사용

Docker 구성

NPX 구성

건물

필수 조건

• Node.js 18 이상
• npm 또는 yarn
• Docker(선택 사항)

지역 개발

도커 빌드

예시

양식 만들기

응답 제출

오류 처리

서버는 일반적인 문제에 대한 자세한 오류 메시지를 제공합니다.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.