Airtable

제공 도구 8

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

• airtable__delete_record파괴적승인 필요

  레코드 1건 삭제 — 되돌릴 수 없다. 삭제 전 airtable__get_record 로 대상이 맞는지 확인하라

• airtable__create_record쓰기

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

• airtable__update_record쓰기

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

• airtable__get_base_schema읽기

  베이스의 테이블·필드(이름/타입/선택지)·뷰 조회. 레코드를 읽거나 쓰기 전에 반드시 먼저 호출해 실제 필드 이름과 select 선택지를 확인하라

• airtable__get_record읽기

  레코드 한 건의 전체 필드 — 목록이 긴 셀을 줄여 보여주므로 본문 전체가 필요할 때 쓴다

• airtable__list_bases읽기

  접근 가능한 Airtable 베이스 목록 — 다른 모든 Airtable 툴에 필요한 base id(app…)를 여기서 확보한다

• airtable__list_records읽기

  테이블의 레코드 목록 — 뷰·정렬·필드 선택 가능. 단순 문자열 검색이면 airtable__search_records 를 쓰라(수식을 대신 만들어 준다)

• airtable__search_records읽기

  지정한 필드들에서 문자열을 찾는다(대소문자 무시, 부분 일치). 수식 이스케이프를 대신 처리하므로 사용자 입력을 그대로 넘겨도 안전하다. search_fields 는 airtable__get_base_schema 로 먼저 확인하라

연동 준비

1. Personal access token 생성 화면 열기 바로가기
2. Scopes 에 schema.bases:read · data.records:read · data.records:write 3종을 추가
3. Access 에서 연동할 베이스(또는 워크스페이스)를 반드시 지정 — 기본값은 접근 없음이라, 지정하지 않으면 연동은 되는데 베이스 목록이 비어 보인다