MCP 문서 관리

메뉴

홈
문서 목록
관리자 로그인

문서 정보

최종 수정일:
2025-05-13 15:55
태그:
#MCP #커뮤니티 #서버 #데이터베이스

링크된 문서

역링크

Airtable

Airtable

Airtable MCP 서버는 AI 시스템이 Airtable 데이터베이스와 원활하게 상호작용할 수 있게 해주는 Model Context Protocol(MCP) 서버입니다. 이 서버는 AI 어시스턴트가 데이터베이스 스키마를 검사하고, 레코드를 읽고 쓸 수 있는 기능을 제공합니다. 사용자는 이를 통해 Airtable 베이스, 테이블, 필드 및 레코드를 관리할 수 있습니다.

특징

  • Airtable 베이스와 테이블에 대한 읽기 및 쓰기 액세스 제공
  • 데이터베이스 스키마 검사 기능
  • 레코드 검색, 생성, 업데이트 및 삭제 기능
  • 테이블 및 필드 관리 기능
  • Claude Desktop 및 기타 MCP 클라이언트와 통합 가능
  • Airtable API를 활용한 데이터 관리 자동화

제공 도구

데이터 쿼리 및 조작

  • list_records: 지정된 Airtable 테이블에서 레코드 목록 조회
  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 조회할 테이블 ID

  • 선택적 매개변수:

    • maxRecords: 반환할 최대 레코드 수 (기본값: 100)
    • filterByFormula: 레코드 필터링을 위한 Airtable 공식

  • search_records: 특정 텍스트가 포함된 레코드 검색

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 검색할 테이블 ID
    • searchTerm: 레코드에서 검색할 텍스트

  • 선택적 매개변수:

    • fieldIds: 검색할 특정 필드 ID 배열. 제공되지 않으면 모든 텍스트 기반 필드에서 검색
    • maxRecords: 반환할 최대 레코드 수 (기본값: 100)

  • get_record: ID로 특정 레코드 조회

  • 필수 매개변수:

    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • recordId: 조회할 레코드 ID

  • create_record: 테이블에 새 레코드 생성

  • 필수 매개변수:

    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • fields: 새 레코드의 필드와 값

  • update_records: 테이블의 하나 이상의 레코드 업데이트

  • 필수 매개변수:

    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • records: 레코드 ID와 업데이트할 필드를 포함하는 객체 배열

  • delete_records: 테이블에서 하나 이상의 레코드 삭제

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • recordIds: 삭제할 레코드 ID 배열

데이터베이스 관리

  • list_bases: 접근 가능한 모든 Airtable 베이스 목록 조회
  • 필수 매개변수 없음

  • 베이스 ID, 이름 및 권한 수준 반환

  • list_tables: 특정 베이스의 모든 테이블 목록 조회

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
  • 선택적 매개변수:
    • detailLevel: 테이블에 대한 상세 정보 수준 (tableIdentifiersOnly, identifiersOnly, full)

  • 테이블 ID, 이름, 설명, 필드 및 뷰 반환 (지정된 상세 수준에 따라)

  • describe_table: 특정 테이블에 대한 상세 정보 조회

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 설명할 테이블 ID
  • 선택적 매개변수:
    • detailLevel: 테이블에 대한 상세 정보 수준 (tableIdentifiersOnly, identifiersOnly, full)

  • list_tables와 동일한 형식으로 단일 테이블에 대한 정보 반환

  • create_table: 베이스에 새 테이블 생성

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • name: 새 테이블 이름
    • fields: 필드 정의 배열 (이름, 유형, 설명, 옵션)

  • 선택적 매개변수:

    • description: 테이블 설명

  • update_table: 테이블 이름 또는 설명 업데이트

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID

  • 선택적 매개변수:

    • name: 테이블의 새 이름
    • description: 테이블의 새 설명

  • create_field: 테이블에 새 필드 생성

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • name: 새 필드 이름
    • type: 필드 유형

  • 선택적 매개변수:

    • description: 필드 설명
    • options: 필드별 옵션

  • update_field: 필드 이름 또는 설명 업데이트

  • 필수 매개변수:
    • baseId: Airtable 베이스 ID
    • tableId: 테이블 ID
    • fieldId: 필드 ID
  • 선택적 매개변수:
    • name: 필드의 새 이름
    • description: 필드의 새 설명

리소스

서버는 Airtable 베이스 및 테이블에 대한 스키마 정보를 제공합니다:

  • 테이블 스키마 (airtable://<baseId>/<tableId>/schema): 각 테이블에 대한 JSON 스키마 정보
  • 포함 정보:
    • 베이스 ID 및 테이블 ID
    • 테이블 이름 및 설명
    • 기본 필드 ID
    • 필드 정의 (ID, 이름, 유형, 설명, 옵션)
    • 뷰 정의 (ID, 이름, 유형)
  • Airtable의 메타데이터 API에서 자동으로 발견됨

설치 및 사용 방법

Claude Desktop 앱에서 사용하기

Claude Desktop의 claude_desktop_config.json 파일에 다음 구성을 "mcpServers" 섹션에 추가합니다:

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

your_api_key_here를 Airtable 개인 액세스 토큰으로 대체합니다. 토큰은 최소한 schema.bases:read와 data.records:read 권한이 있어야 하며, 선택적으로 해당 쓰기 권한도 필요합니다.

VS Code에서 사용하기

VSCode에서 MCP 서버를 사용하려면:

  1. .vscode/mcp.json 파일을 생성하거나 편집합니다.
  2. 다음 구성을 추가합니다:
{
  "servers": {
    "airtable-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "your_api_key_here"
      }
    }
  }
}
  1. 명령 팔레트를 열고(Ctrl+Shift+P 또는 Mac에서 Cmd+Shift+P) "MCP: Start Server" 명령을 실행하여 목록에서 "airtable-mcp"를 선택합니다.
  2. VSCode의 챗 뷰를 열고 에이전트 모드로 전환하여 airtable-mcp-server 도구를 사용할 수 있는지 확인합니다.

사용 예시

다음은 서버 사용 예시입니다:

모든 베이스 목록 조회

모든 Airtable 베이스를 나열해 주세요.

테이블의 레코드 목록 조회

"app123456"에 있는 "tbl789" 테이블의 레코드를 조회해 주세요.

레코드 검색

"app123456"의 "고객" 테이블에서 "서울"이 포함된 레코드를 찾아주세요.

새 레코드 생성

"app123456"의 "프로젝트" 테이블에 "이름"은 "신규 프로젝트", "시작일"은 "2025-05-13", "담당자"는 "홍길동"인 새로운 레코드를 생성해 주세요.

보안 고려사항

개인 액세스 토큰(PAT)은 Airtable 계정에 대한 광범위한 액세스 권한을 제공할 수 있으므로 안전하게 보관하는 것이 중요합니다. 권한이 제한된 토큰을 사용하고, 필요한 경우에만 쓰기 권한을 부여하는 것이 좋습니다.

라이선스

이 프로젝트는 오픈 소스로 제공되며, GitHub에서 기여를 환영합니다.

연결된 구성 요소