Flatfile MCP Server

Der Flatfile MCP Server ermöglicht KI-Assistenten wie Claude Desktop, Claude Code, Cursor und anderen die direkte Interaktion mit Ihren Flatfile-Daten. Dieser MCP Server schafft eine nahtlose Verbindung zwischen KI-Assistenten und Flatfile.

✨ Funktionen

Unterstützt über 100 Flatfile-API-Endpunkte
Anzeigen und Verwalten von Tabellen, Arbeitsmappen, Bereichen und mehr
Datensätze hinzufügen, bearbeiten und löschen
Stellen Sie Fragen zu Ihren Daten
Erstellen Sie Tabellen aus natürlicher Sprache
Erstellen Sie neue Arbeitsmappen von Grund auf
Und mehr!

🛠️ Einrichtung

Sie benötigen entweder ein persönliches Flatfile-Zugriffstoken oder einen Flatfile-API-Schlüssel.

API-Schlüssel

Greifen Sie auf Ihren API-Schlüssel zu, indem Sie diese Anweisungen befolgen .

Persönlicher Zugriffstoken

Erstellen Sie ein persönliches Flatfile-Zugriffstoken, indem Sie diese Anweisungen befolgen .

Filterwerkzeuge

Flatfile bietet über 100 API-Endpunkte und für jeden ein Tool zur Interaktion. Es wird dringend empfohlen, die Tools so zu filtern, dass nur die benötigten enthalten sind. Übergeben Sie dazu das Flag --enabled-tools zusammen mit einer kommagetrennten Liste der zu aktivierenden Tools an den MCP-Server. Wird das Flag --enabled-tools nicht übergeben, werden alle Tools aktiviert.

Beispiel:

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

Verwendung mit Claude Desktop

Fügen Sie Ihrer claude_desktop_config.json Folgendes hinzu:

{
  "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
      }
    }
  }
}

Verwendung mit Claude Code

Fügen Sie Folgendes zu Ihrer .claude/code/config.json hinzu:

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-Anweisungen zum Hinzufügen eines MCP-Servers.

Verwendung mit Cursor

Fügen Sie Folgendes zu Ihrer .cursor/mcp.json hinzu:

{
  "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
      }
    }
  }
}

🔧 Verfügbare Tools

ackEvent - Ein Ereignis bestätigen: Ein Ereignis bestätigen
ackJob - Einen Job bestätigen: Einen Job bestätigen und den Job zurückgeben
ackOutcomeJob - Auftragsergebnis bestätigen: Auftragsergebnis bestätigen und Auftrag zurückgeben
archiveSpace – Archiviert einen Space: Legt den „archivedAt“-Zeitstempel für einen Space fest
assignAgentRole – Einem Agenten eine Rolle zuweisen: Weist einem Agenten eine Rolle zu.
assignGuestRole – Dem Gast eine Rolle zuweisen: Weist einem Gast eine Rolle zu.
assignUserRole – Dem Benutzer eine Rolle zuweisen: Weist einem Benutzer eine Rolle zu.
bulkCreateActions - Mehrere Aktionen erstellen: Mehrere Aktionen erstellen
bulkDeleteSpace - Leerzeichen löschen: Mehrere Leerzeichen nach ID löschen
cancelJob - Einen Job abbrechen: Einen Job abbrechen und den Job zurückgeben
completeJob – Einen Job abschließen: Einen Job abschließen und den Job zurückgeben
createAction - Eine Aktion erstellen: Eine Aktion erstellen
createAgent - Einen Agenten erstellen: Einen Agenten erstellen
createAndInviteUser – Benutzer erstellen und einladen: Erstellt einen neuen Benutzer und lädt ihn zu Ihrem Konto ein.
createApp - App erstellen: Erstellt eine App
createAssistant - Eingabeaufforderung erstellen: Erstellt eine Eingabeaufforderung
createCanvasArea - Einen Canvas-Bereich erstellen: Erstellt einen neuen Canvas-Bereich
createConstraintApp - Einschränkung erstellen: Erstellt eine neue Einschränkung für eine App
createDataRetentionPolicy – Erstellen einer Datenaufbewahrungsrichtlinie: Fügen Sie dem Bereich eine neue Datenaufbewahrungsrichtlinie hinzu
createDocument - Dokument erstellen: Dem Bereich ein neues Dokument hinzufügen
createDraftSpace - Einen Entwurf eines Raumes erstellen: Erstellt einen Entwurf eines Raumes
createEnvironment - Umgebung erstellen: Neue Umgebung erstellen
createEvent - Ein Ereignis erstellen: Ein Ereignis erstellen
createGuidanceSpace - Neue Anleitung erstellen: Erstellt eine neue Anleitung
createGuideEnvironment - Anleitung erstellen: Erstellt eine Anleitung
createIdVersion - createId: createId
createJob - Einen Job erstellen: Einen Job erstellen
createMappingProgram - Erstellen Sie eine Zuordnung zwischen zwei Schemata: Erstellt eine Liste von Zuordnungsregeln basierend auf zwei bereitgestellten Schemata
createRoutine - Eine Routine erstellen: Erstellt eine neue Routine
createRulesMapping - Zuordnungsregeln zu einem Programm hinzufügen: Zuordnungsregeln zu einem Programm hinzufügen
createRunbook – Runbook erstellen: Erstellt ein neues Runbook
createSnapshot - Snapshot erstellen: Erstellt einen Snapshot eines Blattes
createSpace - Einen Space erstellen: Erstellt einen neuen Space basierend auf einer vorhandenen Space-Konfiguration
createView – Eine Ansicht erstellen: Dem Bereich eine neue Ansicht hinzufügen
createWorkbook – Arbeitsmappe erstellen: Erstellt eine Arbeitsmappe und fügt sie einem Bereich hinzu
deleteAction - Eine Aktion löschen: Eine Aktion löschen
deleteAgent - Einen Agenten löschen: Löscht einen einzelnen Agenten
deleteAgentExport - Einen Agentenexport löschen: Einen Agentenexport löschen
deleteAgentRole – Rolle vom Agenten entfernen: Entfernt eine Rolle von einem Agenten.
deleteAllHistoryForUserMapping - Löscht den gesamten Verlauf für den authentifizierten Benutzer: Löscht den gesamten Verlauf für den authentifizierten Benutzer
deleteApp - App löschen: Löscht eine App
deleteAssistant - Eingabeaufforderungen löschen: Löscht eine Eingabeaufforderung
deleteCanvasArea – Einen Canvas-Bereich löschen: Löscht einen bestimmten Canvas-Bereich
deleteConstraintApp - Einschränkung löschen: Löscht eine bestimmte Einschränkung
deleteDataRetentionPolicy – Löschen einer Datenaufbewahrungsrichtlinie: Löscht eine einzelne Datenaufbewahrungsrichtlinie
deleteDocument - Dokument löschen: Löscht ein einzelnes Dokument
deleteEnvironment – Umgebung löschen: Löscht eine einzelne Umgebung
deleteFile - Datei löschen: Datei löschen
deleteGuest - Einen Gast löschen: Löscht einen einzelnen Gast
deleteGuestRole – Rolle von Gast entfernen: Entfernt eine Rolle von einem Gast.
deleteGuidanceSpace - Anleitung löschen: Löscht eine Anleitung anhand ihrer ID
deleteGuideEnvironment - Anleitung löschen: Löscht eine Anleitung
deleteJob - Einen Job löschen: Einen Job löschen
deleteMappingProgram - Ein Mapping-Programm löschen: Löscht ein Mapping-Programm
deleteMultipleRulesMapping - Mehrere Mapping-Regeln löschen: Löscht mehrere Mapping-Regeln aus einem Programm
deleteRecords - Datensätze löschen: Löscht Datensätze aus einem Arbeitsmappenblatt
deleteRoutine - Eine Routine löschen: Löscht eine Routine
deleteRuleMapping - Eine Mapping-Regel löschen: Löscht eine Mapping-Regel aus einem Programm
deleteRunbook – Ein Runbook löschen: Löscht ein Runbook
deleteSecret - Löscht ein Geheimnis damit
deleteSheet – Ein Blatt löschen: Löscht ein bestimmtes Blatt aus einer Arbeitsmappe
deleteSnapshot - Einen Snapshot löschen: Löscht einen Snapshot eines Blattes
deleteSpace - Einen Raum löschen: Einen Raum löschen
deleteUser - Einen Benutzer löschen: Löscht einen Benutzer
deleteUserRole – Rolle vom Benutzer entfernen: Entfernt eine Rolle von einem Benutzer.
deleteView – Eine Ansicht löschen: Löscht eine einzelne Ansicht
deleteWorkbook - Arbeitsmappe löschen: Löscht eine Arbeitsmappe und alle darin enthaltenen Datensätze dauerhaft
downloadAgentExport - Einen Agentenexport herunterladen: Einen Agentenexport herunterladen
downloadFile - Eine Datei herunterladen: Eine Datei herunterladen
duplicateSheet - Ein Blatt duplizieren: Erstellt eine Kopie eines Blattes inklusive aller Daten innerhalb derselben Arbeitsmappe
executeJob - Einen Job ausführen: Einen Job ausführen und den Job zurückgeben
failJob - Einen Job fehlschlagen lassen: Einen Job fehlschlagen lassen und den Job zurückgeben
getAction - Eine Aktion abrufen: Eine Aktion abrufen
getAgent - Holen Sie sich einen Agenten: Holen Sie sich einen Agenten
getAgentExport - Einen Agentenexport abrufen: Einen Agentenexport abrufen
getAgentLog - Agentenprotokoll abrufen: Agentenprotokoll abrufen
getAgentLogs - Protokolle für einen Agenten abrufen: Protokolle für einen Agenten abrufen
getAllActions - Alle Aktionen für den Bereich abrufen: Alle Aktionen für den Bereich abrufen
getApp – Holen Sie sich eine App: Gibt eine App zurück
getAssistant - Eine Eingabeaufforderung abrufen: Gibt eine Eingabeaufforderung zurück
getCalculationsSheet - Berechnungen auflisten: Gibt alle Berechnungen für ein Blatt zurück
getCanvasArea – Einen Canvas-Bereich abrufen: Gibt einen bestimmten Canvas-Bereich nach ID zurück
getCellValuesSheet - Datensatzzellen nach Feld abrufen: Gibt Datensatzzellenwerte gruppiert nach allen Feldern im Blatt zurück
getCommit - Eine Commit-Version abrufen: Gibt die Details einer Commit-Version zurück
getConstraintByIdApp - Constraint nach ID abrufen: Gibt eine bestimmte Constraint zurück
getConstraintsApp - Einschränkungen abrufen: Gibt Einschränkungen für eine App zurück
getConstraintVersionApp - Constraint-Version abrufen: Gibt eine angegebene Version einer bestimmten Einschränkung zurück
getConstraintVersionsApp - Constraint-Versionen abrufen: Gibt die Versionen einer bestimmten Einschränkung zurück
getCurrentAccounts - Aktuelles Konto abrufen: Aktuelles Konto abrufen
getDataRetentionPolicy – Datenaufbewahrungsrichtlinie abrufen: Gibt eine einzelne Datenaufbewahrungsrichtlinie zurück
getDocument - Dokument abrufen: Gibt ein einzelnes Dokument zurück
getEnvironment - Eine Umgebung abrufen: Gibt eine einzelne Umgebung zurück
getEnvironmentAgentExecutionsAgents - Alle Ausführungen in Ihrer Umgebung abrufen: Alle Ausführungen in Ihrer Umgebung abrufen
getEnvironmentAgentLogsAgents - Alle Agentenprotokolle in Ihrer Umgebung abrufen: Alle Agentenprotokolle in Ihrer Umgebung abrufen
getEvent - Ereignis abrufen: Ereignis abrufen
getEventTokenEvents - Abonnement-Anmeldeinformationen abrufen: Holen Sie sich ein Token, mit dem Sie Ereignisse für diesen Bereich abonnieren können
getExecutionPlanJob - Einen Job bekommen
getFile - Datei abrufen: Datei abrufen
getGuest - Einen Gast holen: Gibt einen einzelnen Gast zurück
getGuestToken - Gasttoken abrufen: Gibt ein einzelnes Gasttoken zurück
getGuidanceSpace - Anleitung abrufen: Ruft eine Anleitung anhand ihrer ID ab
getGuideEnvironment - Holen Sie sich einen Leitfaden: Gibt einen Leitfaden zurück
getGuideVersionEnvironment - Leitfadenversion abrufen: Gibt eine angegebene Version eines bestimmten Leitfadens zurück
getJob - Einen Job bekommen: Einen Job bekommen
getMappingProgram - Holen Sie sich ein Mapping-Programm: Holen Sie sich ein Mapping-Programm
getRecordCountsSheet - Datensatzanzahl abrufen: Gibt die Anzahl der Datensätze aus einem Blatt zurück
getRecords - Datensätze abrufen: Gibt Datensätze aus einem Blatt in einer Arbeitsmappe zurück
getRecordsAsCsvSheet - Datensätze als CSV-Datei herunterladen: Gibt Datensätze aus einem Blatt in einer Arbeitsmappe als CSV-Datei zurück
getRoutine - Eine Routine abrufen: Gibt eine Routine zurück
getRuleMapping - Mapping-Regel abrufen: Eine Mapping-Regel aus einem Programm abrufen
getRunbook – Runbook abrufen: Gibt ein Runbook zurück
getSftpCredentialsAuth - SFTP-Anmeldeinformationen für Space abrufen: SFTP-Anmeldeinformationen für Space abrufen
getSheet - Ein Blatt abrufen: Gibt ein Blatt in einer Arbeitsmappe zurück
getSheetCommits - Commit-Versionen für ein Blatt abrufen: Gibt die Commit-Versionen für ein Blatt zurück
getSnapshot - Schnappschuss abrufen: Ruft einen Schnappschuss eines Blattes ab
getSnapshotRecords - Datensätze aus einem Snapshot abrufen: Ruft Datensätze aus einem Snapshot eines Blatts ab
getSpace - Leerzeichen abrufen: Gibt ein einzelnes Leerzeichen zurück
getUser - Einen Benutzer abrufen: Ruft einen Benutzer ab
getView – Eine Ansicht abrufen: Gibt eine einzelne Ansicht zurück
getWorkbook – Arbeitsmappe abrufen: Gibt eine einzelne Arbeitsmappe zurück
getWorkbookCommits - Commits für eine Arbeitsmappe abrufen: Gibt die Commits für eine Arbeitsmappe zurück
indicesRecords - Datensatzindizes abrufen: Gibt Indizes von Datensätzen aus einem Blatt in einer Arbeitsmappe zurück
insertRecords - Datensätze einfügen: Fügt Datensätze zu einem Arbeitsmappenblatt hinzu
listAgentExports - Agentenexporte auflisten: Agentenexporte auflisten
listAgentRoles – Agentenrollen auflisten: Listet die einem Agenten zugewiesenen Rollen auf.
listAgents - Agenten auflisten: Agenten auflisten
listApps – Apps auflisten: Gibt Apps in einem Konto zurück
listAssistant - Listeneingabeaufforderungen: Gibt vom Benutzer erstellte Eingabeaufforderungen zurück
listCanvasAreas – Canvas-Bereiche auflisten: Gibt eine Liste von Canvas-Bereichen zurück, gefiltert nach Canvas, Space oder Environment
listDocuments - Dokumente auflisten: Gibt alle Dokumente für einen Bereich zurück
listEntitlements - Listenberechtigungen: Gibt alle Berechtigungen zurück, die einem Filter für resourceId entsprechen
listEnvironments – Umgebungen auflisten: Alle Umgebungen abrufen
listEvents – Listenereignisse: Ereignisthemen, die die Flatfile-Plattform ausgibt.
listFiles - Dateien auflisten: Dateien auflisten
listGuestRoles – Gastrollen auflisten: Listet die einem Gast zugewiesenen Rollen auf.
listGuests - Gäste auflisten: Gibt alle Gäste zurück
listGuidanceSpace - Anleitungen auflisten: Listet Anleitungen auf
listGuidesEnvironment - Anleitungen auflisten: Gibt Anleitungen in einem Konto zurück
listJobs - Jobs auflisten: Jobs auflisten
listMappingPrograms - Mapping-Programme auflisten: Alle Mapping-Programme auflisten
listRoles – Rollen auflisten: Alle Rollen für ein Konto auflisten
listRoutines - Routinen auflisten: Gibt eine Liste von Routinen zurück
listRulesMapping - Mapping-Regeln auflisten: Alle Mapping-Regeln in einem Programm auflisten
listRunbooks – Runbooks auflisten: Gibt eine Liste von Runbooks zurück
listSecrets – Geheimnisse auflisten: Alle Geheimnisse für eine bestimmte Umgebungs-ID abrufen und optional Speicherplatzüberschreibungen anwenden
listSheets – Blätter auflisten: Gibt Blätter in einer Arbeitsmappe zurück
listSnapshots - Snapshots auflisten: Alle Snapshots eines Blattes auflisten
listSpaceDrafts - Entwürfe für einen Bereich auflisten: Listet Entwürfe für einen Bereich auf
listSpaces – Bereiche auflisten: Gibt alle Bereiche für ein Konto oder eine Umgebung zurück
listUserRoles – Benutzerrollen auflisten: Listet die einem Benutzer zugewiesenen Rollen auf.
listUsers - Benutzer auflisten: Ruft eine Liste der Benutzer ab
listVersionsAgent – Agentenversionen für einen Agenten auflisten: Agentenversionen für einen Agenten auflisten
listViews – Ansichten nach Blatt auflisten: Gibt alle Ansichten für das Blatt zurück
listWorkbooks – Arbeitsmappen auflisten: Gibt alle Arbeitsmappen zurück, die einem Filter für ein Konto oder einen Bereich entsprechen
lockSheet - Blatt sperren: Sperrt ein Blatt
previewMutationJob - Vorschau einer Mutation: Vorschau der Ergebnisse einer Mutation
resendInviteUser – Benutzereinladung erneut senden: Sendet eine Einladung für Ihr Konto erneut an einen Benutzer.
restoreSnapshot - Einen Snapshot wiederherstellen: Stellt einen Snapshot eines Blattes wieder her
retryJob – Einen fehlgeschlagenen Job wiederholen: Einen fehlgeschlagenen Job wiederholen und den Job zurückgeben
revertAgent - Auf eine bestimmte Agentenversion zurücksetzen: Auf eine bestimmte Agentenversion zurücksetzen
splitJob - Einen Job aufteilen: Einen Job aufteilen und den Job zurückgeben
unarchiveSpace - Entarchiviert einen Space: Setzt den archivedAt-Zeitstempel eines Spaces auf null
unlockSheet - Entsperren eines Blattes: Entfernt eine Sperre von einem Blatt
updateAction - Eine Aktion aktualisieren: Eine Aktion aktualisieren
updateApp – App aktualisieren: Aktualisiert eine App
updateAssistant - Eine Eingabeaufforderung aktualisieren: Aktualisiert eine Eingabeaufforderung
updateCanvasArea – Einen Canvas-Bereich aktualisieren: Aktualisiert einen vorhandenen Canvas-Bereich
updateConstraintApp - Update-Constraint: Aktualisiert eine bestimmte Einschränkung
updateCurrentAccount - Aktuelles Konto aktualisieren: Aktuelles Konto aktualisieren
updateDataRetentionPolicy – Aktualisieren einer Datenaufbewahrungsrichtlinie: Aktualisiert eine einzelne Datenaufbewahrungsrichtlinie
updateDocument - Ein Dokument aktualisieren: aktualisiert ein einzelnes Dokument, nur den Text und den Titel
updateEnvironment - Aktualisieren einer Umgebung: Aktualisiert eine einzelne Umgebung, um beispielsweise den Namen zu ändern
updateExecutionPlanFieldsJob – Einen Job aktualisieren
updateExecutionPlanJob - Einen Job ersetzen
updateFile - Datei aktualisieren: Aktualisieren Sie eine Datei, um beispielsweise die Arbeitsmappen-ID zu ändern
updateGuest – Einen Gast aktualisieren: Aktualisiert einen einzelnen Gast, beispielsweise um den Namen oder die E-Mail-Adresse zu ändern
updateGuidanceSpace - Anleitung aktualisieren: Aktualisiert eine Anleitung mit der angegebenen ID
updateGuideEnvironment - Einen Leitfaden aktualisieren: Aktualisiert einen Leitfaden
updateJob - Einen Job aktualisieren: Einen Job aktualisieren
updateMappingProgram - Mapping-Programm aktualisieren: Aktualisiert ein Mapping-Programm
updateRecords - Datensätze aktualisieren: Aktualisiert vorhandene Datensätze in einem Arbeitsmappenblatt
updateRoutine - Eine Routine aktualisieren: Aktualisiert eine Routine
updateRuleMapping – Mapping-Regel aktualisieren: Aktualisiert eine Mapping-Regel in einem Programm
updateRulesMapping – Aktualisieren einer Liste von Zuordnungsregeln: Aktualisiert eine Liste von Zuordnungsregeln in einem Programm
updateRunbook – Ein Runbook aktualisieren: Aktualisiert ein Runbook
updateSheet - Ein Blatt aktualisieren: Aktualisiert Blatt
updateSpace - Einen Space aktualisieren: Aktualisieren Sie einen Space, um beispielsweise den Namen zu ändern
updateUser - Einen Benutzer aktualisieren: Aktualisiert einen Benutzer
updateView – Eine Ansicht aktualisieren: Aktualisiert eine einzelne Ansicht
uploadFile - Datei hochladen: Datei hochladen
upsertSecret - Upsert a Secret: Einfügen oder Aktualisieren eines Geheimnisses nach Namen für Umgebung oder Raum
validateSheet – Ein Blatt validieren: Daten-Hooks und Validierung auslösen, um sie auf einem Blatt auszuführen

Flatfile MCP Server

Integrations