Kintone

Kintone MCP는 Kintone 앱의 레코드, 필드, 댓글, 파일 첨부, 프로세스 관리 정보를 AIP 채팅과 에이전트에서 활용할 수 있게 해주는 연동입니다. 업무 데이터 조회, 레코드 업데이트, 첨부 파일 처리, 승인 흐름 확인 등을 자연어로 요청할 수 있습니다.

주요 기능

Kintone 앱 목록과 앱 정보를 조회할 수 있습니다.
앱의 필드 코드, 필드 타입, 폼 레이아웃을 확인할 수 있습니다.
레코드를 조회, 생성, 수정, 삭제할 수 있습니다.
레코드 댓글을 조회하거나 새 댓글을 작성할 수 있습니다.
첨부 파일을 Kintone에 업로드하거나 Kintone 파일을 AIP 파일로 다운로드할 수 있습니다.
프로세스 관리 상태와 액션을 확인하고 레코드 상태를 변경할 수 있습니다.

시작하기 전에

Kintone MCP를 연결하려면 다음 정보가 필요합니다.

Kintone OAuth Client
Kintone Base URL
Client ID
Client Secret
연동할 Kintone 앱과 레코드에 접근할 수 있는 권한

Kintone에서 OAuth Client를 생성할 때 AIP에 표시되는 Callback URL을 Kintone OAuth Client 설정에 등록해야 합니다.

설정 방법

1단계: MCP Integration 추가

MCP Integrations 메뉴에서 Kintone을 선택합니다.

2단계: OAuth Client 정보 입력

Kintone Base URL, Client ID, Client Secret을 입력합니다.

3단계: Kintone 인증

연동을 저장한 뒤 Kintone 계정으로 인증을 진행합니다. 인증이 완료되면 AIP에서 Kintone 앱과 레코드에 접근할 수 있습니다.

4단계: 채팅 또는 에이전트에서 사용

채팅이나 에이전트에서 Kintone 앱 이름, 레코드 조건, 수행할 작업을 자연어로 요청합니다.

지원하는 MCP 도구

앱 및 스키마 도구

list_apps

Kintone 앱 목록을 검색하거나 조회합니다.

get_app

앱 ID로 Kintone 앱의 기본 정보를 조회합니다.

get_form_fields

앱의 필드 코드, 타입, 라벨, 옵션, Lookup, Subtable, 파일 필드 정보를 조회합니다.

get_form_layout

앱의 폼 레이아웃을 조회합니다.

get_general_settings

앱 이름, 설명, 아이콘, 테마, 제목 필드 등 일반 설정을 조회합니다.

레코드 관리 도구

get_record

레코드 ID로 단일 레코드를 조회합니다.

get_records

Kintone 쿼리 조건으로 레코드 목록을 조회합니다.

add_records

레코드를 생성합니다.

update_records

레코드 ID 또는 updateKey를 기준으로 레코드를 수정합니다.

delete_records

레코드를 삭제합니다.

프로세스 관리 도구

get_process_management

프로세스 관리 상태, 액션, 담당자 규칙을 조회합니다.

update_statuses

프로세스 관리 액션을 실행하여 레코드 상태를 변경합니다.

update_assignees

현재 프로세스 상태의 담당자를 변경합니다.

댓글 도구

get_comments

레코드의 댓글 목록을 조회합니다.

add_comment

레코드에 댓글을 추가합니다.

파일 도구

upload_file

AIP 파일을 Kintone에 업로드하고 파일 키를 반환합니다.

attach_files_to_record

AIP 파일을 Kintone에 업로드한 뒤 레코드의 파일 필드에 첨부합니다.

download_file

Kintone 첨부 파일을 AIP 파일로 다운로드합니다.

앱 빌더 도구

add_app

Kintone 앱을 생성합니다.

add_form_fields

앱의 폼 설정에 필드를 추가합니다.

update_form_fields

앱의 필드 설정을 수정합니다.

delete_form_fields

앱의 필드 설정을 삭제합니다.

update_form_layout

앱의 폼 레이아웃을 수정합니다.

update_general_settings

앱의 일반 설정을 수정합니다.

deploy_app

앱 설정 변경 사항을 운영 앱에 반영하거나 되돌립니다.

get_app_deploy_status

앱 설정 배포 상태를 조회합니다.

사용 예시

“Kintone 영업관리 앱에서 이번 달 등록된 거래 레코드를 요약해줘.”
“고객 문의 앱에서 상태가 미처리인 레코드를 찾아 담당자별로 정리해줘.”
“이 분석 결과를 Kintone 레코드 댓글로 남겨줘.”
“Kintone 첨부 파일을 다운로드해서 내용을 요약해줘.”

주의사항

레코드 생성, 수정, 삭제, 프로세스 상태 변경은 Kintone 데이터에 직접 영향을 줄 수 있으므로 실행 전에 대상 앱과 조건을 확인하세요.
첨부 파일을 추가할 때는 Kintone의 파일 필드 권한과 앱 권한이 필요합니다.
Kintone 권한이 부족하거나 OAuth 인증이 만료된 경우 작업이 실패할 수 있습니다. 이 경우 MCP Integration에서 인증 상태를 확인하고 다시 인증하세요.

문제 해결

증상	원인	해결 방법
Kintone 인증이 실패합니다	Callback URL이 Kintone OAuth Client에 등록되지 않았거나 Client 정보가 올바르지 않습니다	Kintone OAuth Client의 Callback URL, Client ID, Client Secret을 다시 확인합니다
레코드를 찾을 수 없습니다	앱 권한이 없거나 검색 조건의 필드 코드가 올바르지 않습니다	Kintone 앱 접근 권한과 필드 코드를 확인한 뒤 다시 요청합니다
파일 업로드 또는 다운로드가 실패합니다	파일 필드 권한이 없거나 대상 레코드에 접근할 수 없습니다	Kintone 앱과 레코드 권한, 파일 필드 설정을 확인합니다