kintone/mcp-server

[![ci][ci-badge]][ci-url]
[![npm version][npm-badge]][npm-url]
[![License: Apache 2.0][license-badge]][license-url]
[![Install MCP Server][cursor-badge]][cursor-url]
[ci-badge]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml/badge.svg
[ci-url]: https://github.com/kintone/mcp-server/actions/workflows/ci.yaml
[npm-badge]: https://badge.fury.io/js/@kintone%2Fmcp-server.svg?icon=si%3Anpm
[npm-url]: https://badge.fury.io/js/@kintone%2Fmcp-server
[license-badge]: https://img.shields.io/badge/License-Apache_2.0-blue.svg
[license-url]: LICENSE
[cursor-badge]: https://cursor.com/deeplink/mcp-install-dark.svg
[cursor-url]: https://cursor.com/en/install-mcp?name=kintone&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiZW52Ijp7IktJTlRPTkVfQkFTRV9VUkwiOiJodHRwczovLyhzdWJkb21haW4pLmN5Ym96dS5jb20iLCJLSU5UT05FX1VTRVJOQU1FIjoiKHVzZXJuYW1lKSIsIktJTlRPTkVfUEFTU1dPUkQiOiIocGFzc3dvcmQpIn0sImFyZ3MiOlsicnVuIiwiLWkiLCItLXJtIiwiLWUiLCJLSU5UT05FX0JBU0VfVVJMIiwiLWUiLCJLSU5UT05FX1VTRVJOQU1FIiwiLWUiLCJLSU5UT05FX1BBU1NXT1JEIiwiZ2hjci5pby9raW50b25lL21jcC1zZXJ2ZXI6bGF0ZXN0Il19
日本語 | 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のインストールが必要です。
以下のコマンドでコンテナを起動できます。
npmパッケージ
Node.jsのインストールが必要です。
以下のコマンドでインストールできます。
以下のコマンドでサーバーを起動できます。
利用方法
MCPBファイルをインストールした場合、追加の手順は必要ありません。
その他の利用方法では、設定ファイルを作成する必要があります。
設定ファイルの作成方法の詳細は、利用するAIツールのドキュメントを参照してください。
設定ファイルのパスの例
- Claude Code: .mcp.json \[ref]
- Cursor: .cursor/mcp.json \[ref]
設定ファイルの内容の例
設定
設定オプション一覧
| コマンドライン引数 | 環境変数 | 説明 | 必須 |
| ----------------------- | ----------------------------- | ---------------------------------------------------------- | ---- |
| --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）