kintone API

kintone APIアップデート履歴
/img/top/icon_ai_kintone.svgのアイコン

AI

戻る

kintone MCPサーバーのクイックスタート

著者名：Jiae（ サイボウズ株式会社 (External link) ）

目次

はじめに

固定リンクがコピーされました

kintone MCPサーバーを使えば、Claude Desktopから自然言語でkintoneを操作できます。
本記事では、kintone MCPサーバーのインストールから最初の動作確認までを、最短で完了する手順を紹介します。

kintone MCPサーバーとは？

固定リンクがコピーされました

MCP（Model Context Protocol）は、AIが外部ツールを操作するための標準プロトコルです。
kintone MCPサーバーを使うと、Claude DesktopなどのAIクライアントから、kintoneのレコード取得・追加・更新・削除などの操作を、プロンプトだけで実行できます。
詳しくは次の記事を参照してください。
kintone MCPサーバー

用意するもの

固定リンクがコピーされました

始める前に、以下の2点を確認してください。

1. kintone環境

APIを実行できるkintone環境が必要です。
お持ちでない方は、次のページから開発者ライセンス（無料）を取得してください。
kintone開発者ライセンス

接続にはkintoneの認証情報が必要です。
本記事では、検証・学習目的のため、すぐに試せるパスワード認証（ユーザー名 + パスワード）を使います。

2. Claude Desktop

Anthropic社のデスクトップアプリです。
次のページからダウンロードし、インストールしてください。
Claude for Desktopをダウンロード (External link)

kintone MCPサーバーのインストール手順

固定リンクがコピーされました

kintone MCPサーバーのインストール手順を紹介します。
MCPBは、Claude Desktopの拡張機能パッケージです。
ドラッグ＆ドロップだけでインストールできます。

1. MCPBファイルをダウンロードする

固定リンクがコピーされました

次のページの最新のリリースからkintone-mcp-server.mcpbファイルをダウンロードしてください。
kintone/mcp-serverのリリース一覧 (External link)

2. Claude Desktopの「拡張機能」画面を開く

固定リンクがコピーされました

まず、Claude Desktopの設定画面を開きます。
OSによって操作が異なるので、以下の表を参考にしてください。

OS 設定画面の開き方
Mac 左上のメニューバーから「Claude」→「設定」を選択
Windows 左上のハンバーガーメニュー（☰）から「ファイル」→「設定」を選択

設定画面が開いたら、左メニューの「デスクトップアプリ」→「拡張機能」の画面に進みます。

3. MCPBファイルをインストールする

固定リンクがコピーされました

ダウンロードしたkintone-mcp-server.mcpbファイルを、Claude Desktopの画面にドラッグ＆ドロップします。
インストール確認ダイアログが表示されるので「インストール」を選択してください。

caution
警告

初回インストール時、ドラッグ＆ドロップに反応しないことがあります。
ドラッグ＆ドロップがうまくいかない場合は、次の手順で詳細設定からインストールしてください。

  1. 「拡張機能」画面の「詳細設定」ボタンをクリック

  1. 「すべての拡張機能」画面の下にある「拡張機能をインストール」ボタンをクリック

  1. ファイル選択ダイアログが開くので、ダウンロードしたkintone-mcp-server.mcpbファイルを選択
  1. 「Kintone MCP Server」のインストール確認ダイアログが表示されたら、「インストール」ボタンをクリック

4. kintoneの接続情報を入力する

固定リンクがコピーされました

インストールが完了すると、設定ダイアログが表示されます。
以下の情報を入力してください。

項目 入力内容
Kintone Base URL kintoneのベースURL （例：https://sample.cybozu.com）
Username kintoneのユーザー名
Password kintoneのパスワード

caution
警告

Base URLの形式に注意してください。
URLはhttps://sample.cybozu.comの形式で入力してください（末尾スラッシュなし）。
クライアント証明書認証を使用する場合は、ドメインが.s.cybozu.comになります（例：https://sample.s.cybozu.com）。

information

APIトークン認証を使う場合は、Username / Passwordの代わりに、APIトークンの欄にトークン文字列を入力してください。

入力が完了したら、設定を保存してください。
設定を保存したら、kintone MCPサーバーのトグルを有効に切り替えてください。

5. インストール結果を確認する

固定リンクがコピーされました

「デスクトップアプリ」→「拡張機能」の画面に戻り、「コンピューターにインストール済み」の欄に「Kintone MCP Server」が表示されていれば、インストールは成功です。

次の「接続確認」に進んでください。

接続確認

固定リンクがコピーされました

チャット画面に戻り、入力欄の下部にある＋アイコンをクリックします。

「コネクタ」の中に「Kintone MCP Server」が表示されていれば、セットアップは成功です。

動作確認：最初のプロンプトを実行する

固定リンクがコピーされました

接続が確認できたら、実際にkintoneを操作してみましょう。
以下のプロンプトをコピーし、Claude Desktopのチャット画面に貼り付けて実行してください。

1

kintoneのアプリ一覧を教えて。

実行前にClaude Desktopが以下のような確認ダイアログを表示するので、内容を確認して「常に許可」または「一度だけ許可」をクリックします。

以下のようなアプリID・アプリ名・説明が一覧で返ってきます。

応答結果の例：
kintoneの登録アプリ一覧です（全＊件）。

App ID アプリ名 スペース 最終更新日
1 ファイル管理 ID: 2 2025-03-12
2 顧客リスト ID: 2 2025-04-15
5 問い合わせ管理 なし 2025-04-16
... ... ... ...

このような結果が返ってきたら、最初のプロンプトも正常に実行できました🎉！

warning
注意

本番環境で利用する場合は、対象アプリのAPIトークンの権限や「パスワード認証」時のユーザー権限を必要最小限に設定し、AIがアクセスできる範囲を適切に制限してください。

information

AIに許可する操作をアプリ単位で細かく制御したい場合は、APIトークン認証も利用できます。
認証方式の違いや選び方は、以下の記事を参照してください。
kintone MCPサーバーを設定して、AI（Claude）とkintoneを連携してみよう (External link)

うまくいかないとき

固定リンクがコピーされました

kintone MCPサーバーが表示されない

固定リンクがコピーされました

原因 対処法
Claude Desktopが再起動されていない 「Claude」→「再起動」を選択
拡張機能が無効になっている 「デスクトップアプリ」→「拡張機能」で、kintone MCPサーバーが有効になっているか確認
MCPBファイルのバージョンが古い リリース一覧 (External link) から最新版をダウンロードして再インストール

認証エラーが出る

固定リンクがコピーされました

原因 対処法
kintoneのURLが間違っている https://sample.cybozu.comの形式か確認（末尾スラッシュなし）
ユーザー名・パスワードの誤り kintoneに直接ログインできるか確認
APIトークンの権限不足 対象アプリの「レコード閲覧」権限がトークンに付与されているか確認

詳しいトラブルシューティングは、次のGitHubリポジトリを参照してください。
kintone/mcp-server（GitHub） (External link)

その他のインストール方法

固定リンクがコピーされました

CLIを使ってインストールする場合は、次のページを参照してください。
Dockerコンテナ、またはnpmパッケージでインストールする (External link)

まとめ

固定リンクがコピーされました

本記事では、kintone MCPサーバーのインストールから最初の動作確認までの手順を解説しました。

  • インストール： MCPBファイルのドラッグ＆ドロップ、または詳細設定からインストール
  • 接続確認： チャット画面の入力欄の＋アイコンでツール一覧を確認
  • 動作確認：「kintoneのアプリ一覧を教えて」で最初のプロンプトを実行

これでkintone MCPサーバーを利用できるようになったので、さまざまなプロンプトを試してデータ連携の活用を試してみてください。

kintone MCPサーバーを活用したシナリオは次の記事で紹介しています。

kintoneとGaroonのMCPサーバーを使ってみよう

利用可能な操作の最新リストは、GitHubで確認できます。

kintone/mcp-server（GitHub） (External link)

information

本記事は、次の環境で動作を確認しています。

  • kintone：2026年5月版
  • kintoneローカルMCPサーバー：v1.3.13
  • Claude for Desktop： v1.7196.0