kintone MCP Server

License: MIT

日本語 | English

kintoneの公式ローカルMCPサーバーです。

インストール
- DXT (Claude Desktop用パッケージ)
- Dockerコンテナイメージ
- npmパッケージ
利用方法
- 設定ファイルのパスの例
- 設定ファイルの内容の例
設定
- 設定オプション一覧
- プロキシ設定
ツール一覧
ドキュメント
制限事項
- レコード操作の制限
- 機能制限
サポート方針
コントリビューション
ライセンス

インストール

DXT (Claude Desktop用パッケージ)

DXTファイルは、Claude Desktopの拡張機能としてインストールできます。

以下の手順でインストールしてください。

リリース一覧にアクセス
最新のリリースから kintone-mcp-server.dxt をダウンロード
Claude Desktopを開く
設定から「デスクトップアプリ」→「拡張機能」のページを開く
ダウンロードした kintone-mcp-server.dxt をClaude Desktopの画面にドラッグ＆ドロップ
インストール確認ダイアログが表示されるので「インストール」を選択
設定ダイアログが表示されるので、必要な情報を入力する
- Kintone Base URL: kintoneのベースURL (例: https://example.cybozu.com)
- Kintone Username: kintoneのユーザー名
- Kintone Password: kintoneのパスワード

Dockerコンテナイメージ

Dockerのインストールが必要です。

以下のコマンドでコンテナを起動できます。

docker run -i --rm \
  -e KINTONE_BASE_URL=https://example.cybozu.com \
  -e KINTONE_USERNAME=(username) \
  -e KINTONE_PASSWORD=(password) \
  ghcr.io/kintone/mcp-server

npmパッケージ

Node.jsのインストールが必要です。

以下のコマンドでインストールできます。

npm install -g @kintone/mcp-server

以下のコマンドでサーバーを起動できます。

kintone-mcp-server \
  --base-url https://example.cybozu.com \
  --username (username) \
  --password (password)

# `--base-url`、`--username`、`--password` は
# 環境変数 `KINTONE_BASE_URL`、`KINTONE_USERNAME`、`KINTONE_PASSWORD` でも指定可能です。

利用方法

DXTファイルをインストールした場合、追加の手順は必要ありません。

その他の利用方法では、設定ファイルを作成する必要があります。設定ファイルの作成方法の詳細は、利用するAIツールのドキュメントを参照してください。

設定ファイルのパスの例

Claude Code: .mcp.json [ref]
Cursor: .cursor/mcp.json [ref]

設定ファイルの内容の例

{
  "mcpServers": {
    "kintone": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KINTONE_BASE_URL",
        "-e",
        "KINTONE_USERNAME",
        "-e",
        "KINTONE_PASSWORD",
        "ghcr.io/kintone/mcp-server:latest"
      ],
      "cwd": "${cwd}",
      "env": {
        "KINTONE_BASE_URL": "https://example.cybozu.com",
        "KINTONE_USERNAME": "username",
        "KINTONE_PASSWORD": "password"
      }
    }
  }
}

設定

設定オプション一覧

コマンドライン引数	環境変数	説明	必須
`--base-url`	`KINTONE_BASE_URL`	kintone環境のベースURL（例: `https://example.cybozu.com`）	✓
`--username`	`KINTONE_USERNAME`	kintoneのログインユーザー名	※1
`--password`	`KINTONE_PASSWORD`	kintoneのログインパスワード	※1
`--api-token`	`KINTONE_API_TOKEN`	APIトークン（カンマ区切りで最大9個まで指定可能）	※1
`--basic-auth-username`	`KINTONE_BASIC_AUTH_USERNAME`	Basic認証のユーザー名	-
`--basic-auth-password`	`KINTONE_BASIC_AUTH_PASSWORD`	Basic認証のパスワード	-
`--pfx-file-path`	`KINTONE_PFX_FILE_PATH`	PFXファイルのパス（クライアント証明書認証用）	-
`--pfx-file-password`	`KINTONE_PFX_FILE_PASSWORD`	PFXファイルのパスワード	-
`--proxy`	`HTTPS_PROXY`	HTTPSプロキシのURL（例: `http://proxy.example.com:8080`）	-

※1: KINTONE_USERNAME & KINTONE_PASSWORD または KINTONE_API_TOKEN のいずれかが必須

注意事項:

クライアント証明書認証を使用する場合、URLのドメインは .s.cybozu.com となります（例: https://example.s.cybozu.com）
パスワード認証とAPIトークン認証を同時に指定した場合、パスワード認証が優先されます
コマンドライン引数と環境変数を同時に指定した場合、コマンドライン引数が優先されます
詳細な認証設定については認証設定ガイドを参照してください

プロキシ設定

企業環境などでプロキシサーバーを経由する必要がある場合は、HTTPS_PROXY 環境変数を設定してください。

export HTTPS_PROXY="http://proxy.example.com:8080"

# 認証が必要な場合
export HTTPS_PROXY="http://username:[email protected]:8080"

ツール一覧

ツール名	説明
`kintone-get-apps`	複数のアプリ情報を取得
`kintone-get-app`	単一アプリの詳細情報を取得
`kintone-get-form-fields`	アプリのフィールド設定を取得
`kintone-get-process-management`	プロセス管理設定を取得
`kintone-get-records`	複数のレコードを取得
`kintone-add-records`	複数のレコードを追加
`kintone-update-records`	複数のレコードを更新
`kintone-delete-records`	複数のレコードを削除
`kintone-update-statuses`	複数のレコードのステータスを更新

ドキュメント

認証設定ガイド - 認証方法の詳細と設定例

制限事項

レコード操作の制限

添付ファイルフィールド: レコード登録更新ツールにおいて、添付ファイルフィールドは指定できません
選択フィールド: ユーザー選択フィールド、組織選択フィールド、グループ選択フィールドは、選択肢を設定している場合のみ登録更新が可能です

その他の制限

ゲストスペースに非対応: ゲストスペース内のアプリにはアクセスできません
動作テスト環境に非対応: アプリの動作テスト環境（アプリ設定を本番環境に反映する前に検証できる環境）は利用できません

サポート方針

kintoneローカルMCPサーバーは、APIサポート窓口の対象外です。

バグ報告・機能要望はIssuesから登録をお願いします。

コントリビューション

Contributing Guide を参照してください。

ライセンス

Licensed under the Apache 2.0.

kintone MCP Server