フラットファイル MCP サーバー

Flatfile MCPサーバーは、Claude Desktop、Claude Code、CursorなどのAIアシスタントがFlatfileデータと直接やり取りできるようにします。このMCPサーバーは、AIアシスタントとFlatfileの間にシームレスな橋渡しを構築します。

✨ 特徴

100以上のフラットファイルAPIエンドポイントをサポート
スプレッドシート、ワークブック、スペースなどを表示、管理します
レコードの追加、編集、削除
データについて質問する
自然言語からシートを生成する
新しいワークブックを最初から作成する
さらにもっと！

🛠️ セットアップ

Flatfile 個人アクセストークンまたは Flatfile API キーのいずれかが必要になります。

APIキー

次の手順に従って API キーにアクセスします。

個人アクセストークン

次の手順に従って、フラットファイル個人アクセストークンを作成します。

フィルタリングツール

Flatfile は 100 を超える API エンドポイントと、それぞれを操作するためのツールを提供しています。必要なツールのみをフィルタリングすることを強くお勧めします。これは、有効化したいツールをカンマ区切りでリスト化した--enabled-toolsフラグを MCP サーバーに渡すことで実現できます。-- --enabled-toolsフラグを渡さない場合は、すべてのツールが有効化されます。

例：

{
  "mcpServers": {
      // ...
      "mcp-server-flatfile": {
         "command": "npx",
         "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "getRecords,updateRecords"],
         // ...
      }
      // ...
  }
}

Claude Desktopでの使用

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

クロードコードでの使用

.claude/code/config.jsonに以下を追加します。

claude mcp add mcp-server-flatfile -e FLATFILE_API_URL=https://platform.flatfile.com/api/v1 -e FLATFILE_BEARER_TOKEN=pat_your_token_here -- npx -y @flatfile/mcp-server --enabled-tools ... // Replace with the tools you want to enable

Claude Code による MCP サーバーの追加方法の説明。

カーソルとの使用

.cursor/mcp.jsonに以下を追加します。

{
  "mcpServers": {
    "mcp-server-flatfile": {
      "command": "npx",
      "args": ["-y", "@flatfile/mcp-server", "--enabled-tools", "..."], // Replace with the tools you want to enable
      "env": {
        "FLATFILE_BEARER_TOKEN": "pat_your_token_here",
        "FLATFILE_API_URL": "https://platform.flatfile.com/api/v1" // Optional, for non-US regions or self-hosting
      }
    }
  }
}

🔧 利用可能なツール

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 - ガイドを作成する: ガイドを作成します
createIdバージョン- createId: createId
createJob - ジョブを作成する: ジョブを作成する
createMappingProgram - 2つのスキーマ間のマッピングを作成する: 提供された2つのスキーマに基づいてマッピングルールのリストを作成します
createRoutine - ルーチンを作成する: 新しいルーチンを作成します
createRulesMapping - プログラムにマッピングルールを追加する: プログラムにマッピングルールを追加する
createRunbook - ランブックの作成: 新しいランブックを作成します
createSnapshot - スナップショットを作成する: シートのスナップショットを作成します
createSpace - スペースの作成: 既存のスペース設定に基づいて新しいスペースを作成します
createView - ビューの作成: スペースに新しいビューを追加します
createWorkbook - ワークブックを作成する: ワークブックを作成し、スペースに追加します
deleteAction - アクションを削除する: アクションを削除する
deleteAgent - エージェントの削除: 単一のエージェントを削除します
deleteAgentExport - エージェントのエクスポートを削除します: エージェントのエクスポートを削除します
deleteAgentRole - エージェントからロールを削除: エージェントからロールを削除します。
deleteAllHistoryForUserMapping - 認証されたユーザーのすべての履歴を削除します。認証されたユーザーのすべての履歴を削除します。
deleteApp - アプリを削除する: アプリを削除します
deleteAssistant - プロンプトを削除する: プロンプトを削除します
deleteCanvasArea - キャンバス領域を削除します: 特定のキャンバス領域を削除します
deleteConstraintApp - 制約の削除: 特定の制約を削除します
deleteDataRetentionPolicy - データ保持ポリシーを削除します。単一のデータ保持ポリシーを削除します。
deleteDocument - ドキュメントを削除する: 1つのドキュメントを削除します
deleteEnvironment - 環境を削除する: 単一の環境を削除します
deleteFile - ファイルを削除する: ファイルを削除する
deleteGuest - ゲストを削除: 1人のゲストを削除します
deleteGuestRole - ゲストからロールを削除: ゲストからロールを削除します。
deleteGuidanceSpace - ガイダンスを削除: IDでガイダンスを削除します
deleteGuideEnvironment - ガイドを削除する: ガイドを削除します
deleteJob - ジョブを削除する: ジョブを削除する
deleteMappingProgram - マッピングプログラムを削除します: マッピングプログラムを削除します
deleteMultipleRulesMapping - 複数のマッピングルールを削除: プログラムから複数のマッピングルールを削除します
deleteRecords - レコードの削除: ワークブックシートからレコードを削除します
deleteRoutine - ルーチンを削除する: ルーチンを削除します
deleteRuleMapping - マッピングルールを削除する: プログラムからマッピングルールを削除します
deleteRunbook - ランブックを削除する: ランブックを削除します
deleteSecret - シークレットを削除する
deleteSheet - シートの削除: ワークブックから特定のシートを削除します
deleteSnapshot - スナップショットを削除する: シートのスナップショットを削除します
deleteSpace - スペースを削除する: スペースを削除する
deleteUser - ユーザーを削除する: ユーザーを削除します
deleteUserRole - ユーザーからロールを削除: ユーザーからロールを削除します。
deleteView - ビューを削除: 1つのビューを削除します
deleteWorkbook - ワークブックを削除します。ワークブックとそのすべてのレコードデータを完全に削除します。
downloadAgentExport - エージェントのエクスポートをダウンロード: エージェントのエクスポートをダウンロード
downloadFile - ファイルをダウンロードする: ファイルをダウンロードする
重複シート- シートを複製: 同じワークブック内のすべてのデータを含むシートのコピーを作成します
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 - ゲストを取得する: 1人のゲストを返す
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 - スペースを取得: 1つのスペースを返します
getUser - ユーザーを取得する: ユーザーを取得する
getView - ビューを取得する: 単一のビューを返す
getWorkbook - ワークブックを取得します。単一のワークブックを返します。
getWorkbookCommits - ワークブックのコミットを取得します。ワークブックのコミットを返します。
indicesRecords - レコードのインデックスを取得: ワークブック内のシートからレコードのインデックスを返します
insertRecords - レコードの挿入: ワークブックシートにレコードを追加します
listAgentExports - エージェントのエクスポートを一覧表示します: エージェントのエクスポートを一覧表示します
listAgentRoles - エージェントロールの一覧表示: エージェントに割り当てられたロールを一覧表示します。
listAgents - エージェントの一覧表示: エージェントの一覧表示
listApps - アプリの一覧表示: アカウント内のアプリを返します
listAssistant - プロンプトの一覧: ユーザーが作成したプロンプトを返します
listCanvasAreas - キャンバス領域の一覧: キャンバス、スペース、または環境でフィルタリングされたキャンバス領域のリストを返します。
listDocuments - ドキュメントの一覧表示: スペースのすべてのドキュメントを返します
listEntitlements - 資格の一覧表示: resourceId のフィルターに一致するすべての資格を返します
listEnvironments - 環境の一覧表示: すべての環境を取得する
listEvents - イベントの一覧: Flatfile Platform が発行するイベントトピック。
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 - シークレットのアップサート: 環境またはスペースの名前でシークレットを挿入または更新します
validateSheet - シートを検証する: シート上でデータフックと検証を実行する

Flatfile MCP Server

Integrations