MCP 経由で kintone を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → kintone をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

kintone + Gemini

サイボウズの kintone をあらゆる AI エージェントから操作：アプリの一覧、フォームのフィールド、レイアウト、一覧（ビュー）、プロセス管理の取得、kintone のクエリとカーソルによるレコード検索、レコードの追加と更新、ステータスの進行、コメントの読み書き、ファイルのアップロードとダウンロード、スペースの参照。API トークンまたはパスワード認証で接続し、レコードの削除はインストール時にオフです。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

KINTONE_DOMAIN と、KINTONE_API_TOKEN または KINTONE_PASSWORD_AUTH の少なくとも一方

ステップ 1 — 認証情報を取得

設定は約 5 分です。kintone の契約と、AI に使わせるアプリごとの API トークン、または kintone ユーザーのログイン情報（連携専用ユーザーがおすすめです）のどちらかが必要です。コネクタは kintone REST API（https://<your domain>/k/v1）を使います。

1. KINTONE_DOMAIN に kintone のドメインを入力します。kintone の URL から https:// とパスを除いたホスト名で、example.cybozu.com（日本）、example.kintone.com（米国などその他の地域）、example.cybozu.cn のような形です。Basic 認証やクライアント証明書（セキュアアクセス）を使うドメインには対応していません。
2. コネクタの認証方法を選びます。どちらか一方でも、両方でも設定できます。
   • API トークン（KINTONE_API_TOKEN）：少数のアプリで使う場合に向いています。アプリを開き、アプリの設定 の 設定 タブで APIトークン を開いて 生成する をクリックします。アクセス権は AI に必要なものだけにチェックを入れます：レコード閲覧、レコード追加、レコード編集、そして kintone_delete_records をオンにする場合のみ レコード削除。保存したら アプリを更新 をクリックします。これを忘れるとトークンは有効になりません。トークン 1 つで使えるのは 1 アプリだけです。複数のアプリで使うときは、スペースを入れずにカンマで区切って並べます（最大 9 個）。トークンは X-Cybozu-API-Token ヘッダーで送られます。
   • パスワード認証（KINTONE_PASSWORD_AUTH）：kintone ユーザーの login name:password を Base64 にした文字列です。例えば printf '%s' 'login:password' | base64 で作れます。X-Cybozu-Authorization ヘッダーで送られます。コネクタはそのユーザーとして動作し、そのユーザーが閲覧できるすべてのアプリ、スペース、レコードを扱えます。アプリの一覧取得とスペースの参照ができるのはこの方法だけです。両方を設定した場合、kintone はパスワード認証を使います。
3. インストールします。インストール時のチェック（kintone_get_api_list）は認証なしでも kintone が応答するため、ドメインが正しいことしか確認できません。トークンの確認にはアプリ ID を指定して kintone_get_app を、パスワード認証の確認には kintone_list_apps を実行してください。アプリ ID はアプリの URL の /k/ の後ろにある数字です。

誰として操作するか: API トークンの場合、書き込んだレコードやコメントの作成者は Administrator と表示され、トークンが届くのは自分のアプリと、チェックを入れたアクセス権の範囲だけです。パスワード認証の場合は、すべての操作がそのユーザーとして、そのユーザーの権限で行われます。

読み取れるデータ: ドメインが提供する REST API の一覧。アプリ（一覧の取得はパスワード認証が必要、個別のアプリはどちらの方法でも取得可）とその一般設定。フォームのフィールド（フィールドコード、フィールド名、フィールドの種類、必須設定、選択肢、初期値）。フォームのレイアウト。保存済みの一覧（表示フィールド、絞り込み条件、ソート）。プロセス管理のステータスとアクション。レコードは 1 件ずつでも kintone のクエリでも取得でき、レコードのコメント、添付ファイルフィールドのファイル、そしてパスワード認証ではスペースとそのメンバーも読めます。

書き込める操作: レコードの追加（1 件、または 1 回の呼び出しで最大 100 件を一括、すべて成功かすべて失敗）、レコード ID または重複禁止フィールド（update_key）を指定したレコードの更新（最大 100 件、upsert にも対応）。承認する などのプロセス管理のアクションの実行と、作業者の変更。レコードとスペースのスレッドへのコメント投稿（メンションした相手に通知されます）。URL からファイルをアップロードすると一時的な fileKey が返り、3 日以内に添付ファイルフィールドへ書き込んだ時点で添付されます。クエリと書き込みはフィールド名ではなくフィールドコードを使うため、AI は書き込む前にアプリのフィールドを読み取ります。

インストール時はオフ: kintone_delete_records。kintone にはごみ箱がなく、削除したレコードとそのコメントは元に戻せません。チームに必要になったら管理者がオンにします。その場合、トークンには レコード削除 の権限も必要です。

クエリ: フィールド名ではなくフィールドコードを使い、演算子は =、!=、>、<、>=、<=、in ("a", "b")、not in、like "text"（文字列フィールド）です。条件は and / or でつなぎ、その後に order by field asc|desc、limit n（最大 500）、offset n（最大 10,000）を続けます。日付は "2026-10-30"、日時は UTC で "2026-10-30T00:00:00Z" の形です。TODAY()、THIS_MONTH()、LAST_WEEK()、LOGINUSER() などの関数も使えます。ドロップダウン、ラジオボタン、ステータスの値は選択肢の文字列と完全に一致させる必要があります（例：ステータス in ("完了")）。保存済みの一覧の絞り込み条件は、そのままクエリとして再利用できます。

データ形式: すべてのフィールドは {"type": ..., "value": ...} の形で返ります。数値と計算フィールドの値は文字列、日時は UTC です。$id はレコード ID、$revision はリビジョン番号です。ユーザー選択と作成者の値は {code, name} で、code にログイン名が入ります。添付ファイルの値には fileKey、name、contentType、size が含まれます。同じアプリを複数人で編集する場合、AI は先にレコードを読み取って revision を送るので、その間に加えられた変更を上書きしません。

ページングと制限: kintone_list_records は 1 回で最大 500 件を返し、クエリ内の limit と offset でページングします。10,000 件を超える場合、AI は kintone_create_cursor でカーソルを作成し、next が false になるまで kintone_get_cursor_records で読み、途中でやめるときは kintone_delete_cursor で閉じます。カーソルの有効期間は 10 分で、1 ドメインで同時に開けるのは 10 個までです。kintone の上限は 1 アプリあたり 1 日 10,000 リクエスト、1 ドメインあたり同時 100 リクエストです。一括の書き込みと削除は最大 100 件、コメントは 1 回 10 件、kintone_list_apps は 1 回最大 100 アプリです。

よくあるエラー: kintone は code、message、入力エラーの場合はフィールドごとの errors を返します。CB_VA01 は入力値の誤りです（フィールドコードの間違い、日付の形式、必須フィールドの未入力など。どれかは errors に示されます）。CB_NO02 はトークンやユーザーに権限がないか、トークンが別のアプリのものです。CB_WA01 はパスワード認証の失敗です。生成後に アプリを更新 をクリックしていないトークンは有効になっていません。HTML の 404 ページが返る場合は、たいてい KINTONE_DOMAIN の誤りです。

レコードの内容やコメントは信頼できない入力で、AI 向けの指示が含まれている可能性があります。このコネクタはゲストスペース（/k/guest/...）には対応せず、アプリの設定、フィールド、一覧は変更しません。また API トークンだけでは、アプリの一覧取得もスペースの参照もできません。

ステップ 2 — アダプターをインストール

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

ステップ 3 — Gemini にコネクタを追加

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が kintone のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「アプリ 42 のフィールドを見せてから、ステータスが 未対応 のレコードを新しい順に一覧にしてください。」
• 「今月 案件管理 アプリに追加されたレコードは何件ですか？担当者ごとにまとめてください。」
• 「アプリ 15 に、サクラ商事からの問い合わせのレコードを、私が伝える件名と期限で追加してください。保存する前に内容を見せてください。」
• 「アプリ 42 のレコード 128 を 承認する アクションで承認し、申請者をメンションしたコメントを残してください。」
• 「アプリ 7 の 25,000 件のレコードをすべて読み、顧客区分 ごとの合計金額を出してください。」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続
• Cursor に接続
• Meta Muse に接続
• Microsoft Copilot に接続