Airtable

Interactúa con la API de Airtable para gestionar bases, tablas y registros.

GitHub
75
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Airtable

Un servidor de Model Context Protocol que proporciona herramientas para interactuar con la API de Airtable. Este servidor permite la gestión programática de bases, tablas, campos y registros de Airtable a través de Claude Desktop u otros clientes MCP.

Este servidor MCP cuenta con una implementación especializada que le permite construir tablas por etapas, aprovechando las capacidades agénticas de Claude y minimizando la tasa de fallos típicamente observada en otros servidores MCP para Airtable al construir tablas complejas. También incluye archivos markdown de prompt del sistema y conocimiento del proyecto para proporcionar orientación adicional al LLM al utilizar proyectos en Claude Desktop.

Requisitos: Node.js

  1. Instala Node.js (versión 18 o superior) y npm desde nodejs.org
  2. Verifica la instalación: 
    node --version
npm --version

⚠️ Importante: Antes de ejecutar, asegúrate de configurar tu clave de API de Airtable

Obtención de una clave de API de Airtable

  1. Inicia sesión en tu cuenta de Airtable en airtable.com
  2. Crea un token de acceso personal en el Builder Hub de Airtable
  3. En la sección de token de acceso personal, selecciona estos alcances:
    • data.records:read
    • data.records:write
    • schema.bases:read
    • schema.bases:write
  4. Selecciona el espacio de trabajo o las bases a las que deseas dar acceso al token de acceso personal
  5. Mantén esta clave segura: la necesitarás para la configuración

Instalación

Método 1: Usando npx (Recomendado)

  1. Navega al directorio de configuración de Claude:

    • Windows: C:\Users\NAME\AppData\Roaming\Claude
    • macOS: ~/Library/Application Support/Claude/

    También puedes encontrar estos directorios dentro de la aplicación Claude Desktop: Claude Desktop > Configuración > Desarrollador > Editar configuración

  2. Crea o edita claude_desktop_config.json:

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

Nota: Para rutas de Windows, usa dobles barras invertidas (\) o barras normales (/).

Método 2: Usando mcp-installer

mcp-installer es un servidor MCP para instalar otros servidores MCP.

  1. Instala mcp-installer
  2. Instala el servidor MCP de Airtable solicitando a Claude Desktop:
Install @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'

Claude instalará el servidor, modificará el archivo de configuración y establecerá la variable de entorno AIRTABLE_API_KEY con tu clave de API de Airtable.

Método 3: Instalación para desarrollo local

Si deseas contribuir o modificar el código, ejecuta esto en tu terminal:

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

# Install dependencies
npm install

# Build the server
npm run build

# Run locally
node build/index.js

Luego modifica el archivo de configuración de Claude Desktop para usar la instalación local:

{
  "mcpServers": {
    "airtable": {
      "command": "node",
      "args": ["path/to/airtable-mcp/build/index.js"],
      "env": {
        "AIRTABLE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Verificación de la instalación

  1. Inicia Claude Desktop
  2. El servidor MCP de Airtable debería aparecer en la sección "Servidores MCP conectados"
  3. Prueba con un comando simple:
List all bases

Características

Operaciones disponibles

Gestión de bases

  • list_bases: Lista todas las bases de Airtable accesibles
  • list_tables: Lista todas las tablas en una base
  • create_table: Crea una nueva tabla con campos
  • update_table: Actualiza el nombre o la descripción de una tabla

Gestión de campos

  • create_field: Añade un nuevo campo a una tabla
  • update_field: Modifica un campo existente

Operaciones de registros

  • list_records: Recupera registros de una tabla
  • create_record: Añade un nuevo registro
  • update_record: Modifica un registro existente
  • delete_record: Elimina un registro
  • search_records: Encuentra registros que coincidan con criterios
  • get_record: Obtiene un solo registro por su ID

Tipos de campo

  • singleLineText: Campo de texto de una línea
  • multilineText: Área de texto multilínea
  • email: Campo de dirección de correo electrónico
  • phoneNumber: Campo de número de teléfono
  • number: Campo numérico con precisión opcional
  • currency: Campo de dinero con símbolo de moneda
  • date: Campo de fecha con opciones de formato
  • singleSelect: Selección única entre opciones
  • multiSelect: Selección múltiple entre opciones

Colores de campo

Colores disponibles para campos de selección:

  • blueBright, redBright, greenBright
  • yellowBright, purpleBright, pinkBright
  • grayBright, cyanBright, orangeBright
  • blueDark1, greenDark1

Contribuciones

¡Damos la bienvenida a contribuciones para mejorar el servidor MCP de Airtable! Así es como puedes contribuir:

  1. Haz un fork del repositorio

  2. Crea una rama de características

    git checkout -b feature/your-feature-name

  3. Realiza tus cambios

    • Sigue el estilo de código existente
    • Añade pruebas si corresponde
    • Actualiza la documentación según sea necesario

  4. Haz commit de tus cambios

    git add .
git commit -m "feat: add your feature description"

  5. Sube los cambios a tu fork

    git push origin feature/your-feature-name

  6. Crea una solicitud de extracción (pull request)

    • Ve a tu fork en GitHub
    • Haz clic en "Nueva solicitud de extracción"
    • Selecciona tu rama de características
    • Describe tus cambios en detalle

Directrices de desarrollo

  • Usa TypeScript para código nuevo
  • Sigue mensajes de commit semánticos
  • Actualiza la documentación para nuevas funciones
  • Añade ejemplos para nueva funcionalidad
  • Prueba tus cambios a fondo

Obteniendo ayuda

  • Abre un issue para errores o solicitudes de funciones
  • Únete a discusiones en issues existentes
  • Haz preguntas en solicitudes de extracción

Tus contribuciones ayudan a mejorar esta herramienta para todos. Ya sea:

  • Añadiendo nuevas funciones
  • Corrigiendo errores
  • Mejorando la documentación
  • Sugiriendo mejoras

¡Agradecemos tu ayuda para hacer que el servidor MCP de Airtable sea más potente y fácil de usar!

Licencia

MIT

Hecho con ❤️ por la comunidad de Airtable MCP