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 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.