Conecta Airtable a tu agente de IA

Métodos de autenticación

• OAuth 2.0
• Clave de API

Abre la consola local, selecciona un proveedor y configura sus credenciales. Los proveedores OAuth requieren una aplicación OAuth que registres en ese servicio.

Qué comprobar en este conector

Este ejemplo lista las bases accesibles para la conexión de Airtable. Confirma la cuenta seleccionada y el acceso concedido a las bases. Listar bases no verifica el permiso para modificar sus registros.

Inspecciona la acción antes de invocarla

Objetivo del ejemplo

Lista las bases de Airtable accesibles para la conexión.

Ámbitos requeridos por la acción

• schema.bases:read

Lee el esquema de tu instancia en ejecución. Comprueba los datos de entrada requeridos, los permisos y la conexión de la cuenta antes de ejecutar.

curl -s http://localhost:3000/v1/actions/airtable.list_bases

Tras conectar una cuenta, adapta los datos de entrada del ejemplo a tus recursos. Añade un token Bearer del entorno de ejecución si su autenticación está habilitada.

curl -s -X POST \
  http://localhost:3000/v1/actions/airtable.list_bases \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

Lee el resultado

Las respuestas HTTP del entorno usan success, message, data y meta. Inspecciona success y el esquema de salida de la acción, no solo el estado HTTP. Cuando los metadatos de ejecución incluyan executionId, úsalo para localizar el registro correspondiente con datos sensibles ocultos. El ejemplo siguiente ilustra la estructura de la respuesta; no es un resultado de la API en vivo.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Si falla la llamada

• Si falla la autenticación, comprueba el endpoint y el tipo de credencial: el acceso de administración protege /api; un token Bearer del entorno autoriza /v1 y /mcp. Una clave de API del proveedor no es un token del entorno de ejecución.
• Si se deniega un permiso, comprueba los ámbitos requeridos por la acción, las reglas de acciones del entorno y las concesiones de conexión. Un token válido puede seguir sin tener permiso para usar la cuenta seleccionada.
• Si faltan resultados o están vacíos, confirma la cuenta conectada y su acceso al recurso solicitado. Una autorización exitosa no concede acceso a todos los espacios de trabajo, canales o documentos.
• Inspecciona el error y el registro de ejecución antes de reintentar. Si una acción modifica datos del proveedor, comprueba si ya terminó; no repitas la solicitud a ciegas.

Próximos pasos

Para los proveedores compatibles, OOMOL gestiona la configuración de la aplicación OAuth y el entorno de ejecución alojado. Tú sigues eligiendo la cuenta y aprobando sus permisos.