概览
What is Kintone MCP Server?
An official local MCP (Model Context Protocol) server for kintone, enabling AI assistants to interact with kintone apps, records, spaces, and settings via a set of tools.
How to use Kintone MCP Server?
Install via MCPB (Claude Desktop extension), Docker container, or npm package. Configure with command-line arguments or environment variables: KINTONE_BASE_URL, KINTONE_USERNAME/KINTONE_PASSWORD or KINTONE_API_TOKEN, and optional KINTONE_BASIC_AUTH_USERNAME, KINTONE_BASIC_AUTH_PASSWORD, KINTONE_PFX_FILE_PATH, KINTONE_PFX_FILE_PASSWORD, HTTPS_PROXY, KINTONE_ATTACHMENTS_DIR. Use in AI tools like Claude Code or Cursor by referencing a JSON configuration file (e.g., .mcp.json or .cursor/mcp.json).
Key features of Kintone MCP Server
- Manage kintone apps: get, create, deploy, update fields and layouts.
- Record operations: get, add, update, delete records and statuses.
- Comment handling: get and add comments on records.
- File attachment download: save files to a specified directory.
- Space management: create, update, and get space information.
- Support for password, API token, and client certificate authentication.
Use cases of Kintone MCP Server
- Automate app creation and field configuration via AI assistant.
- Bulk record operations (add, update, delete) based on natural language instructions.
- Download files attached to records for local processing.
- Manage app deployment status and general settings without the kintone UI.
- Integrate kintone workflows with AI-driven conversation agents.
FAQ from Kintone MCP Server
How do I install the Kintone MCP Server?
You can install via MCPB (drag and drop into Claude Desktop), Docker (docker run ... ghcr.io/kintone/mcp-server), or npm (npm install -g @kintone/mcp-server).
What authentication methods are supported?
Password authentication (username + password) or API token (up to 9 tokens, comma-separated). Client certificate authentication is also supported by specifying a PFX file path and password.
Can I use the Kintone MCP Server behind a proxy?
Yes, set the HTTPS_PROXY environment variable (e.g., http://proxy.example.com:8080). Authenticated proxies are also supported.
Are there any limitations?
Guest space apps are not accessible. Attachment fields cannot be used in record add/update tools. User/org/group selection fields require pre-set choices. The kintone-download-file tool requires the KINTONE_ATTACHMENTS_DIR environment variable.
What if I get connection or authentication errors?
Check the base URL format (e.g., https://example.cybozu.com). Verify credentials and ensure no conflict between password and API token. For client certificates, use the secure domain (e.g., .s.cybozu.com). If using a proxy, set HTTPS_PROXY.
