Servidor MCP de archivos planos

El servidor MCP de Flatfile permite que asistentes de IA como Claude Desktop, Claude Code, Cursor y otros interactúen directamente con los datos de Flatfile. Este servidor MCP crea una conexión fluida entre los asistentes de IA y Flatfile.

✨ Características

Admite más de 100 puntos finales de API de archivo plano
Ver y administrar hojas de cálculo, libros de trabajo, espacios y más
Agregar, editar y eliminar registros
Haz preguntas sobre tus datos
Generar hojas a partir de lenguaje natural
Crear nuevos libros de trabajo desde cero
¡Y más!

🛠️ Configuración

Necesitará un token de acceso personal de Flatfile o una clave API de Flatfile.

Clave API

Acceda a su clave API siguiendo estas instrucciones .

Token de acceso personal

Cree un token de acceso personal de archivo plano siguiendo estas instrucciones .

Herramientas de filtrado

Flatfile proporciona más de 100 puntos finales de API, con una herramienta para interactuar con cada uno. Se recomienda encarecidamente filtrar las herramientas para incluir solo las necesarias. Esto se puede hacer enviando el indicador --enabled-tools al servidor MCP junto con una lista separada por comas de las herramientas que desea habilitar. Si no se envía el indicador --enabled-tools , se habilitarán todas las herramientas.

Ejemplo:

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

Uso con Claude Desktop

Agregue lo siguiente a su 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
      }
    }
  }
}

Uso con Claude Code

Agregue lo siguiente a su .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

Instrucciones de Claude Code sobre cómo agregar un servidor MCP.

Uso con cursor

Agregue lo siguiente a su .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
      }
    }
  }
}

🔧 Herramientas disponibles

ackEvent - Reconocer un evento: Reconocer un evento
ackJob - Reconocer un trabajo: Reconocer un trabajo y devolverlo
ackOutcomeJob - Reconocer un resultado laboral: Reconocer un resultado laboral y devolver el trabajo
archiveSpace - Archiva un espacio: Establece la marca de tiempo archivedAt en un espacio
assignmentAgentRole - Asignar rol a agente: asigna un rol a un agente.
assignmentGuestRole - Asignar rol a invitado: asigna un rol a un invitado.
assignmentUserRole - Asignar rol a usuario: asigna un rol a un usuario.
bulkCreateActions - Crear varias acciones: Crear varias acciones
bulkDeleteSpace - Eliminar espacios: eliminar varios espacios por id
cancelJob - Cancelar un trabajo: Cancelar un trabajo y devolverlo
completeJob - Completar un trabajo: Completar un trabajo y devolverlo
createAction - Crear una acción: Crear una acción
createAgent - Crear un agente: Crear un agente
createAndInviteUser - Crear e invitar usuario: crea e invita a un nuevo usuario a su cuenta.
createApp - Crea una aplicación: Crea una aplicación
createAssistant - Crea un mensaje: Crea un mensaje
createCanvasArea - Crear un área de lienzo: Crea una nueva área de lienzo
createConstraintApp - Crear restricción: crea una nueva restricción para una aplicación
createDataRetentionPolicy - Crear una política de retención de datos: Agregar una nueva política de retención de datos al espacio
createDocument - Crear un documento: Agregar un nuevo documento al espacio
createDraftSpace - Crea un borrador de un espacio: Crea un borrador de un espacio
createEnvironment - Crear un entorno: Crear un nuevo entorno
createEvent - Crear un evento: Crear un evento
createGuidanceSpace - Crear una nueva guía: Crea una nueva guía
createGuideEnvironment - Crear una guía: Crea una guía
createIdVersion - createId: createId
createJob - Crear un trabajo: Crear un trabajo
createMappingProgram - Crea una asignación entre dos esquemas: crea una lista de reglas de asignación basadas en dos esquemas proporcionados
createRoutine - Crear una rutina: Crea una nueva rutina
createRulesMapping - Agregar reglas de mapeo a un programa: Agregar reglas de mapeo a un programa
createRunbook - Crear un libro de ejecución: Crea un nuevo libro de ejecución
createSnapshot - Crear una instantánea: Crea una instantánea de una hoja
createSpace - Crear un espacio: Crea un nuevo espacio basado en una configuración de espacio existente
createView - Crear una vista: Agregar una nueva vista al espacio
createWorkbook - Crear un libro de trabajo: Crea un libro de trabajo y lo agrega a un espacio
deleteAction - Eliminar una acción: Eliminar una acción
deleteAgent - Eliminar un agente: elimina un solo agente
deleteAgentExport - Eliminar una exportación de agente: Eliminar una exportación de agente
deleteAgentRole - Eliminar rol del agente: elimina un rol de un agente.
deleteAllHistoryForUserMapping - Elimina todo el historial del usuario autenticado: elimina todo el historial del usuario autenticado
deleteApp - Eliminar una aplicación: Elimina una aplicación
deleteAssistant - Eliminar un aviso: Elimina un aviso
deleteCanvasArea - Eliminar un área de lienzo: elimina un área de lienzo específica
deleteConstraintApp - Eliminar restricción: elimina una restricción específica
deleteDataRetentionPolicy - Eliminar una política de retención de datos: elimina una sola política de retención de datos
deleteDocument - Eliminar un documento: Elimina un solo documento
deleteEnvironment - Eliminar un entorno: Elimina un solo entorno
deleteFile - Eliminar un archivo: Eliminar un archivo
deleteGuest - Eliminar un invitado: Elimina un solo invitado
deleteGuestRole - Eliminar rol de invitado: elimina un rol de un invitado.
deleteGuidanceSpace - Eliminar una guía: elimina una guía por su id
deleteGuideEnvironment - Eliminar una guía: Elimina una guía
deleteJob - Eliminar un trabajo: Eliminar un trabajo
deleteMappingProgram - Eliminar un programa de mapeo: Elimina un programa de mapeo
deleteMultipleRulesMapping - Eliminar múltiples reglas de mapeo: elimina múltiples reglas de mapeo de un programa
deleteRecords - Eliminar registros: elimina registros de una hoja del libro de trabajo
deleteRoutine - Eliminar una rutina: Elimina una rutina
deleteRuleMapping - Eliminar una regla de mapeo: elimina una regla de mapeo de un programa
deleteRunbook - Eliminar un libro de ejecución: elimina un libro de ejecución
deleteSecret - Elimina un secreto mediante él
deleteSheet - Eliminar una hoja: elimina una hoja específica de un libro de trabajo
deleteSnapshot - Eliminar una instantánea: elimina una instantánea de una hoja
deleteSpace - Eliminar un espacio: Eliminar un espacio
deleteUser - Eliminar un usuario: Elimina un usuario
deleteUserRole - Eliminar rol de un usuario: elimina un rol de un usuario.
deleteView - Eliminar una vista: elimina una sola vista
deleteWorkbook - Eliminar un libro de trabajo: elimina un libro de trabajo y todos sus datos de registro de forma permanente
downloadAgentExport - Descargar una exportación de agente: Descargar una exportación de agente
downloadFile - Descargar un archivo: Descargar un archivo
duplicateSheet - Duplicar una hoja: Crea una copia de una hoja que incluye todos sus datos dentro del mismo libro de trabajo
executeJob - Ejecutar un trabajo: Ejecutar un trabajo y devolverlo
failJob - Fallar un trabajo: Fallar un trabajo y devolverlo
getAction - Obtener una acción: Obtener una acción
getAgent - Obtener un agente: Obtener un agente
getAgentExport - Obtener una exportación de agente: Obtener una exportación de agente
getAgentLog - Obtener un registro del agente: Obtener un registro del agente
getAgentLogs - Obtener registros de un agente: Obtener registros de un agente
getAllActions - Obtener todas las acciones para el espacio: Obtener todas las acciones para el espacio
getApp - Obtener una aplicación: Devuelve una aplicación
getAssistant - Obtener un mensaje: Devuelve un mensaje
getCalculationsSheet - Lista de cálculos: devuelve todos los cálculos de una hoja
getCanvasArea - Obtener un área de lienzo: Devuelve un área de lienzo específica por ID
getCellValuesSheet - Obtener celdas de registro por campo: Devuelve los valores de las celdas de registro agrupados por todos los campos de la hoja
getCommit - Obtener una versión de confirmación: Devuelve los detalles de una versión de confirmación
getConstraintByIdApp - Obtener restricción por ID: Devuelve una restricción específica
getConstraintsApp - Obtener restricciones: devuelve las restricciones de una aplicación
getConstraintVersionApp - Obtener la versión de la restricción: Devuelve una versión especificada de una restricción específica
getConstraintVersionsApp - Obtener versiones de restricciones: Devuelve las versiones de una restricción específica
getCurrentAccounts - Obtener la cuenta corriente: Obtener la cuenta corriente
getDataRetentionPolicy - Obtener una política de retención de datos: Devuelve una única política de retención de datos
getDocument - Obtener un documento: Devuelve un solo documento
getEnvironment - Obtener un entorno: Devuelve un único entorno
getEnvironmentAgentExecutionsAgents - Obtenga todas las ejecuciones en su entorno: Obtenga todas las ejecuciones en su entorno
getEnvironmentAgentLogsAgents - Obtenga todos los registros de agentes en su entorno: Obtenga todos los registros de agentes en su entorno
getEvent - Obtener un evento: Obtener un evento
getEventTokenEvents - Obtener credenciales de suscripción: Obtenga un token que se puede usar para suscribirse a eventos para este espacio
getExecutionPlanJob - Consigue un trabajo
getFile - Obtener un archivo: Obtener un archivo
getGuest - Obtener un invitado: Devuelve un solo invitado
getGuestToken - Obtener el token de invitado: devuelve un único token de invitado
getGuidanceSpace - Obtener una guía: recupera una guía por su id
getGuideEnvironment - Obtener una guía: Devuelve una guía
getGuideVersionEnvironment - Obtener la versión de la guía: Devuelve una versión especificada de una guía específica
getJob - Consigue un trabajo: Consigue un trabajo
getMappingProgram - Obtener un programa de mapas: Obtener un programa de mapas
getRecordCountsSheet - Obtener recuentos de registros: devuelve los recuentos de registros de una hoja
getRecords - Obtener registros: Devuelve registros de una hoja en un libro de trabajo
getRecordsAsCsvSheet - Descargar registros como un archivo CSV: Devuelve registros de una hoja en un libro de trabajo como un archivo CSV
getRoutine - Obtener una rutina: Devuelve una rutina
getRuleMapping - Obtener una regla de mapeo: Obtener una regla de mapeo de un programa
getRunbook - Obtener un libro de ejecución: Devuelve un libro de ejecución
getSftpCredentialsAuth - Obtener credenciales SFTP para Space: Obtener credenciales SFTP para Space
getSheet - Obtener una hoja: Devuelve una hoja en un libro de trabajo
getSheetCommits - Obtener versiones de confirmación para una hoja: Devuelve las versiones de confirmación para una hoja
getSnapshot - Obtener una instantánea: obtiene una instantánea de una hoja
getSnapshotRecords - Obtener registros de una instantánea: obtiene registros de una instantánea de una hoja
getSpace - Obtener un espacio: Devuelve un solo espacio
getUser - Obtener un usuario: Obtiene un usuario
getView - Obtener una vista: Devuelve una única vista
getWorkbook - Obtener un libro de trabajo: Devuelve un solo libro de trabajo
getWorkbookCommits - Obtener confirmaciones para un libro de trabajo: Devuelve las confirmaciones para un libro de trabajo
indicesRecords - Obtener índices de registros: Devuelve índices de registros de una hoja en un libro de trabajo
insertRecords - Insertar registros: agrega registros a una hoja del libro de trabajo
listAgentExports - Exportaciones de agentes de listas: Exportaciones de agentes de listas
listAgentRoles - Lista de roles del agente: enumera los roles asignados a un agente.
listAgents - Lista de agentes: Lista de agentes
listApps - Lista de aplicaciones: devuelve las aplicaciones en una cuenta
listAssistant - Lista de indicaciones: devuelve las indicaciones creadas por el usuario
listCanvasAreas - Lista de áreas de lienzo: Devuelve una lista de áreas de lienzo filtradas por lienzo, espacio o entorno
listDocuments - Lista de documentos: Devuelve todos los documentos para un espacio
listEntitlements - Lista de derechos: Devuelve todos los derechos que coinciden con un filtro para resourceId
listEnvironments - Lista de entornos: Obtener todos los entornos
listEvents - Lista de eventos: temas de eventos que emite la plataforma Flatfile.
listFiles - Archivos de lista: Archivos de lista
listGuestRoles - Lista de roles de invitados: enumera los roles asignados a un invitado.
listGuests - Lista de invitados: Devuelve todos los invitados
listGuidanceSpace - Guías de listas: Guías de listas
listGuidesEnvironment - Lista de guías: devuelve las guías de una cuenta
listJobs - Lista de trabajos: Lista de trabajos
listMappingPrograms - Lista de programas de mapeo: Lista todos los programas de mapeo
listRoles - Lista de roles: enumera todos los roles de una cuenta
listRoutines - Lista de rutinas: Devuelve una lista de rutinas
listRulesMapping - Lista de reglas de mapeo: enumera todas las reglas de mapeo en un programa
listRunbooks - Lista de runbooks: Devuelve una lista de runbooks
listSecrets - Lista de secretos: recupera todos los secretos para un environmentId determinado y, opcionalmente, aplica anulaciones de espacio
listSheets - Lista de hojas: Devuelve las hojas de un libro de trabajo
listSnapshots - Lista de instantáneas: enumera todas las instantáneas de una hoja
listSpaceDrafts - Lista de borradores para un espacio: Lista los borradores de un espacio
listSpaces - Lista de espacios: Devuelve todos los espacios para una cuenta o entorno
listUserRoles - Lista de roles de usuario: enumera los roles asignados a un usuario.
listUsers - Lista de usuarios: obtiene una lista de usuarios
listVersionsAgent - Enumera las versiones del agente para un agente: Enumera las versiones del agente para un agente
listViews - Lista de vistas por hoja: Devuelve todas las vistas de la hoja
listWorkbooks - Lista de libros de trabajo: Devuelve todos los libros de trabajo que coinciden con un filtro para una cuenta o espacio
lockSheet - Bloquear una hoja: Bloquea una hoja
previewMutationJob - Vista previa de una mutación: Vista previa de los resultados de una mutación
resendInviteUser - Reenviar invitación de usuario: reenvía una invitación a un usuario para su cuenta.
restoreSnapshot - Restaurar una instantánea: Restaura una instantánea de una hoja
retryJob - Reintentar un trabajo fallido: Reintentar un trabajo fallido y devolver el trabajo
revertAgent - Revertir a una versión específica del agente: Revertir a una versión específica del agente
splitJob - Dividir un trabajo: dividir un trabajo y devolverlo
unarchiveSpace - Desarchiva un espacio: Establece la marca de tiempo archivedAt en un espacio como nula
unlockSheet - Desbloquear una hoja: Elimina un bloqueo de una hoja
updateAction - Actualizar una acción: Actualizar una acción
updateApp - Actualizar una aplicación: Actualiza una aplicación
updateAssistant - Actualizar un mensaje: Actualiza un mensaje
updateCanvasArea - Actualizar un área de lienzo: actualiza un área de lienzo existente
updateConstraintApp - Actualizar restricción: actualiza una restricción específica
updateCurrentAccount - Actualizar la cuenta corriente: Actualizar la cuenta corriente
updateDataRetentionPolicy - Actualizar una política de retención de datos: actualiza una sola política de retención de datos
updateDocument - Actualizar un documento: actualiza un solo documento, solo el cuerpo y el título
updateEnvironment - Actualizar un entorno: actualiza un solo entorno, para cambiar el nombre, por ejemplo
updateExecutionPlanFieldsJob - Actualizar un trabajo
updateExecutionPlanJob - Reemplazar un trabajo
updateFile - Actualizar un archivo: Actualizar un archivo, para cambiar el ID del libro de trabajo, por ejemplo
updateGuest - Actualizar un invitado: actualiza a un solo invitado, por ejemplo, para cambiar el nombre o el correo electrónico
updateGuidanceSpace - Actualizar una guía: actualiza una guía con la identificación dada
updateGuideEnvironment - Actualizar una guía: Actualiza una guía
updateJob - Actualizar un trabajo: Actualizar un trabajo
updateMappingProgram - Actualizar un programa de mapeo: Actualiza un programa de mapeo
updateRecords - Actualizar registros: actualiza los registros existentes en una hoja del libro de trabajo
updateRoutine - Actualizar una rutina: Actualiza una rutina
updateRuleMapping - Actualizar una regla de mapeo: actualiza una regla de mapeo en un programa
updateRulesMapping - Actualizar una lista de reglas de mapeo: actualiza una lista de reglas de mapeo en un programa
updateRunbook - Actualizar un libro de ejecución: actualiza un libro de ejecución
updateSheet - Actualizar una hoja: Actualizar hoja
updateSpace - Actualizar un espacio: Actualizar un espacio, para cambiar el nombre por ejemplo
updateUser - Actualizar un usuario: Actualiza un usuario
updateView - Actualizar una vista: actualiza una sola vista
uploadFile - Subir un archivo: Subir un archivo
upsertSecret - Insertar un secreto: Insertar o actualizar un secreto por nombre para el entorno o el espacio
validateSheet - Validar una hoja: activa los ganchos de datos y la validación para que se ejecuten en una hoja

Flatfile MCP Server

Integrations