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アプリとレコード権限、ファイルフィールド設定を確認します