Airtable MCP Server

Servidor MCP de Airtable

Un servidor de Protocolo de Contexto de Modelo 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 mediante Claude Desktop u otros clientes MCP.

Este servidor MCP cuenta con una implementación especializada que le permite crear tablas por etapas, aprovechando las capacidades de agente de Claude y minimizando la tasa de fallos que suelen observarse en otros servidores MCP para Airtable al crear tablas complejas. También incluye indicaciones del sistema y archivos Markdown de conocimiento del proyecto para proporcionar orientación adicional al LLM al utilizar proyectos en Claude Desktop.

Requisitos: Node.js

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

⚠️ Importante : antes de ejecutar, asegúrese de configurar su clave API de Airtable

Obtener una clave API de Airtable

1. Inicie sesión en su cuenta de Airtable en airtable.com
2. Crea un token de acceso personal en el Builder Hub de Airtable
3. En la sección Token de acceso personal, seleccione estos ámbitos:
   • datos.registros:leer
   • datos.registros:escribir
   • esquema.bases:leer
   • esquema.bases:escribir
4. Seleccione el espacio de trabajo o las bases a las que desea dar acceso al token de acceso personal
5. Mantenga esta clave segura: la necesitará para la configuración

Instalación

Método 1: Usar npx (recomendado)

1. Navegue hasta el directorio de configuración de Claude:
   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   También puede 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 :

Nota: Para las rutas de Windows, utilice barras invertidas dobles (\) o barras diagonales (/).

Método 2: Usar mcp-installer:

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

1. Instalar mcp-installer
2. Instale el servidor MCP de Airtable solicitando a Claude Desktop:

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

Método 3: Instalación de desarrollo local

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

Luego modifique el archivo de configuración de Claude Desktop para utilizar la instalación local:

Verificación de la instalación

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

Características

Operaciones disponibles

Gestión de bases

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

Gestión de campo

• create_field : Agrega un nuevo campo a una tabla
• update_field : Modificar un campo existente

Operaciones de registro

• list_records : Recuperar registros de una tabla
• create_record : Agregar un nuevo registro
• update_record : Modificar un registro existente
• delete_record : Eliminar un registro
• search_records : Encuentra registros que coincidan con los criterios
• get_record : Obtener un solo registro por su ID

Tipos de campo

• singleLineText : Campo de texto de una sola línea
• multilineText : Área de texto de varias líneas
• 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 : elección única entre opciones
• multiSelect : Múltiples opciones

Colores del campo

Colores disponibles para campos seleccionados:

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

Contribuyendo

Agradecemos sus contribuciones para mejorar el servidor MCP de Airtable. Aquí le mostramos cómo puede contribuir:

1. Bifurcar el repositorio
   • Visita https://github.com/felores/airtable-mcp
   • Haga clic en el botón "Bifurcación" en la parte superior derecha.
   • Clona tu bifurcación localmente:
     git clone https://github.com/your-username/airtable-mcp.git
2. Crear una rama de funciones
   git checkout -b feature/your-feature-name
3. Realice sus cambios
   • Seguir el estilo de código existente
   • Agregue pruebas si corresponde
   • Actualice la documentación según sea necesario
4. Confirme sus cambios
   git add . git commit -m "feat: add your feature description"
5. Empuja hacia tu tenedor
   git push origin feature/your-feature-name
6. Crear una solicitud de extracción
   • Ve a tu bifurcación en GitHub
   • Haga clic en "Nueva solicitud de extracción".
   • Seleccione su rama de funciones
   • Describe tus cambios en detalle

Directrices de desarrollo

• Utilice TypeScript para código nuevo
• Seguir los mensajes de confirmación semánticos
• Actualizar la documentación para nuevas funciones
• Añadir ejemplos de nuevas funcionalidades
• Pruebe sus cambios exhaustivamente

Obtener ayuda

• Abra un problema para errores o solicitudes de funciones
• Únase a las discusiones sobre problemas existentes
• Hacer preguntas en solicitudes de extracción

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

• Añadiendo nuevas funciones
• Corrección de errores
• Mejorar la documentación
• Sugerir mejoras

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

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Hecho con ❤️ por la comunidad Airtable MCP