hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Enables programmatic management of Airtable bases, tables, fields, and records, with capabilities for creating and modifying tables, adding and updating fields with various data types, and performing CRUD operations on records.

Airtable MCP 서버

Airtable API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 사용하면 Claude Desktop 또는 다른 MCP 클라이언트를 통해 Airtable 베이스, 테이블, 필드 및 레코드를 프로그래밍 방식으로 관리할 수 있습니다.

이 MCP 서버는 Claude의 에이전트 기능을 활용하여 단계별로 테이블을 구축할 수 있는 특수 구현을 특징으로 하며, 복잡한 테이블을 구축할 때 다른 MCP 서버에서 일반적으로 발생하는 Airtable용 실패율을 최소화합니다. 또한 Claude Desktop에서 프로젝트를 활용할 때 LLM에 대한 추가 지침을 제공하는 시스템 프롬프트 및 프로젝트 지식 마크다운 파일도 포함되어 있습니다.

요구 사항: Node.js

nodejs.org 에서 Node.js(버전 18 이상)와 npm을 설치하세요.
설치 확인:지엑스피1

⚠️ 중요 : 실행하기 전에 Airtable API 키를 설정하세요.

Airtable API 키 얻기

airtable.com 에서 Airtable 계정에 로그인하세요
Airtable의 Builder Hub 에서 개인 액세스 토큰을 생성하세요
개인 액세스 토큰 섹션에서 다음 범위를 선택하세요.
- 데이터.레코드:읽기
- 데이터.레코드:쓰기
- 스키마.베이스:읽기
- schema.bases:write
개인 액세스 토큰에 대한 액세스 권한을 부여하려는 작업 공간 또는 기반을 선택하세요.
이 키를 안전하게 보관하세요. 구성에 필요합니다.

설치

방법 1: npx 사용(권장)

Claude 구성 디렉토리로 이동합니다.
- Windows: C:\Users\NAME\AppData\Roaming\Claude
- macOS: ~/Library/Application Support/Claude/
Claude Desktop 앱 내부에서도 다음 디렉토리를 찾을 수 있습니다. Claude Desktop > 설정 > 개발자 > 구성 편집
claude_desktop_config.json 생성하거나 편집합니다.

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

참고: Windows 경로의 경우 이중 백슬래시(\) 또는 슬래시(/)를 사용하세요.

방법 2: mcp-installer 사용:

mcp-installer는 다른 MCP 서버를 설치하는 MCP 서버입니다.

mcp-installer를 설치하세요
Claude Desktop을 실행하여 Airtable MCP 서버를 설치합니다.

Install @felores/airtable-mcp-server set the environment variable AIRTABLE_API_KEY to 'your_api_key'

Claude는 서버를 설치하고, 구성 파일을 수정하고, 환경 변수 AIRTABLE_API_KEY를 Airtable API 키로 설정합니다.

방법 3: 로컬 개발 설치

코드를 기여하거나 수정하려면 터미널에서 다음을 실행하세요.

# 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

그런 다음 로컬 설치를 사용하도록 Claude Desktop 구성 파일을 수정합니다.

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

설치 확인

Claude Desktop 시작
Airtable MCP 서버는 "연결된 MCP 서버" 섹션에 나열되어야 합니다.
간단한 명령으로 테스트해 보세요:

List all bases

특징

사용 가능한 작업

기지 관리

list_bases : 접근 가능한 모든 Airtable 베이스를 나열합니다.
list_tables : 기본 테이블의 모든 테이블을 나열합니다.
create_table : 필드가 있는 새 테이블을 만듭니다.
update_table : 테이블 이름이나 설명을 업데이트합니다.

현장 관리

create_field : 테이블에 새 필드를 추가합니다.
update_field : 기존 필드 수정

기록 작업

list_records : 테이블에서 레코드를 검색합니다.
create_record : 새로운 레코드를 추가합니다
update_record : 기존 레코드를 수정합니다
delete_record : 레코드 제거
search_records : 기준에 맞는 레코드 찾기
get_record : ID로 단일 레코드를 가져옵니다.

필드 유형

singleLineText : 단일 줄 텍스트 필드
multilineText : 여러 줄 텍스트 영역
email : 이메일 주소 필드
phoneNumber : 전화번호 필드
number : 선택적 정밀도가 있는 숫자 필드
currency : 통화 기호가 있는 화폐 필드
date : 형식 옵션이 있는 날짜 필드
singleSelect : 옵션 중 단일 선택
multiSelect : 옵션에서 여러 선택 항목

필드 색상

선택한 필드에 사용 가능한 색상:

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

기여하다

Airtable MCP 서버 개선을 위한 여러분의 참여를 환영합니다! 참여 방법은 다음과 같습니다.

저장소 포크
- https://github.com/felores/airtable-mcp 를 방문하세요
- 오른쪽 상단의 "포크" 버튼을 클릭하세요
- 포크를 로컬로 복제하세요:
  git clone https://github.com/your-username/airtable-mcp.git
기능 브랜치 만들기
git checkout -b feature/your-feature-name
변경 사항을 만드세요
- 기존 코드 스타일을 따르세요
- 해당되는 경우 테스트를 추가하세요
- 필요에 따라 문서를 업데이트하세요
변경 사항 커밋
git add . git commit -m "feat: add your feature description"
포크로 밀어내세요
git push origin feature/your-feature-name
풀 리퀘스트 만들기
- GitHub에서 포크로 이동하세요
- "새로운 풀 리퀘스트"를 클릭하세요
- 기능 브랜치를 선택하세요
- 변경 사항을 자세히 설명하세요