Flatfile MCP Server

Flatfile 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 エンドポイントがあり、それぞれと連携するツールが用意されています。必要なツールだけを含めるようにフィルタリングすることを強くおすすめします。MCP サーバーに --enabled-tools フラグと、有効にするツールをカンマ区切りで並べたリストを渡すことで設定できます。--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 での使用方法

.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

MCP サーバーの追加方法については、Claude Code の手順をご覧ください。

Cursor での使用方法

.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 - ガイドを作成する：ガイドを作成します
• createIdVersion - createId：createId
• createJob - ジョブを作成する：ジョブを作成します
• createMappingProgram - 2つのスキーマ間のマッピングを作成する：指定された2つのスキーマに基づいて、マッピングルールのリストを作成します
• createRoutine - ルーティンを作成する：新しいルーティンを作成します
• createRulesMapping - プログラムにマッピングルールを追加する：プログラムにマッピングルールを追加します
• createRunbook - ランブックを作成する：新しいランブックを作成します
• createSnapshot - スナップショットを作成する：シートのスナップショットを作成します
• createSpace - スペースを作成する：既存の Space Config に基づいて新しいスペースを作成します
• 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 - スペースの SFTP 認証情報を取得する：スペースの SFTP 認証情報を取得します
• getSheet - シートを取得する：ワークブック内のシートを返します
• getSheetCommits - シートのコミットバージョンを取得する：シートのコミットバージョンを返します
• getSnapshot - スナップショットを取得する：シートのスナップショットを取得します
• getSnapshotRecords - スナップショットからレコードを取得する：シートのスナップショットからレコードを取得します
• getSpace - スペースを取得する：単一のスペースを返します
• 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 - シークレットを一覧表示する：指定した environmentId のすべてのシークレットを取得し、必要に応じてスペースの上書きを適用します
• 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 - シートを検証する：シートでデータフックと検証を実行します