Automação do Airtable via Rube MCP

Automatize operações do Airtable através do kit de ferramentas Airtable da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o Airtable via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas airtable
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas airtable
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a autenticação do Airtable
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Gerenciar Registros

Quando usar: O usuário deseja criar, ler, atualizar ou excluir registros

Sequência de ferramentas:

1. AIRTABLE_LIST_BASES - Descobrir bases disponíveis [Pré-requisito]
2. AIRTABLE_GET_BASE_SCHEMA - Inspecionar estrutura da tabela [Pré-requisito]
3. AIRTABLE_LIST_RECORDS - Listar/filtrar registros [Opcional]
4. AIRTABLE_CREATE_RECORD / AIRTABLE_CREATE_RECORDS - Criar registros [Opcional]
5. AIRTABLE_UPDATE_RECORD / AIRTABLE_UPDATE_MULTIPLE_RECORDS - Atualizar registros [Opcional]
6. AIRTABLE_DELETE_RECORD / AIRTABLE_DELETE_MULTIPLE_RECORDS - Excluir registros [Opcional]

Parâmetros principais:

• baseId: ID da base (começa com 'app', por exemplo, 'appXXXXXXXXXXXXXX')
• tableIdOrName: ID da tabela (começa com 'tbl') ou nome da tabela
• fields: Mapeamento de objetos de nomes de campos para valores
• recordId: ID do registro (começa com 'rec') para atualizações/exclusões
• filterByFormula: Fórmula do Airtable para filtragem
• typecast: Definir como verdadeiro para conversão automática de tipos

Armadilhas:

• pageSize limitado a 100; usa paginação de offset; alterar filtros entre páginas pode pular/duplicar linhas
• CREATE_RECORDS tem um limite rígido de 10 registros por solicitação; agrupe importações maiores
• Nomes de campos diferenciam MAIÚSCULAS de minúsculas e devem corresponder exatamente ao esquema
• 422 UNKNOWN_FIELD_NAME quando os nomes dos campos estão errados; 403 para problemas de permissão
• INVALID_MULTIPLE_CHOICE_OPTIONS pode exigir typecast=true

2. Pesquisar e Filtrar Registros

Quando usar: O usuário deseja encontrar registros específicos usando fórmulas

Sequência de ferramentas:

1. AIRTABLE_GET_BASE_SCHEMA - Verificar nomes e tipos de campos [Pré-requisito]
2. AIRTABLE_LIST_RECORDS - Consultar com filterByFormula [Obrigatório]
3. AIRTABLE_GET_RECORD - Obter detalhes completos do registro [Opcional]

Parâmetros principais:

• filterByFormula: Fórmula do Airtable (por exemplo, {Status}='Done')
• sort: Matriz de objetos de ordenação
• fields: Matriz de nomes de campos a serem retornados
• maxRecords: Número máximo total de registros em todas as páginas
• offset: Cursor de paginação da resposta anterior

Armadilhas:

• Nomes de campos em fórmulas devem ser envolvidos por {} e corresponder exatamente ao esquema
• Valores de string devem ser entre aspas: {Status}='Active' e não {Status}=Active
• 422 INVALID_FILTER_BY_FORMULA para sintaxe incorreta ou campos inexistentes
• Limite de taxa do Airtable: ~5 solicitações/segundo por base; lide com 429 com Retry-After

3. Gerenciar Campos e Esquema

Quando usar: O usuário deseja criar ou modificar campos de tabela

Sequência de ferramentas:

1. AIRTABLE_GET_BASE_SCHEMA - Inspecionar esquema atual [Pré-requisito]
2. AIRTABLE_CREATE_FIELD - Criar um novo campo [Opcional]
3. AIRTABLE_UPDATE_FIELD - Renomear/descrever um campo [Opcional]
4. AIRTABLE_UPDATE_TABLE - Atualizar metadados da tabela [Opcional]

Parâmetros principais:

• name: Nome do campo
• type: Tipo de campo (singleLineText, number, singleSelect, etc.)
• options: Opções específicas do tipo (escolhas para select, precisão para number)
• description: Descrição do campo

Armadilhas:

• UPDATE_FIELD apenas altera nome/descrição, NÃO tipo/opções; crie um campo substituto e migre
• Campos computados (fórmula, rollup, lookup) não podem ser criados via API
• 422 quando as opções de tipo estão ausentes ou mal formatadas

4. Gerenciar Comentários

Quando usar: O usuário deseja visualizar ou adicionar comentários em registros

Sequência de ferramentas:

1. AIRTABLE_LIST_COMMENTS - Listar comentários em um registro [Obrigatório]

Parâmetros principais:

• baseId: ID da base
• tableIdOrName: Identificador da tabela
• recordId: ID do registro (17 caracteres, começa com 'rec')
• pageSize: Comentários por página (máximo 100)

Armadilhas:

• IDs de registro devem ter exatamente 17 caracteres começando com 'rec'

Padrões Comuns

Sintaxe de Fórmula do Airtable

Comparação:

• {Status}='Done' - Igual a
• {Priority}>1 - Maior que
• {Name}!='' - Não vazio

…