MCP server for kintone 샘플

이것은 kintone 과의 연계 목적으로 사용할 수 있는 Model Context Protocol(MCP) 서버의 간이한 샘플입니다.생성 AI를 이용해 자동 작성한 것을 현재 상태로 제공합니다.

이 MCP 서버를 사용하면 Claude Desktop 앱에서 kintone 데이터에 액세스하고 업데이트할 수 있습니다.

클라이언트로 Claude 데스크톱 앱을 사용하는 경우 Claude Pro 플랜 구독이 필요합니다.

사용법

1. 소스 코드 다운로드

다운로드처는 어디에서도 상관없습니다만, 반각 영수만으로 구성된, 사이에 스페이스를 포함하지 않는 패스에 넣는 것이 좋다고 생각합니다.

2. Node.js 설치

Node.js 18 이상을 사용하십시오.

3. npm install

4. Claude Desktop 앱의 설정 파일 편집

claude_desktop_config.json 이라는 설정 파일을 찾아, 이하를 참고로, 이 파일의 "mcpServers" 의 항에 설정을 추가해 주세요.

5. Claude Desktop 앱을 다시 시작합니다.

claude_desktop_config.json에 대한 변경사항을 저장한 후 Claude Desktop 앱을 한 번 종료한 후 다시 시작해 보세요.

6. 동작 확인

먼저 Claude에 "kintone 앱 "설정한 kintone 사용자로 액세스할 수 있는 앱 이름의 예"의 앱 ID를 조사해"라고 물어보세요. 여기서 입력하는 kintone 앱 이름은 한마디 정확하게 지정해야 합니다.

7. 이 MCP 서버가 제공하는 기능 목록

각 도구의 주석 속성은 docs/tool-annotations.md 를 참조하십시오.

레코드 조작

• get_record : kintone 앱의 1 레코드 가져 오기
• search_records : kintone 앱의 레코드 검색
• create_record : kintone 앱에 새 레코드 만들기
• update_record : kintone 앱의 기존 레코드 업데이트
• add_record_comment : kintone 레코드에 주석 추가

파일 조작

• upload_file : kintone에 파일 업로드
• download_file : kintone에서 파일 다운로드 (주의 : 현재 구현에서는 1MB 이상의 파일을 성공적으로 다운로드하지 못할 수 있음)

앱 정보

• get_apps_info : 검색 키워드를 지정하여 해당하는 여러 kintone 앱 정보를 얻습니다.
• get_form_layout : kintone 앱의 양식 레이아웃 가져 오기
• get_app_actions : kintone 앱의 앱 동작 설정 얻기
• get_app_plugins : kintone 앱에 추가된 플러그인 목록 가져오기

앱 조작

• create_app : kintone 앱 새로 만들기
• add_fields : kintone 앱에 필드 추가
• update_field : 기존 kintone 필드의 설정 업데이트
• update_form_layout : kintone 앱의 양식 레이아웃 변경
• update_app_settings : 앱의 일반 설정 변경
• deploy_app : kintone 앱의 프로덕션 운영 시작 (운영 환경에 반영)
• get_deploy_status : 앱 설정이 프로덕션 환경에 어떻게 반영되었는지 확인
• move_app_to_space : kintone 앱을 지정된 공간으로 이동
• move_app_from_space : kintone 앱이 공간에 속하지 않도록 합니다.

공간 조작

• get_space : 공간의 일반 정보 취득
• update_space : 공간 설정 업데이트
• update_space_body : 공백 본문 업데이트
• get_space_members : 공간 멤버 목록을 가져옵니다.
• update_space_members : 공간 멤버 업데이트
• add_thread : 공간에 스레드 추가
• update_thread : 스레드 업데이트
• add_thread_comment : 스레드에 주석 추가
• add_guests : 게스트 사용자 추가
• update_space_guests : 공간 게스트 멤버 업데이트

사용자 그룹 정보

• get_users : kintone의 사용자 정보 얻기
• get_groups : kintone의 그룹 정보 얻기
• get_group_users : 지정된 그룹에 속한 사용자 목록을 가져옵니다.

kintone 연결 정보

• get_kintone_domain : kintone의 접속처 도메인을 취득
• get_kintone_username : kintone에 연결하는 데 사용되는 사용자 이름 가져 오기

8. 기타

그 외에, 이 MCP server 를 사용해 무슨 일을 할 수 있을까 블로그 에 썼으므로 읽어 보세요.

그 밖에도 kintone용의 MCP server 를 공개되고 있는 분이 있기 때문에, 참고로 하면서 스스로 오리지날의 MCP server 를 만들어 보는 것도 좋을지도 모릅니다.

「kintone」은 사이보즈 주식회사의 등록상표입니다.

여기에 기재하고 있는 내용은 정보 제공을 목적으로 하고 있어 개별의 서포트는 할 수 없습니다.