Kintone Mcp Server

kintone MCP 服务

日本語 | English

kintone 官方本地 MCP 服务。

• 安装
  • MCPB（Claude Desktop 用软件包）
  • Docker 容器镜像
  • npm 软件包
• 使用方法
  • 配置文件路径示例
  • 配置文件内容示例
• 配置
  • 配置选项列表
  • 代理配置
• 工具列表
• 文档
• 使用注意事项
  • kintone-download-file工具的注意事项
• 限制事项
  • 记录操作限制
  • 其他限制
• 故障排除
  • 发生连接错误时
  • 发生身份验证错误时
  • 发生权限错误时
• 支持政策
• 贡献
• 隐私
• 许可证

安装

MCPB（Claude Desktop 用软件包）

MCPB 文件可以作为 Claude Desktop 扩展进行安装。

请按照以下步骤安装。

1. 访问发布列表
2. 下载最新版本中的 kintone-mcp-server.mcpb
3. 打开 Claude Desktop
4. 在设置中打开“桌面应用”→“扩展”页面
5. 将下载的 kintone-mcp-server.mcpb 拖放到 Claude Desktop 窗口中
6. 出现确认安装对话框后，选择“安装”
7. 出现设置对话框后，输入所需信息
   • 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` でも指定可能です。

利用方法

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

その他の利用方法では、設定ファイルを作成する必要があります。 設定ファイルの作成方法の詳細は、利用する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）	-
--attachments-dir	KINTONE_ATTACHMENTS_DIR	ダウンロードしたファイルの保存先	-

※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-form-layout	アプリのフォームレイアウトを取得
kintone-update-form-fields	アプリのフィールド設定を更新
kintone-update-form-layout	アプリのフォームレイアウトを更新
kintone-delete-form-fields	アプリのフィールドを削除
kintone-get-process-management	プロセス管理設定を取得
kintone-get-app-deploy-status	アプリ設定の運用環境への反映状況確認
kintone-get-general-settings	アプリの一般設定を取得
kintone-get-customization	JavaScript / CSSカスタマイズ設定を取得
kintone-add-form-fields	アプリにフィールドを追加
kintone-get-records	複数のレコードを取得
kintone-add-records	複数のレコードを追加
kintone-update-records	複数のレコードを更新
kintone-delete-records	複数のレコードを削除
kintone-update-statuses	複数のレコードのステータスを更新
kintone-get-record-comments	レコードのコメントを取得
kintone-add-record-comment	レコードにコメントを追加
kintone-add-app	動作テスト環境にアプリを作成
kintone-deploy-app	アプリ設定を運用環境へ反映
kintone-update-general-settings	アプリの一般設定を変更
kintone-download-file	添付ファイルフィールドのファイルを保存
kintone-add-space-from-template	テンプレートからスペースを作成
kintone-update-space	スペースの設定を更新
kintone-get-space	スペースの情報を取得
kintone-delete-space	スペースを削除

ドキュメント

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

使用上の注意

kintone-download-fileツールの注意点

• ダウンロードしたファイルは、--attachments-dirまたはKINTONE_ATTACHMENTS_DIRで指定したディレクトリに保存されます。
• --attachments-dirまたはKINTONE_ATTACHMENTS_DIRを指定しない場合はツール実行時にエラーになります。
• --attachments-dirまたはKINTONE_ATTACHMENTS_DIRに存在しないディレクトリを指定した場合は、ディレクトリを新規作成してからそこに保存されます。

制限事項

レコード操作の制限

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

その他の制限

• ゲストスペースに非対応: ゲストスペース内のアプリにはアクセスできません

トラブルシューティング

接続エラーになる場合

• ベースURLが正しいか確認してください（例: https://example.cybozu.com）。
• プロキシ環境下では、HTTPS_PROXY 環境変数を設定してください。
• 一時的に接続できない場合は、数分後に再試行してください。

認証エラーになる場合

• ユーザー名とパスワードが正しいか確認してください。
• ユーザー名・パスワードとAPIトークンを同時に指定していないか確認してください。
  同時指定された場合は、パスワード認証が優先されます。
• クライアント証明書を使用している場合、セキュアアクセス用のドメインを使用していることを確認してください（例: .s.cybozu.com など、利用リージョンに応じます）。

権限エラーになる場合

• 使用しているユーザーまたはAPIトークンに、対象アプリへのアクセス権があるか確認してください。
  （アプリ管理権限やレコード閲覧権限が必要な場合があります）
• ゲストスペース内のアプリにはアクセスできません。
• APIトークンを使用している場合、必要な権限（「閲覧」「追加」「編集」「削除」など）が付与されているか確認してください。

サポート方針

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

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

コントリビューション

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

プライバシー

このMCPサーバーは、kintone REST APIに接続します。
利用地域に応じた公式プライバシーポリシーは、Privacy Policy Reference を参照してください。

ライセンス

Copyright 2025 Cybozu, Inc.

Licensed under the Apache 2.0.