Airtable

Accede y gestiona bases, tablas y registros de Airtable mediante la API web de Airtable.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Airtable

Un servidor integral del Model Context Protocol (MCP) que proporciona acceso completo a la API web de Airtable, incluyendo funciones empresariales. Este servidor permite a los asistentes de IA crear, gestionar e interactuar con bases, tablas, campos, registros, vistas y webhooks de Airtable.

Funciones

🏗️ Gestión de Bases

  • Listar Bases: Obtener todas las bases accesibles en un espacio de trabajo
  • Obtener Esquema de Base: Recuperar la estructura completa de la base con tablas y campos
  • Eliminar Base: Eliminar bases (solo Enterprise)

📊 Gestión de Tablas

  • Listar Tablas: Obtener todas las tablas en una base
  • Crear Tabla: Crear nuevas tablas con configuraciones completas de campos
  • Actualizar Tabla: Modificar propiedades y metadatos de la tabla
  • Eliminar Tabla: Eliminar tablas (con los permisos adecuados)

🔧 Gestión de Campos

  • Listar Campos: Obtener todos los campos en una tabla
  • Crear Campo: Añadir nuevos campos con más de 25 tipos de campo compatibles
  • Actualizar Campo: Modificar propiedades y opciones de campos existentes
  • Eliminar Campo: Eliminar campos (con consideraciones de datos)

Tipos de Campo Compatibles

  • Campos Básicos: singleLineText, multilineText, email, phoneNumber, richText, url
  • Campos Numéricos: number, currency, percent
  • Campos de Fecha/Hora: date, dateTime, duration
  • Campos de Selección: singleSelect, multipleSelects
  • Campos Interactivos: rating, checkbox
  • Campos Avanzados: formula, rollup, lookup, multipleRecordLinks
  • Campos Especializados: attachment, barcode, button, count, autoNumber

📝 Operaciones de Registros

  • Listar Registros: Recuperación básica de registros
  • Listado Avanzado de Registros: Filtrado completo, ordenación, paginación y selección de campos
  • Obtener Registro: Obtener detalles de un registro individual
  • Crear Registro: Añadir registros individuales
  • Actualizar Registro: Modificar registros existentes
  • Eliminar Registro: Eliminar registros
  • Crear Registros en Lote: Crear múltiples registros de manera eficiente
  • Actualizar Registros en Lote: Actualizar múltiples registros en una sola solicitud
  • Eliminar Registros en Lote: Eliminar múltiples registros de manera eficiente
  • Buscar Registros: Encontrar registros mediante búsqueda basada en campos

👁️ Gestión de Vistas

  • Listar Vistas: Obtener todas las vistas en una tabla
  • Obtener Vista: Recuperar la configuración de la vista
  • Crear Vista: Crear nuevas vistas (cuadrícula, formulario, calendario, galería, kanban, línea de tiempo, gantt)
  • Actualizar Vista: Modificar propiedades, filtros y ordenación de la vista
  • Eliminar Vista: Eliminar vistas

🔔 Gestión de Webhooks

  • Listar Webhooks: Obtener todos los webhooks de una base
  • Crear Webhook: Configurar notificaciones en tiempo real
  • Actualizar Webhook: Modificar la configuración del webhook
  • Eliminar Webhook: Eliminar suscripciones de webhook
  • Obtener Cargas de Webhook: Recuperar el historial de notificaciones del webhook

🏢 Funciones Empresariales (Planes de Escala Empresarial)

  • Gestión de Usuarios: Crear, actualizar y desactivar usuarios
  • Gestión de Espacios de Trabajo: Gestionar acceso y permisos del espacio de trabajo
  • Registros de Auditoría: Crear y recuperar registros de auditoría completos
  • Gestión de Enlaces de Compartir: Controlar el intercambio de bases en toda la organización
  • Gestión de Colaboradores: Añadir/eliminar usuarios de bases y espacios de trabajo
  • Operaciones Masivas: Realizar operaciones por lotes a escala empresarial

Instalación

npm install @loticdigital/airtable-mcp-server

Configuración

Establezca su clave de API de Airtable como variable de entorno:

export AIRTABLE_API_KEY=your_airtable_api_key_here

Uso

Con Claude Desktop

Añada a su configuración de Claude Desktop:

{
  "mcpServers": {
    "airtable": {
      "command": "npx",
      "args": ["@loticdigital/airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "your_airtable_api_key_here"
      }
    }
  }
}

Con MCP Inspector

npx @modelcontextprotocol/inspector npx @loticdigital/airtable-mcp-server

Capacidades de la API

Límites de Tasa y Buenas Prácticas

  • Límite de Tasa: 5 solicitudes por segundo por base
  • Límites de Llamadas a la API:
    • Gratis: 1,000 llamadas por espacio de trabajo al mes
    • Equipo: 100,000 llamadas por espacio de trabajo al mes
    • Negocio/Empresa: Llamadas ilimitadas
  • Paginación: Manejo automático de respuestas paginadas
  • Operaciones por Lote: Procesamiento masivo eficiente para múltiples registros
  • Manejo de Errores: Recuperación integral de errores con retroceso exponencial

Funciones Avanzadas

  • Mapeo de ID Externo: Soporte para operaciones de actualización o inserción (upsert)
  • Validación de Datos: Validación integral de campos
  • Resolución de Conflictos: Manejar actualizaciones concurrentes de manera elegante
  • Seguimiento de Cambios: Monitorear y registrar todas las modificaciones de datos
  • Optimización de Rendimiento: Caché y solicitudes selectivas de campos

Funciones de Seguridad

  • Gestión de Tokens: Manejo seguro de PAT (Token de Acceso Personal)
  • Protección de Datos: Validación y saneamiento de entradas
  • Seguridad Empresarial: Registro de auditoría y soporte de cumplimiento
  • Controles de Acceso: Manejo adecuado de permisos

Ejemplos de Configuración de Campos

Campos Básicos

{
  "name": "Title",
  "type": "singleLineText",
  "description": "Main title field"
}

Campos Numéricos

{
  "name": "Price",
  "type": "currency",
  "options": {
    "precision": 2,
    "symbol": "$"
  }
}

Campos de Selección

{
  "name": "Status",
  "type": "singleSelect",
  "options": {
    "choices": [
      { "name": "Active", "color": "greenBright" },
      { "name": "Pending", "color": "yellowBright" },
      { "name": "Inactive", "color": "redBright" }
    ]
  }
}

Campos Avanzados

{
  "name": "Full Name",
  "type": "formula",
  "options": {
    "formula": "CONCATENATE({First Name}, ' ', {Last Name})"
  }
}

Configuración de Webhook

{
  "notificationUrl": "https://your-server.com/webhook",
  "specification": {
    "options": {
      "filters": {
        "dataTypes": ["tableData"],
        "recordChangeScope": "tblXXXXXXXXXXXXXX"
      }
    }
  }
}

Manejo de Errores

El servidor implementa un manejo integral de errores:

  • 401 No Autorizado: Token inválido o caducado
  • 403 Prohibido: Permisos insuficientes
  • 404 No Encontrado: El recurso no existe
  • 422 Entidad No Procesable: Configuración de campo inválida
  • 429 Demasiadas Solicitudes: Límite de tasa excedido
  • 500 Error Interno del Servidor: Problema del servicio de Airtable

Desarrollo

# Clone the repository
git clone https://github.com/loticdigital/airtable-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run with inspector
npm run inspector

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request).

Licencia

Licencia MIT - consulte el archivo LICENSE para más detalles.

Soporte

Para problemas y preguntas:

Registro de Cambios

v0.6.0 (Última)

  • ✨ Gran Expansión de Funciones: Se añadió soporte integral para la API web de Airtable
  • 🔧 Más de 25 Tipos de Campo: Soporte para todos los tipos de campo de Airtable, incluidos los avanzados
  • 👁️ Gestión de Vistas: Operaciones CRUD completas de vistas
  • 🔔 Soporte de Webhooks: Notificaciones en tiempo real y gestión de webhooks
  • 📊 Operaciones Avanzadas de Registros: Operaciones por lotes, filtrado avanzado, paginación
  • 🏢 Funciones Empresariales: Gestión de usuarios, registros de auditoría, gestión de espacios de trabajo
  • 🛡️ Seguridad Mejorada: Validación integral y manejo de errores
  • ⚡ Rendimiento: Operaciones por lotes optimizadas y estrategias de caché

v0.5.1

  • Gestión básica de tablas y campos
  • Operaciones CRUD simples de registros
  • Soporte limitado de tipos de campo