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:

Uso con Claude Desktop

Agregue lo siguiente a su claude_desktop_config.json :

Uso con Claude Code

Agregue lo siguiente a su .claude/code/config.json :

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

Uso con cursor

Agregue lo siguiente a su .cursor/mcp.json :

🔧 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