Airtable

제공 도구 13

발신·파괴적 작업 등 되돌리기 어려운 도구는 실행 전 사용자 승인을 거칩니다.

• airtable__api_destructive파괴적승인 필요

  Airtable destructive 작업 실행 — airtable__describe_operation에서 입력·권한·플랜을 조회한 뒤 공식 필드를 전달한다. ⚠️ 발송·삭제·CSV 동기화·권한 변경은 멤버에게 영향을 주며 이 도구로 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 일괄 생성·수정은 10건까지, PATCH는 performUpsert를 지원한다. 결과: data · meta · 페이지 offset/cursor · 작업 상태.

• airtable__delete_record파괴적승인 필요

  Airtable 레코드 1건 삭제. ⚠️ 이 커넥터로는 되돌릴 수 없다 — 지우기 전에 airtable__get_record 로 대상이 맞는지 본다. 값만 바꾸려면 airtable__update_record. base 는 airtable__list_bases 결과의 id(app…), table 은 airtable__get_base_schema 결과의 id 나 이름, record_id 는 airtable__list_records · airtable__search_records 결과의 id(rec…). 결과: deleted · table · id.

• airtable__api_send발신승인 필요

  Airtable send 작업 실행 — airtable__describe_operation에서 입력·권한·플랜을 조회한 뒤 공식 필드를 전달한다. ⚠️ 발송·삭제·CSV 동기화·권한 변경은 멤버에게 영향을 주며 이 도구로 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 일괄 생성·수정은 10건까지, PATCH는 performUpsert를 지원한다. 결과: data · meta · 페이지 offset/cursor · 작업 상태.

• airtable__api_write쓰기

  Airtable write 작업 실행 — airtable__describe_operation에서 입력·권한·플랜을 조회한 뒤 공식 필드를 전달한다. ⚠️ 발송·삭제·CSV 동기화·권한 변경은 멤버에게 영향을 주며 이 도구로 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 일괄 생성·수정은 10건까지, PATCH는 performUpsert를 지원한다. 결과: data · meta · 페이지 offset/cursor · 작업 상태.

• airtable__create_record쓰기

  레코드 1건 생성. fields 는 {"필드 이름": 값} 객체다. ⚠️ 단일선택/다중선택 필드에 없는 값을 주면 새 선택지가 생성되므로, airtable__get_base_schema 로 기존 선택지를 먼저 확인하고 그중에서 고르라

• airtable__update_record쓰기

  레코드 1건 부분 수정 — 지정한 필드만 바뀌고 나머지는 보존된다. ⚠️ 선택지 자동 생성 주의는 airtable__create_record 와 같다

• airtable__api_read읽기

  Airtable read 작업 실행 — airtable__describe_operation에서 입력·권한·플랜을 조회한 뒤 공식 필드를 전달한다. ⚠️ 발송·삭제·CSV 동기화·권한 변경은 멤버에게 영향을 주며 이 도구로 되돌릴 수 없다. 요청에 대상·본문이 다 있으면 바로 부르고, 아니면 먼저 대화에 보여 준다(승인 카드엔 본문이 없다). 일괄 생성·수정은 10건까지, PATCH는 performUpsert를 지원한다. 결과: data · meta · 페이지 offset/cursor · 작업 상태.

• airtable__describe_operation읽기

  Airtable 공식 API 작업 명세 조회 — 경로·검색 조건·본문의 필수 필드와 권한·위험·페이지·플랜을 확인한다. schema_ref로 참조 스키마를 읽는다. 결과: 작업 id · path/query/body 스키마 · scopes · risk · pagination.

• airtable__get_base_schema읽기

  베이스의 테이블·필드(이름·타입·선택지)·뷰 조회 — 레코드를 읽거나 쓰기 전에 먼저 불러 실제 필드 이름과 select 선택지를 확인한다. 결과: 테이블마다 id · name · description · fields[](name · type · choices) · views.

• airtable__get_record읽기

  레코드 한 건의 전체 필드 — 목록은 긴 셀을 줄여 보여 주므로 전체 값이 필요할 때 쓴다. 결과: id · created_time · fields.

• airtable__list_bases읽기

  접근 가능한 Airtable 베이스 목록 — 다른 모든 Airtable 도구에 필요한 base id(app…)를 여기서 얻는다. 결과: 베이스마다 id · name · permission; 다음 페이지 offset은 첫 metadata 행에서 확인한다.

• airtable__list_records읽기

  테이블의 레코드 목록 — 뷰·정렬·필드 선택 가능. 단순 문자열 검색이면 airtable__search_records(수식을 대신 만든다). 결과: 레코드마다 id(rec…) · created_time · fields (긴 셀은 줄인다, 최대 25건; offset metadata로 다음 페이지 조회).

• airtable__search_records읽기

  지정한 필드들에서 문자열을 찾는다(대소문자 무시, 부분 일치) — 수식 이스케이프를 대신 처리하므로 사용자 입력을 그대로 넘겨도 된다. search_fields 는 airtable__get_base_schema 로 먼저 확인한다. 결과: 레코드마다 id(rec…) · created_time · fields (최대 25건; offset metadata로 다음 페이지 조회).

연동 준비

1. Personal access token(PAT)을 생성하거나 편집합니다. 이 연결은 PAT Bearer 방식이며 OAuth 설정은 바꾸지 않습니다. 바로가기
2. 기본 스코프: schema.bases:read, data.records:read, data.records:write. 코멘트는 data.recordComments:read/write, 스키마 편집은 schema.bases:write를 추가합니다.
3. 베이스·워크스페이스 권한은 필요한 workspacesAndBases:read/write/manage만 추가합니다. 웹훅은 webhook:manage와 구독 데이터 유형에 해당하는 읽기 스코프가 필요합니다.
4. Enterprise·HyperDB는 airtable__describe_operation의 정확한 스코프, 요금제, 관리자 역할 및 기능 활성화가 필요합니다. SCIM은 미지원입니다.
5. Access에서 베이스·워크스페이스를 지정합니다. DB migration으로 기존 토큰의 권한이 늘어나지 않습니다. PAT 권한을 편집·재발급하고 저장된 연결을 갱신·재연결하세요. 사용할 기능에 필요한 권한만 부여합니다.