airtable-mcp-server

Airtable 데이터베이스에 대한 읽기 및 쓰기 액세스를 제공하는 Model Context Protocol 서버입니다. 이 서버를 통해 LLM은 데이터베이스 스키마를 검사하고 레코드를 읽거나 쓸 수 있습니다.

https://github.com/user-attachments/assets/c8285e76-d0ed-4018-94c7-20535db6c944

설치

1단계: 여기를 클릭하여 Airtable 개인 액세스 토큰을 생성하세요. 세부 정보:

• 이름: 원하는 이름(예: 'Airtable MCP Server Token').

• 범위(Scopes): schema.bases:read, data.records:read를 선택하고, 선택적으로 schema.bases:write, data.records:write, data.recordComments:read, data.recordComments:write를 추가합니다.

• 액세스: 액세스하려는 베이스(bases)를 선택합니다. 확실하지 않은 경우 'Add all resources'를 선택하세요.

토큰을 잘 보관해 두세요. 다음 단계에서 필요합니다. pat123.abc123과 같은 형식(더 길 수 있음)이어야 합니다.

2단계: 선호하는 클라이언트에 따라 아래 지침을 따르세요:

• Claude Desktop

• Cursor

• Cline

Claude Desktop

(권장) 확장 프로그램 브라우저를 통한 설치

1. Claude Desktop을 열고 설정(Settings) → 확장 프로그램(Extensions)으로 이동합니다.

2. 'Browse Extensions'를 클릭하고 'Airtable MCP Server'를 찾습니다.

3. 'Install'을 클릭하고 API 키를 붙여넣습니다.

(고급) 대안: 수동 .mcpb 설치

1. GitHub Actions 기록에서 최신 mcpb 빌드를 찾습니다(가장 상단).

2. 'Artifacts' 섹션에서 airtable-mcp-server-mcpb 파일을 다운로드합니다.

3. .zip 파일의 이름을 .mcpb로 변경합니다.

4. .mcpb 파일을 더블 클릭하여 Claude Desktop으로 엽니다.

5. "Install"을 클릭하고 API 키로 구성합니다.

(고급) 대안: JSON 구성을 통한 설치

1. Node.js를 설치합니다.

2. Claude Desktop을 열고 설정(Settings) → 개발자(Developer)로 이동합니다.

3. "Edit Config"를 클릭하여 claude_desktop_config.json 파일을 엽니다.

4. "mcpServers" 섹션에 다음 구성을 추가하고, pat123.abc123을 본인의 API 키로 바꿉니다:

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

5. 파일을 저장하고 Claude Desktop을 다시 시작합니다.

Cursor

(권장) 원클릭 설치

1. 를 클릭합니다.

2. mcp.json 파일을 편집하여 API 키를 삽입합니다.

(고급) 대안: JSON 구성을 통한 설치

전역(~/.cursor/mcp.json) 또는 프로젝트별(.cursor/mcp.json) 구성 파일을 생성하고, pat123.abc123을 본인의 API 키로 바꿉니다:

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

Cline

(권장) 마켓플레이스를 통한 설치

1. Cline 확장 프로그램에서 "MCP Servers" 아이콘을 클릭합니다.

2. "Airtable"을 검색하고 "Install"을 클릭합니다.

3. 프롬프트에 따라 서버를 설치합니다.

(고급) 대안: JSON 구성을 통한 설치

1. Cline 확장 프로그램에서 "MCP Servers" 아이콘을 클릭합니다.

2. "Installed" 탭을 클릭한 다음 하단의 "Configure MCP Servers" 버튼을 클릭합니다.

3. "mcpServers" 섹션에 다음 구성을 추가하고, pat123.abc123을 본인의 API 키로 바꿉니다:

{
  "mcpServers": {
    "airtable": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "airtable-mcp-server"],
      "env": {
        "AIRTABLE_API_KEY": "pat123.abc123"
      }
    }
  }
}

Related MCP server: MCP TapData Server

구성 요소

도구(Tools)

• list_records

  • 지정된 Airtable 테이블의 레코드를 나열합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • tableId (문자열, 필수): 쿼리할 테이블 ID

    • maxRecords (숫자, 선택): 반환할 최대 레코드 수. 기본값은 100입니다.

    • filterByFormula (문자열, 선택): 레코드를 필터링하기 위한 Airtable 수식

• search_records

  • 특정 텍스트가 포함된 레코드를 검색합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • tableId (문자열, 필수): 쿼리할 테이블 ID

    • searchTerm (문자열, 필수): 레코드에서 검색할 텍스트

    • fieldIds (배열, 선택): 검색할 특정 필드 ID. 제공되지 않으면 모든 텍스트 기반 필드를 검색합니다.

    • maxRecords (숫자, 선택): 반환할 최대 레코드 수. 기본값은 100입니다.

• list_bases

  • 액세스 가능한 모든 Airtable 베이스를 나열합니다.

  • 입력 매개변수 필요 없음

  • 베이스 ID, 이름, 권한 수준을 반환합니다.

• list_tables

  • 특정 베이스의 모든 테이블을 나열합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • detailLevel (문자열, 선택): 테이블에 대해 가져올 세부 정보 수준 (tableIdentifiersOnly, identifiersOnly, 또는 full)

  • 테이블 ID, 이름, 설명, 필드 및 뷰를 (지정된 detailLevel에 따라) 반환합니다.

• describe_table

  • 특정 테이블에 대한 자세한 정보를 가져옵니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • tableId (문자열, 필수): 설명할 테이블 ID

    • detailLevel (문자열, 선택): 테이블에 대해 가져올 세부 정보 수준 (tableIdentifiersOnly, identifiersOnly, 또는 full)

  • list_tables와 동일한 형식을 반환하지만 단일 테이블에 대해서만 수행합니다.

  • 베이스의 모든 테이블 정보를 가져오지 않고 특정 테이블에 대한 세부 정보를 얻는 데 유용합니다.

• 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 배열

• create_table

  • 베이스에 새 테이블을 생성합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • name (문자열, 필수): 새 테이블 이름

    • description (문자열, 선택): 테이블 설명

    • fields (배열, 필수): 필드 정의 배열(이름, 유형, 설명, 옵션)

• 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 (문자열, 선택): 새 필드 설명

• create_comment

  • 레코드에 댓글을 생성합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • tableId (문자열, 필수): 테이블 ID

    • recordId (문자열, 필수): 레코드 ID

    • text (문자열, 필수): 댓글 텍스트

    • parentCommentId (문자열, 선택): 스레드 답글을 위한 상위 댓글 ID

  • ID, 작성자, 생성 시간 및 텍스트가 포함된 생성된 댓글을 반환합니다.

• list_comments

  • 레코드의 댓글을 나열합니다.

  • 입력 매개변수:

    • baseId (문자열, 필수): Airtable 베이스 ID

    • tableId (문자열, 필수): 테이블 ID

    • recordId (문자열, 필수): 레코드 ID

    • pageSize (숫자, 선택): 반환할 댓글 수 (최대 100, 기본값 100)

    • offset (문자열, 선택): 추가 댓글을 가져오기 위한 페이지네이션 오프셋

  • 작성자, 텍스트, 타임스탬프, 반응 및 멘션이 포함된 댓글 배열을 반환합니다.

  • 댓글은 최신순으로 반환됩니다.

HTTP 전송

서버는 원격 MCP 클라이언트와 함께 사용하기 위해 HTTP 모드로 실행할 수도 있습니다:

MCP_TRANSPORT=http PORT=3000 npx airtable-mcp-server

이 명령은 http://localhost:3000/mcp에서 상태 비저장(stateless) HTTP 서버를 시작합니다. 참고: HTTP 전송에는 내장 인증이 없으므로 리버스 프록시 뒤나 보안 환경에서만 사용하십시오.

기여

GitHub에서 풀 리퀘스트를 환영합니다! 시작하려면:

1. Git과 Node.js를 설치합니다.

2. 저장소를 복제합니다.

3. npm install로 종속성을 설치합니다.

4. npm run test를 실행하여 테스트를 수행합니다.

5. npm run build로 빌드합니다.

• npm run build:watch를 사용하여 src/index.ts 편집 후 자동으로 빌드할 수 있습니다. 즉, 저장하고 Claude Desktop을 다시 로드(Ctrl/Cmd+R)하면 변경 사항이 적용됩니다.

릴리스

버전은 시맨틱 버전 관리 사양을 따릅니다.

릴리스 방법:

1. npm version <major | minor | patch>를 사용하여 버전을 올립니다.

2. git push --follow-tags를 실행하여 태그와 함께 푸시합니다.

3. GitHub Actions가 NPM 레지스트리에 게시할 때까지 기다립니다.