Flatfile MCP Server

플랫파일 MCP 서버

Flatfile MCP 서버는 Claude Desktop, Claude Code, Cursor 등의 AI 어시스턴트가 Flatfile 데이터와 직접 상호 작용할 수 있도록 지원합니다. 이 MCP 서버는 AI 어시스턴트와 Flatfile을 원활하게 연결합니다.

✨ 특징

• 100개 이상의 Flatfile API 엔드포인트 지원
• 시트, 통합 문서, 스페이스 등을 보고 관리합니다.
• 레코드 추가, 편집 및 삭제
• 귀하의 데이터에 대해 질문하세요
• 자연어로 시트 생성
• 처음부터 새 통합 문서 만들기
• 그리고 더 많은 것들!

🛠️ 설정

Flatfile 개인 액세스 토큰이나 Flatfile API 키가 필요합니다.

API 키

다음 지침에 따라 API 키에 액세스하세요.

개인 액세스 토큰

다음 지침 에 따라 Flatfile 개인 액세스 토큰을 생성하세요.

필터링 도구

Flatfile은 100개 이상의 API 엔드포인트와 각 엔드포인트와 상호 작용하는 도구를 제공합니다. 필요한 도구만 포함되도록 도구를 필터링하는 것이 좋습니다. --enabled-tools 플래그와 활성화할 도구 목록을 쉼표로 구분하여 MCP 서버에 전달하면 됩니다. --enabled-tools 플래그를 전달하지 않으면 모든 도구가 활성화됩니다.

예:

지엑스피1

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요.

Claude Code와 함께 사용

.claude/code/config.json 에 다음을 추가하세요.

Claude Code가 MCP 서버를 추가하는 방법에 대한 지침입니다 .

커서를 사용한 사용

.cursor/mcp.json 에 다음을 추가하세요.

🔧 사용 가능한 도구

• ackEvent - 이벤트 확인: 이벤트 확인
• ackJob - 작업 확인: 작업을 확인하고 작업을 반환합니다.
• ackOutcomeJob - 작업 결과 확인: 작업 결과를 확인하고 작업을 반환합니다.
• archiveSpace - 공간을 보관합니다. 공간에 archivedAt 타임스탬프를 설정합니다.
• assignAgentRole - 에이전트에게 역할 할당: 에이전트에게 역할을 할당합니다.
• assignGuestRole - 게스트에게 역할 지정: 게스트에게 역할을 지정합니다.
• assignUserRole - 사용자에게 역할 할당: 사용자에게 역할을 할당합니다.
• bulkCreateActions - 여러 작업 만들기: 여러 작업 만들기
• bulkDeleteSpace - 공간 삭제: ID로 여러 공간 삭제
• cancelJob - 작업 취소: 작업을 취소하고 작업을 반환합니다.
• completeJob - 작업 완료: 작업을 완료하고 작업을 반환합니다.
• createAction - 액션 생성: 액션 생성
• createAgent - 에이전트 생성: 에이전트 생성
• createAndInviteUser - 사용자 생성 및 초대: 계정에 새로운 사용자를 생성하고 초대합니다.
• createApp - 앱 만들기: 앱을 만듭니다.
• createAssistant - 프롬프트 생성: 프롬프트를 생성합니다.
• createCanvasArea - 캔버스 영역 생성: 새 캔버스 영역을 생성합니다.
• createConstraintApp - 제약 조건 생성: 앱에 대한 새 제약 조건을 생성합니다.
• createDataRetentionPolicy - 데이터 보존 정책 생성: 공간에 새 데이터 보존 정책을 추가합니다.
• createDocument - 문서 만들기: 공간에 새 문서를 추가합니다.
• createDraftSpace - 공간의 초안 만들기: 공간의 초안을 만듭니다.
• createEnvironment - 환경 생성: 새 환경 생성
• createEvent - 이벤트 만들기: 이벤트 만들기
• createGuidanceSpace - 새 지침 만들기: 새 지침을 만듭니다.
• createGuideEnvironment - 가이드 만들기: 가이드를 만듭니다.
• createIdVersion - createId: createId
• createJob - 작업 생성: 작업 생성
• createMappingProgram - 두 스키마 간 매핑 생성: 제공된 두 스키마를 기반으로 매핑 규칙 목록을 생성합니다.
• createRoutine - 루틴 생성: 새로운 루틴을 생성합니다.
• createRulesMapping - 프로그램에 매핑 규칙 추가: 프로그램에 매핑 규칙 추가
• createRunbook - 런북 생성: 새 런북을 생성합니다.
• createSnapshot - 스냅샷 생성: 시트의 스냅샷을 생성합니다.
• createSpace - 공간 생성: 기존 공간 구성을 기반으로 새 공간을 생성합니다.
• createView - 뷰 생성: 공간에 새 뷰 추가
• createWorkbook - 통합 문서 만들기: 통합 문서를 만들고 공간에 추가합니다.
• deleteAction - 작업 삭제: 작업 삭제
• deleteAgent - 에이전트 삭제: 단일 에이전트를 삭제합니다.
• deleteAgentExport - 에이전트 내보내기 삭제: 에이전트 내보내기 삭제
• deleteAgentRole - 에이전트에서 역할 제거: 에이전트에서 역할을 제거합니다.
• deleteAllHistoryForUserMapping - 인증된 사용자에 대한 모든 기록을 삭제합니다. 인증된 사용자에 대한 모든 기록을 삭제합니다.
• deleteApp - 앱 삭제: 앱을 삭제합니다.
• deleteAssistant - 프롬프트 삭제: 프롬프트를 삭제합니다.
• deleteCanvasArea - 캔버스 영역 삭제: 특정 캔버스 영역을 삭제합니다.
• deleteConstraintApp - 제약 조건 삭제: 특정 제약 조건을 삭제합니다.
• deleteDataRetentionPolicy - 데이터 보존 정책 삭제: 단일 데이터 보존 정책을 삭제합니다.
• deleteDocument - 문서 삭제: 단일 문서를 삭제합니다.
• deleteEnvironment - 환경 삭제: 단일 환경을 삭제합니다.
• deleteFile - 파일 삭제: 파일 삭제
• deleteGuest - 게스트 삭제: 게스트 한 명을 삭제합니다.
• deleteGuestRole - 게스트에서 역할 제거: 게스트에서 역할을 제거합니다.
• deleteGuidanceSpace - 가이드 삭제: 가이드 ID로 가이드를 삭제합니다.
• deleteGuideEnvironment - 가이드 삭제: 가이드를 삭제합니다.
• deleteJob - 작업 삭제: 작업 삭제
• deleteMappingProgram - 매핑 프로그램 삭제: 매핑 프로그램을 삭제합니다.
• deleteMultipleRulesMapping - 여러 매핑 규칙 삭제: 프로그램에서 여러 매핑 규칙을 삭제합니다.
• deleteRecords - 레코드 삭제: 통합 문서 시트에서 레코드를 삭제합니다.
• deleteRoutine - 루틴 삭제: 루틴을 삭제합니다.
• deleteRuleMapping - 매핑 규칙 삭제: 프로그램에서 매핑 규칙을 삭제합니다.
• deleteRunbook - 런북 삭제: 런북을 삭제합니다.
• deleteSecret - 이를 통해 비밀을 삭제합니다.
• deleteSheet - 시트 삭제: 통합 문서에서 특정 시트를 삭제합니다.
• deleteSnapshot - 스냅샷 삭제: 시트의 스냅샷을 삭제합니다.
• deleteSpace - 공백 삭제: 공백 삭제
• deleteUser - 사용자 삭제: 사용자를 삭제합니다.
• deleteUserRole - 사용자로부터 역할 제거: 사용자로부터 역할을 제거합니다.
• deleteView - 뷰 삭제: 단일 뷰를 삭제합니다.
• deleteWorkbook - 통합 문서 삭제: 통합 문서와 해당 레코드 데이터를 모두 영구적으로 삭제합니다.
• downloadAgentExport - 에이전트 내보내기 다운로드: 에이전트 내보내기 다운로드
• downloadFile - 파일 다운로드: 파일 다운로드
• duplicateSheet - 시트 복제: 동일한 통합 문서 내의 모든 데이터를 포함하는 시트의 복사본을 만듭니다.
• executeJob - 작업 실행: 작업을 실행하고 작업을 반환합니다.
• failJob - 작업 실패: 작업을 실패하고 작업을 반환합니다.
• getAction - 작업 가져오기: 작업 가져오기
• getAgent - 에이전트 얻기: 에이전트 얻기
• getAgentExport - 에이전트 내보내기 가져오기: 에이전트 내보내기 가져오기
• getAgentLog - 에이전트 로그 가져오기: 에이전트 로그 가져오기
• getAgentLogs - 에이전트에 대한 로그 가져오기: 에이전트에 대한 로그 가져오기
• getAllActions - 공간에 대한 모든 작업 가져오기: 공간에 대한 모든 작업 가져오기
• getApp - 앱 가져오기: 앱을 반환합니다.
• getAssistant - 프롬프트 가져오기: 프롬프트를 반환합니다.
• getCalculationsSheet - 계산 목록: 시트에 대한 모든 계산을 반환합니다.
• getCanvasArea - 캔버스 영역 가져오기: ID로 특정 캔버스 영역을 반환합니다.
• getCellValuesSheet - 필드별로 레코드 셀 가져오기: 시트의 모든 필드별로 그룹화된 레코드 셀 값을 반환합니다.
• getCommit - 커밋 버전 가져오기: 커밋 버전의 세부 정보를 반환합니다.
• getConstraintByIdApp - ID로 제약 조건 가져오기: 특정 제약 조건을 반환합니다.
• getConstraintsApp - 제약 조건 가져오기: 앱에 대한 제약 조건을 반환합니다.
• getConstraintVersionApp - 제약 조건 버전 가져오기: 특정 제약 조건의 지정된 버전을 반환합니다.
• getConstraintVersionsApp - 제약 조건 버전 가져오기: 특정 제약 조건의 버전을 반환합니다.
• getCurrentAccounts - 현재 계정 가져오기: 현재 계정 가져오기
• getDataRetentionPolicy - 데이터 보존 정책 가져오기: 단일 데이터 보존 정책을 반환합니다.
• getDocument - 문서 가져오기: 단일 문서를 반환합니다.
• getEnvironment - 환경 가져오기: 단일 환경 반환
• getEnvironmentAgentExecutionsAgents - 환경의 모든 실행을 가져옵니다. 환경의 모든 실행을 가져옵니다.
• getEnvironmentAgentLogsAgents - 환경의 모든 에이전트 로그 가져오기: 환경의 모든 에이전트 로그 가져오기
• getEvent - 이벤트 가져오기: 이벤트 가져오기
• getEventTokenEvents - 구독 자격 증명 가져오기: 이 공간에 대한 이벤트를 구독하는 데 사용할 수 있는 토큰을 가져옵니다.
• getExecutionPlanJob - 작업 가져오기
• getFile - 파일 가져오기: 파일 가져오기
• getGuest - 게스트 가져오기: 단일 게스트를 반환합니다.
• getGuestToken - 게스트 토큰 가져오기: 단일 게스트 토큰을 반환합니다.
• getGuidanceSpace - 안내 받기: 안내 ID로 안내를 검색합니다.
• getGuideEnvironment - 가이드 가져오기: 가이드를 반환합니다.
• getGuideVersionEnvironment - 가이드 버전 가져오기: 특정 가이드의 지정된 버전을 반환합니다.
• getJob - 일자리 구하기: 일자리 구하기
• getMappingProgram - 매핑 프로그램 가져오기: 매핑 프로그램 가져오기
• getRecordCountsSheet - 레코드 개수 가져오기: 시트에서 레코드 개수를 반환합니다.
• getRecords - 레코드 가져오기: 통합 문서의 시트에서 레코드를 반환합니다.
• getRecordsAsCsvSheet - CSV 파일로 레코드 다운로드: 통합 문서의 시트에서 레코드를 CSV 파일로 반환합니다.
• getRoutine - 루틴 가져오기: 루틴을 반환합니다.
• getRuleMapping - 매핑 규칙 가져오기: 프로그램에서 매핑 규칙 가져오기
• getRunbook - 런북 가져오기: 런북을 반환합니다.
• getSftpCredentialsAuth - Space에 대한 SFTP 자격 증명 가져오기: Space에 대한 SFTP 자격 증명 가져오기
• getSheet - 시트 가져오기: 통합 문서의 시트를 반환합니다.
• getSheetCommits - 시트의 커밋 버전 가져오기: 시트의 커밋 버전을 반환합니다.
• getSnapshot - 스냅샷 가져오기: 시트의 스냅샷을 가져옵니다.
• getSnapshotRecords - 스냅샷에서 레코드 가져오기: 시트의 스냅샷에서 레코드를 가져옵니다.
• getSpace - 공백 가져오기: 공백 하나를 반환합니다.
• getUser - 사용자 가져오기: 사용자를 가져옵니다
• getView - 뷰 가져오기: 단일 뷰를 반환합니다.
• getWorkbook - 통합 문서 가져오기: 단일 통합 문서를 반환합니다.
• getWorkbookCommits - 통합 문서에 대한 커밋 가져오기: 통합 문서에 대한 커밋을 반환합니다.
• indicesRecords - 레코드 인덱스 가져오기: 통합 문서의 시트에서 레코드 인덱스를 반환합니다.
• insertRecords - 레코드 삽입: 통합 문서 시트에 레코드를 추가합니다.
• listAgentExports - 에이전트 내보내기 목록: 에이전트 내보내기 목록
• listAgentRoles - 에이전트 역할 나열: 에이전트에 할당된 역할을 나열합니다.
• listAgents - 에이전트 목록: 에이전트 목록
• listApps - 앱 목록: 계정의 앱을 반환합니다.
• listAssistant - 프롬프트 목록: 사용자가 생성한 프롬프트를 반환합니다.
• listCanvasAreas - 캔버스 영역 목록: 캔버스, 공간 또는 환경으로 필터링된 캔버스 영역 목록을 반환합니다.
• listDocuments - 문서 목록: 해당 공간에 대한 모든 문서를 반환합니다.
• listEntitlements - 자격 목록: resourceId 필터와 일치하는 모든 자격을 반환합니다.
• listEnvironments - 환경 목록: 모든 환경 가져오기
• listEvents - 이벤트 목록: Flatfile 플랫폼이 내보내는 이벤트 주제입니다.
• listFiles - 파일 목록: 파일 목록
• listGuestRoles - 게스트 역할 나열: 게스트에게 할당된 역할을 나열합니다.
• listGuests - 게스트 목록: 모든 게스트를 반환합니다.
• listGuidanceSpace - 지침 목록: 지침 목록
• listGuidesEnvironment - 가이드 목록: 계정의 가이드를 반환합니다.
• listJobs - 작업 목록: 작업 목록
• listMappingPrograms - 매핑 프로그램 목록: 모든 매핑 프로그램 목록
• listRoles - 역할 나열: 계정의 모든 역할 나열
• listRoutines - 루틴 목록: 루틴 목록을 반환합니다.
• listRulesMapping - 매핑 규칙 나열: 프로그램의 모든 매핑 규칙 나열
• listRunbooks - 런북 목록: 런북 목록을 반환합니다.
• listSecrets - 비밀 목록: 지정된 환경 ID에 대한 모든 비밀을 가져오고 선택적으로 공간 재정의를 적용합니다.
• listSheets - 시트 목록: 통합 문서의 시트를 반환합니다.
• listSnapshots - 스냅샷 나열: 시트의 모든 스냅샷 나열
• listSpaceDrafts - 공간에 대한 초안 나열: 공간에 대한 초안을 나열합니다.
• listSpaces - 공간 목록: 계정 또는 환경에 대한 모든 공간을 반환합니다.
• listUserRoles - 사용자 역할 나열: 사용자에게 할당된 역할을 나열합니다.
• listUsers - 사용자 목록: 사용자 목록을 가져옵니다.
• listVersionsAgent - 에이전트의 에이전트 버전 나열: 에이전트의 에이전트 버전 나열
• listViews - 시트별 뷰 목록: 시트에 대한 모든 뷰를 반환합니다.
• listWorkbooks - 통합 문서 목록: 계정 또는 공간에 대한 필터와 일치하는 모든 통합 문서를 반환합니다.
• lockSheet - 시트 잠금: 시트를 잠급니다.
• previewMutationJob - 뮤테이션 미리보기: 뮤테이션 결과를 미리 봅니다.
• resendInviteUser - 사용자 초대 재전송: 해당 계정의 사용자에게 초대를 재전송합니다.
• restoreSnapshot - 스냅샷 복원: 시트의 스냅샷을 복원합니다.
• retryJob - 실패한 작업 재시도: 실패한 작업을 재시도하고 작업을 반환합니다.
• revertAgent - 특정 에이전트 버전으로 되돌리기: 특정 에이전트 버전으로 되돌리기
• splitJob - 작업 분할: 작업을 분할하고 작업 반환
• unarchiveSpace - 공간의 보관을 해제합니다. 공간의 archivedAt 타임스탬프를 null로 설정합니다.
• unlockSheet - 시트 잠금 해제: 시트에서 잠금을 제거합니다.
• updateAction - 작업 업데이트: 작업 업데이트
• updateApp - 앱 업데이트: 앱을 업데이트합니다.
• updateAssistant - 프롬프트 업데이트: 프롬프트를 업데이트합니다.
• updateCanvasArea - 캔버스 영역 업데이트: 기존 캔버스 영역을 업데이트합니다.
• updateConstraintApp - 제약 조건 업데이트: 특정 제약 조건을 업데이트합니다.
• updateCurrentAccount - 현재 계정 업데이트: 현재 계정을 업데이트합니다.
• updateDataRetentionPolicy - 데이터 보존 정책 업데이트: 단일 데이터 보존 정책을 업데이트합니다.
• updateDocument - 문서 업데이트: 본문과 제목만 포함하여 단일 문서를 업데이트합니다.
• updateEnvironment - 환경 업데이트: 예를 들어 이름을 변경하기 위해 단일 환경을 업데이트합니다.
• updateExecutionPlanFieldsJob - 작업 업데이트
• updateExecutionPlanJob - 작업 교체
• updateFile - 파일 업데이트: 예를 들어 통합 문서 ID를 변경하기 위해 파일을 업데이트합니다.
• updateGuest - 게스트 업데이트: 이름이나 이메일을 변경하는 등 단일 게스트를 업데이트합니다.
• updateGuidanceSpace - 지침 업데이트: 지정된 ID로 지침을 업데이트합니다.
• updateGuideEnvironment - 가이드 업데이트: 가이드를 업데이트합니다.
• updateJob - 작업 업데이트: 작업 업데이트
• updateMappingProgram - 매핑 프로그램 업데이트: 매핑 프로그램을 업데이트합니다.
• updateRecords - 레코드 업데이트: 통합 문서 시트의 기존 레코드를 업데이트합니다.
• updateRoutine - 루틴 업데이트: 루틴을 업데이트합니다.
• updateRuleMapping - 매핑 규칙 업데이트: 프로그램의 매핑 규칙을 업데이트합니다.
• updateRulesMapping - 매핑 규칙 목록 업데이트: 프로그램의 매핑 규칙 목록을 업데이트합니다.
• updateRunbook - 런북 업데이트: 런북을 업데이트합니다.
• updateSheet - 시트 업데이트: 시트 업데이트
• updateSpace - 공백 업데이트: 공백을 업데이트하여 이름을 변경합니다.
• updateUser - 사용자 업데이트: 사용자를 업데이트합니다.
• updateView - 뷰 업데이트: 단일 뷰를 업데이트합니다.
• uploadFile - 파일 업로드: 파일 업로드
• upsertSecret - 비밀 Upsert: 환경 또는 공간에 대한 이름으로 비밀을 삽입하거나 업데이트합니다.
• validateSheet - 시트 검증: 시트에서 데이터 후크 및 검증을 실행합니다.