MCP server for kintone サンプル

kintone MCP 服务示例（非官方）

这是一个可用于与 kintone 集成的非 Cybozu 官方、本地 MCP（Model Context Protocol） 服务（示例代码）。

⚠️ 注意：此 MCP 服务为非官方服务
此 MCP 服务并非由 kintone 的提供方 Cybozu 开发或维护，而是个人开发的非官方服务。请自行承担使用风险。Cybozu 官方的本地 MCP 服务已在 https://github.com/kintone/mcp-server 发布和分发。

使用此本地 MCP 服务，可以通过支持 MCP 的桌面应用（MCP 主机），例如 Claude Desktop 应用，查看、更新 kintone 数据，或创建 kintone 应用等。 本服务经过优化，可让大模型顺畅地使用 kintone。

通过 mcpb 文件（以前的扩展名为 dxt）安装到 Claude Desktop 应用的步骤（推荐）

从 https://github.com/r3-yamauchi/kintone-mcp-server/releases 下载最新的 unofficial-kintone-mcp-server-8.1.0.mcpb， 然后在 Claude Desktop 应用的[设置]中，点击[桌面应用] - [扩展程序]。

如果显示“将 .MCPB 或 .DXT 文件拖到此处以进行安装”，请将下载的 unofficial-kintone-mcp-server-8.1.0.mcpb 拖放到此处。

如果没有显示“将 .MCPB 或 .DXT 文件拖到此处以进行安装”，请点击“高级设置”，再点击“安装扩展程序...”，然后选择下载的 unofficial-kintone-mcp-server-8.1.0.mcpb。

请点击“安装”。

输入要连接的 kintone 域名、用户名和密码，然后点击“保存”按钮。

点击显示为“已禁用”的切换开关，将其设为“已启用”，然后关闭设置界面。

打开新聊天界面。 点击工具图标，即可查看已加载的扩展程序（MCP 服务）。 如果「unofficial-kintone-mcp-server」已启用，即可使用。

点击「unofficial-kintone-mcp-server」右侧的「>」，即可查看可用工具。 如果有不想使用的工具，请将其禁用。

不使用 mcpb 文件时的本地安装步骤

1. 要求

• Node.js 20 或更高版本
• pnpm 或 npm

2. 下载源代码

下载位置不限，但建议将其放在仅包含半角字母数字字符且路径中不含空格的位置。

3. 安装依赖项

pnpm install

或者

npm install

4. 编辑 Claude Desktop 应用的配置文件

找到名为 claude_desktop_config.json 的配置文件，并参考以下内容，在此文件的 "mcpServers" 项中添加配置。

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "[あなたが使用するサブドメイン].cybozu.com",
        "KINTONE_USERNAME": "MCP接続で使用するkintoneユーザー名",
        "KINTONE_PASSWORD": "kintoneユーザーのパスワード（平文）"
      },
      "args": [
        "[kintone-mcp-serverを配置したパス]/server.js"
      ]
    }
  }
}

5. 重启 Claude Desktop 应用

保存对 claude_desktop_config.json 的更改后，请完全退出并重启 Claude Desktop 应用。 即使看起来已经退出，应用也可能仍在后台运行；请右键点击常驻图标，然后选择 Quit。

使用方法

1. 确认运行情况

首先试着询问 Claude：“查询 kintone 应用「使用设置的 kintone 用户可访问的应用名称示例」的应用 ID”。 这里输入的 kintone 应用名称必须完全准确。

2. 此 MCP 服务提供的功能列表

关于各工具的注解属性，请参阅 docs/tool-annotations.md。

レコード操作

• get_record: kintoneアプリの1レコードを取得
• search_records: kintoneアプリのレコードを検索
• create_record: kintoneアプリに新しいレコードを作成
• update_record: kintoneアプリの既存レコードを更新
• upsert_record: kintoneアプリの重複禁止フィールドを指定してレコードを作成または更新（Upsert操作）
• add_record_comment: kintoneレコードにコメントを追加
• update_record_status: kintoneレコードのステータスを更新（プロセス管理）
• update_record_assignees: kintoneレコードの作業者を更新（プロセス管理）
• get_record_comments: kintoneレコードのコメントを取得

ファイル操作

• upload_file: kintoneにファイルをアップロード
• download_file: kintoneからファイルをダウンロード（注意: 現在の実装では1MB以上のファイルは正常にダウンロードできない場合があります）

アプリ情報

• get_apps_info: アプリ名（文字列検索）、アプリID（自然数）、アプリコード、スペースIDを組み合わせてkintoneアプリ情報を取得（app_name または app_id は必須）
• get_form_layout: kintoneアプリのフォームレイアウトを取得
• get_form_fields: kintoneアプリのフォームフィールド情報を取得（本番環境のみ、プレビュー環境は get_preview_form_fields を使用）
• get_app_actions: kintoneアプリのアプリアクション設定を取得
• get_app_plugins: kintoneアプリに追加されているプラグインの一覧を取得
• get_process_management: kintoneアプリのプロセス管理設定を取得
• get_app_acl: kintoneアプリのアクセス権限を取得
• get_field_acl: kintoneアプリのフィールドのアクセス権限を取得
• get_record_acl: 指定したレコードのアクセス権限を取得
• evaluate_records_acl: 指定した条件でレコードのアクセス権限を評価
• get_views: kintoneアプリの一覧（ビュー）の設定を取得
• get_reports: kintoneアプリのグラフ設定を取得
• get_notifications: kintoneアプリの通知条件設定を取得
• get_per_record_notifications: kintoneアプリのレコード単位の通知設定を取得
• get_reminder_notifications: 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アプリをスペースに所属させないようにする
• update_app_acl: kintoneアプリのアクセス権限を更新
• update_field_acl: kintoneアプリのフィールドのアクセス権限を更新
• update_views: kintoneアプリの一覧（ビュー）の設定を更新
• update_reports: kintoneアプリのグラフ設定を更新
• update_notifications: kintoneアプリの通知条件設定を更新
• update_per_record_notifications: kintoneアプリのレコード単位の通知設定を更新
• update_reminder_notifications: kintoneアプリのリマインダー通知設定を更新
• update_process_management: kintoneアプリのプロセス管理設定を更新
• update_app_actions: 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への接続に使用されるユーザー名を取得

その他

この MCP server を使用してどういったことが出来るかブログに書いたので読んでみてください。

• kintoneと生成AI(Claude)のちょっとイイ関係
• kintone AIラボ と kintone用 MCP Server の現在地

また、 Webブラウザー版の Claude や ChatGPT から利用できる OAuth をサポートした リモートMCPサーバー のサンプルコードを 別途 こちら で公開しています。

「kintone」はサイボウズ株式会社の登録商標です。

ここに記載している内容は情報提供を目的としており、個別のサポートはできません。 設定内容についてのご質問やご自身の環境で動作しないといったお問い合わせをいただいても対応はできませんので、ご了承ください。