Fillout.io MCP 서버
Fillout.io API를 위한 MCP 서버로, 양식 관리, 응답 처리 및 분석을 지원합니다.
토큰 설정
- Fillout.io API 키를 받으세요:
- Fillout.io 계정에 로그인하세요
- 계정 설정 → API 및 웹훅으로 이동하세요.
- "새 API 키 만들기"를 클릭하세요.
- 새로운 API 키를 복사하세요
- API 키 정보:
- 프로덕션 키는
fo_live_ 로 시작합니다. - 테스트 키는
fo_test_ 로 시작합니다. - 테스트 키는 테스트 양식에서만 작동합니다.
- API 키는 계정의 모든 리소스에 대한 액세스를 제공합니다.
- 구성에서
your-fillout-api-key API 키로 바꾸세요.
⚠️ 보안 참고 사항:
- API 키를 안전하고 비공개로 유지하세요
- 개발에 테스트 키 사용
- 환경 변수에 키 저장
- 주기적으로 키를 회전하세요
- 버전 제어에 키를 커밋하지 마십시오.
토큰 문제 해결
일반적인 오류 메시지
- "잘못된 API 키가 제공되었습니다" 또는 "인증에 실패했습니다"
- 원인 : API 키가 누락되었거나, 형식이 잘못되었거나, 유효하지 않습니다.
- 해결책 :
- 키가
fo_live_ 또는 fo_test_ 로 시작하는지 확인하세요. - 추가 공백이나 문자가 있는지 확인하세요
- 환경 변수가 올바르게 설정되었는지 확인하세요
- 필요한 경우 새 키를 만듭니다.
- "라이브 폼과 함께 사용되는 테스트 모드 키"
- 원인 : 프로덕션 양식과 함께 테스트 키(
fo_test_ ) 사용 - 해결책 :
- 프로덕션 양식에 라이브 키 사용
- 개발을 위한 테스트 양식 생성
- 적절한 키 유형으로 전환
- "요금 한도를 초과했습니다"
- 원인 : API 요청이 너무 많음
- 해결책 :
- 요청 제한 구현
- 대시보드에서 사용량 확인
- 요청 패턴 최적화
검증 단계
- API 키 형식 확인:지엑스피1
- 테스트 API 키:
curl -H "Authorization: Bearer your-api-key" \
https://api.fillout.com/v1/api/forms
특징
양식 관리
- 모든 양식 나열
- 양식 세부 정보 받기
- 새로운 양식 만들기
- 양식 삭제
- 양식 설정 업데이트
응답 처리
- 양식 응답 제출
- 양식 제출 받기
- 응답 필터링
- 응답 내보내기
해석학
도구
list_forms- 접근 가능한 모든 양식을 가져오세요
- 매개변수:
limit (선택 사항): 반환할 양식 수offset (선택 사항): 페이지 번호 오프셋
- 반환: 폼 객체 배열
get_form- 자세한 양식 정보를 얻으세요
- 매개변수:
- 반환: 질문 및 설정을 포함한 양식 세부 정보
create_form- 새로운 양식을 만듭니다
- 매개변수:
name (문자열): 양식 이름description (선택적 문자열): 양식 설명questions (배열): 질문 객체의 배열type : 질문 유형(예: '단답형', '객관식')name : 질문 텍스트required : 질문이 필수인지 여부choices : 다중 선택형 질문에 대한 선택 사항 배열
- 반환: 생성된 폼 객체
get_form_responses- 양식 제출 받기
- 매개변수:
formId (문자열): 양식 식별자filters (선택 사항): 응답 필터pageSize (선택 사항): 페이지당 결과afterDate (선택 사항): 제출 날짜로 필터링beforeDate (선택 사항): 제출 날짜로 필터링status (선택 사항): 완료 상태로 필터링
- 반환: 양식 응답 배열
submit_form_response- 새로운 응답을 제출하세요
- 매개변수:
formId (문자열): 양식 식별자responses (배열): 답변 배열questionId : 질문 식별자value : 응답 값
calculations (선택 사항): 사용자 정의 계산
- 반품: 제출 확인
설정
Claude Desktop과 함께 사용
Docker 구성
{
"mcpServers": {
"fillout": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"FILLOUT_API_KEY",
"mcp/fillout"
],
"env": {
"FILLOUT_API_KEY": "your-fillout-api-key"
}
}
}
}
NPX 구성
{
"mcpServers": {
"fillout": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-fillout"
],
"env": {
"FILLOUT_API_KEY": "your-fillout-api-key"
}
}
}
}
건물
필수 조건
- Node.js 18 이상
- npm 또는 yarn
- Docker(선택 사항)
지역 개발
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build for production
npm run build
도커 빌드
# Build image
docker build -t mcp/fillout .
# Run container
docker run -e FILLOUT_API_KEY=your-key mcp/fillout
예시
양식 만들기
const form = await client.createForm({
name: "Customer Feedback",
description: "Please share your experience",
questions: [
{
type: "ShortAnswer",
name: "What did you like most?",
required: true
},
{
type: "MultipleChoice",
name: "Would you recommend us?",
required: true,
choices: ["Yes", "No", "Maybe"]
}
]
});
응답 제출
const response = await client.submitFormResponse(formId, {
responses: [
{
questionId: "q1",
value: "Great customer service!"
},
{
questionId: "q2",
value: "Yes"
}
]
});
오류 처리
서버는 일반적인 문제에 대한 자세한 오류 메시지를 제공합니다.
try {
const forms = await client.listForms();
} catch (error) {
if (error instanceof AuthenticationError) {
// Handle invalid API key
} else if (error instanceof FilloutError) {
// Handle API-specific errors
} else {
// Handle unexpected errors
}
}
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.