Airtable

Interaja com a API do Airtable para gerenciar bases, tabelas e registros.

GitHub
75
Experimente este MCPPatrocinado

Documentação

Airtable MCP Server

Um servidor Model Context Protocol que fornece ferramentas para interagir com a API do Airtable. Este servidor permite o gerenciamento programático de bases, tabelas, campos e registros do Airtable por meio do Claude Desktop ou outros clientes MCP.

Este servidor MCP possui uma implementação especializada que permite construir tabelas em etapas, aproveitando as capacidades agênticas do Claude e minimizando a taxa de falhas tipicamente vista em outros servidores MCP para Airtable ao construir tabelas complexas. Ele também inclui arquivos markdown de prompt de sistema e conhecimento do projeto para fornecer orientação adicional ao LLM ao usar projetos no Claude Desktop.

Requisitos: Node.js

  1. Instale o Node.js (versão 18 ou superior) e o npm a partir de nodejs.org
  2. Verifique a instalação: 
    node --version
npm --version

⚠️ Importante: Antes de executar, certifique-se de configurar sua chave de API do Airtable

Obtendo uma Chave de API do Airtable

  1. Faça login na sua conta Airtable em airtable.com
  2. Crie um token de acesso pessoal no Builder Hub do Airtable
  3. Na seção de token de acesso pessoal, selecione estes escopos:
    • data.records:read
    • data.records:write
    • schema.bases:read
    • schema.bases:write
  4. Selecione o workspace ou as bases às quais deseja dar acesso ao token de acesso pessoal
  5. Mantenha esta chave segura - você precisará dela para a configuração

Instalação

Método 1: Usando npx (Recomendado)

  1. Navegue até o diretório de configuração do Claude:

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

    Você também pode encontrar esses diretórios dentro do aplicativo Claude Desktop: Claude Desktop > Configurações > Desenvolvedor > Editar Config

  2. Crie ou edite claude_desktop_config.json:

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

Nota: Para caminhos do Windows, use barras invertidas duplas (\) ou barras normais (/).

Método 2: Usando mcp-installer:

mcp-installer é um servidor MCP para instalar outros servidores MCP.

  1. Instale o mcp-installer
  2. Instale o servidor MCP Airtable solicitando ao Claude Desktop:
Install @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'

O Claude instalará o servidor, modificará o arquivo de configuração e definirá a variável de ambiente AIRTABLE_API_KEY para sua chave de API do Airtable.

Método 3: Instalação para Desenvolvimento Local

Se você quiser contribuir ou modificar o código, execute isto no seu 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

Em seguida, modifique o arquivo de configuração do Claude Desktop para usar a instalação local:

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

Verificando a Instalação

  1. Inicie o Claude Desktop
  2. O servidor MCP Airtable deve estar listado na seção "Servidores MCP Conectados"
  3. Teste com um comando simples:
List all bases

Recursos

Operações Disponíveis

Gerenciamento de Bases

  • list_bases: Listar todas as bases Airtable acessíveis
  • list_tables: Listar todas as tabelas em uma base
  • create_table: Criar uma nova tabela com campos
  • update_table: Atualizar o nome ou a descrição de uma tabela

Gerenciamento de Campos

  • create_field: Adicionar um novo campo a uma tabela
  • update_field: Modificar um campo existente

Operações de Registros

  • list_records: Recuperar registros de uma tabela
  • create_record: Adicionar um novo registro
  • update_record: Modificar um registro existente
  • delete_record: Remover um registro
  • search_records: Encontrar registros que correspondam aos critérios
  • get_record: Obter um único registro pelo seu ID

Tipos de Campo

  • singleLineText: Campo de texto de linha única
  • multilineText: Área de texto multilinha
  • email: Campo de endereço de e-mail
  • phoneNumber: Campo de número de telefone
  • number: Campo numérico com precisão opcional
  • currency: Campo monetário com símbolo de moeda
  • date: Campo de data com opções de formato
  • singleSelect: Escolha única entre opções
  • multiSelect: Múltiplas escolhas entre opções

Cores de Campo

Cores disponíveis para campos de seleção:

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

Contribuindo

Recebemos contribuições para melhorar o servidor MCP Airtable! Veja como você pode contribuir:

  1. Faça um fork do repositório

  2. Crie um branch de funcionalidade

    git checkout -b feature/your-feature-name

  3. Faça suas alterações

    • Siga o estilo de código existente
    • Adicione testes se aplicável
    • Atualize a documentação conforme necessário

  4. Faça commit das suas alterações

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

  5. Envie para o seu fork

    git push origin feature/your-feature-name

  6. Crie um Pull Request

    • Vá para o seu fork no GitHub
    • Clique em "New Pull Request"
    • Selecione seu branch de funcionalidade
    • Descreva suas alterações em detalhes

Diretrizes de Desenvolvimento

  • Use TypeScript para código novo
  • Siga mensagens de commit semânticas
  • Atualize a documentação para novos recursos
  • Adicione exemplos para novas funcionalidades
  • Teste suas alterações minuciosamente

Obtendo Ajuda

  • Abra uma issue para bugs ou solicitações de recursos
  • Participe das discussões em issues existentes
  • Faça perguntas em pull requests

Suas contribuições ajudam a tornar esta ferramenta melhor para todos. Seja:

  • Adicionando novos recursos
  • Corrigindo bugs
  • Melhorando a documentação
  • Sugerindo melhorias

Agradecemos sua ajuda para tornar o servidor MCP Airtable mais poderoso e fácil de usar!

Licença

MIT

Feito com ❤️ pela comunidade Airtable MCP