Airtable MCP Server

Airtable MCP 서버

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

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

요구 사항: Node.js

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

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

Airtable API 키 얻기

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

설치

방법 1: npx 사용(권장)

1. Claude 구성 디렉토리로 이동합니다.
   • Windows: C:\Users\NAME\AppData\Roaming\Claude
   • macOS: ~/Library/Application Support/Claude/

   Claude Desktop 앱 내부에서도 다음 디렉토리를 찾을 수 있습니다. Claude Desktop > 설정 > 개발자 > 구성 편집

2. claude_desktop_config.json 생성하거나 편집합니다.

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

방법 2: mcp-installer 사용:

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

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

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

방법 3: 로컬 개발 설치

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

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

설치 확인

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

특징

사용 가능한 작업

기지 관리

• 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 서버 개선을 위한 여러분의 참여를 환영합니다! 참여 방법은 다음과 같습니다.

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

개발 지침

• 새로운 코드에 TypeScript를 사용하세요
• 의미론적 커밋 메시지를 따르세요
• 새로운 기능에 대한 설명서 업데이트
• 새로운 기능에 대한 예를 추가하세요
• 변경 사항을 철저히 테스트하세요

도움 받기

• 버그나 기능 요청에 대한 문제를 열어보세요
• 기존 이슈에 대한 토론에 참여하세요
• 풀 리퀘스트에서 질문하기

여러분의 기여는 이 도구를 모두에게 더 나은 도구로 만드는 데 도움이 됩니다. 예를 들어,

• 새로운 기능 추가
• 버그 수정
• 문서 개선
• 개선 사항 제안

Airtable MCP 서버를 더욱 강력하고 사용하기 편리하게 만드는 데 도움을 주셔서 감사합니다!

특허

MIT

Airtable MCP 커뮤니티에서 ❤️로 제작되었습니다.