플랫파일 MCP 서버

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

✨ 특징

• 100개 이상의 Flatfile API 엔드포인트 지원

• 시트, 통합 문서, 스페이스 등을 보고 관리합니다.

• 레코드 추가, 편집 및 삭제

• 귀하의 데이터에 대해 질문하세요

• 자연어로 시트 생성

• 처음부터 새 통합 문서 만들기

• 그리고 더 많은 것들!

Related MCP server: Azure AI Search MCP Server

🛠️ 설정

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 - 시트 검증: 시트에서 데이터 후크 및 검증을 실행합니다.