kintone Sample MCP Server

Servidor MCP para kintone de muestra (No oficial)

Este es un servidor local MCP (Model Context Protocol) de muestra (código de ejemplo) no oficial, no desarrollado por Cybozu, que se puede utilizar para integrarse con kintone.

⚠️ Nota: Este servidor MCP no es oficial
Este servidor MCP no está desarrollado ni mantenido por Cybozu, el proveedor de kintone. Es no oficial y desarrollado de forma personal. El uso es bajo su propia responsabilidad. El servidor MCP local oficial de Cybozu se publica y distribuye en https://github.com/kintone/mcp-server.

Con este servidor MCP local, puede consultar y actualizar datos de kintone, así como crear aplicaciones de kintone, desde aplicaciones de escritorio que admiten MCP (hosts MCP), como la aplicación Claude Desktop. Está diseñado para que los LLM puedan manejar kintone sin problemas.

Procedimiento de instalación en la aplicación Claude Desktop mediante el archivo mcpb (anteriormente con extensión dxt) (recomendado)

Descargue el archivo unofficial-kintone-mcp-server-8.1.0.mcpb más reciente desde https://github.com/r3-yamauchi/kintone-mcp-server/releases y haga clic en [Configuración] de la aplicación Claude Desktop, luego en [Aplicaciones de escritorio] - [Extensiones].

Si aparece el mensaje "Arrastre y suelte el archivo .MCPB o .DXT aquí para instalarlo", arrastre y suelte el archivo unofficial-kintone-mcp-server-8.1.0.mcpb descargado.

Si no aparece el mensaje "Arrastre y suelte el archivo .MCPB o .DXT aquí para instalarlo", haga clic en "Configuración avanzada" y luego en "Instalar extensión..." para seleccionar el archivo unofficial-kintone-mcp-server-8.1.0.mcpb descargado.

Haga clic en "Instalar".

Ingrese el dominio, nombre de usuario y contraseña de kintone de destino y haga clic en el botón "Guardar".

Haga clic en el interruptor que está en "Desactivado" para cambiarlo a "Activado" y cierre la pantalla de configuración.

Abra una nueva pantalla de chat. Al hacer clic en el icono de herramientas, se mostrarán las extensiones (servidores MCP) cargadas. Si "unofficial-kintone-mcp-server" está activado, podrá utilizarlo.

Al hacer clic en ">" en el lado derecho de "unofficial-kintone-mcp-server", se mostrarán las herramientas disponibles. Si hay alguna herramienta que no desee utilizar, desactívela.

Procedimiento de instalación local sin utilizar el archivo mcpb

1. Requisitos

• Node.js 20 o superior
• pnpm o npm

2. Descargar el código fuente

La ubicación de descarga puede ser cualquier lugar, pero es recomendable colocarlo en una ruta compuesta únicamente por caracteres alfanuméricos en inglés y sin espacios.

3. Instalar las dependencias

pnpm install

o

npm install

4. Editar el archivo de configuración de la aplicación Claude Desktop

Busque el archivo de configuración claude_desktop_config.json y agregue la configuración en la sección "mcpServers" de este archivo, tomando como referencia lo siguiente.

{
  "mcpServers": {
    "kintone": {
      "command": "node",
      "env": {
        "KINTONE_DOMAIN": "[あなたが使用するサブドメイン].cybozu.com",
        "KINTONE_USERNAME": "MCP接続で使用するkintoneユーザー名",
        "KINTONE_PASSWORD": "kintoneユーザーのパスワード（平文）"
      },
      "args": [
        "[kintone-mcp-serverを配置したパス]/server.js"
      ]
    }
  }
}

5. Reiniciar la aplicación Claude Desktop

Después de guardar los cambios en claude_desktop_config.json, cierre y reinicie la aplicación Claude Desktop. Aunque parezca que la aplicación se ha cerrado, puede que siga ejecutándose en segundo plano, así que haga clic derecho en el icono de la bandeja y seleccione "Salir".

Uso

1. Verificación de funcionamiento

Primero, pregunte a Claude: "Investiga el ID de la aplicación de kintone «ejemplo de nombre de aplicación accesible con el usuario de kintone configurado»". El nombre de la aplicación de kintone que ingrese aquí debe especificarse exactamente, palabra por palabra.

2. Lista de funciones proporcionadas por este servidor MCP

Consulte docs/tool-annotations.md para conocer los atributos de anotación de cada herramienta.

Operaciones con registros

• get_record: Obtener un registro de una aplicación de kintone
• search_records: Buscar registros en una aplicación de kintone
• create_record: Crear un nuevo registro en una aplicación de kintone
• update_record: Actualizar un registro existente en una aplicación de kintone
• upsert_record: Crear o actualizar un registro especificando un campo de prohibición de duplicados en una aplicación de kintone (operación Upsert)
• add_record_comment: Agregar un comentario a un registro de kintone
• update_record_status: Actualizar el estado de un registro de kintone (gestión de procesos)
• update_record_assignees: Actualizar los asignados de un registro de kintone (gestión de procesos)
• get_record_comments: Obtener los comentarios de un registro de kintone

Operaciones con archivos

• upload_file: Subir un archivo a kintone
• download_file: Descargar un archivo de kintone (nota: en la implementación actual, es posible que los archivos de más de 1 MB no se puedan descargar correctamente)

Información de la aplicación

• get_apps_info: Obtener información de la aplicación de kintone combinando nombre de aplicación (búsqueda de texto), ID de aplicación (número natural), código de aplicación e ID de espacio (se requiere app_name o app_id)
• get_form_layout: Obtener el diseño de formulario de una aplicación de kintone
• get_form_fields: Obtener información de los campos del formulario de una aplicación de kintone (solo entorno de producción; para el entorno de vista previa, use get_preview_form_fields)
• get_app_actions: Obtener la configuración de acciones de la aplicación de kintone
• get_app_plugins: Obtener la lista de complementos agregados a una aplicación de kintone
• get_process_management: Obtener la configuración de gestión de procesos de una aplicación de kintone
• get_app_acl: Obtener los permisos de acceso de una aplicación de kintone
• get_field_acl: Obtener los permisos de acceso de los campos de una aplicación de kintone
• get_record_acl: Obtener los permisos de acceso de un registro específico
• evaluate_records_acl: Evaluar los permisos de acceso de registros bajo condiciones específicas
• get_views: Obtener la configuración de las vistas (listas) de una aplicación de kintone
• get_reports: Obtener la configuración de gráficos de una aplicación de kintone
• get_notifications: Obtener la configuración de condiciones de notificación de una aplicación de kintone
• get_per_record_notifications: Obtener la configuración de notificaciones por registro de una aplicación de kintone
• get_reminder_notifications: Obtener la configuración de notificaciones de recordatorio de una aplicación de kintone

Operaciones con aplicaciones

• create_app: Crear una nueva aplicación de kintone
• add_fields: Agregar campos a una aplicación de kintone
• update_field: Actualizar la configuración de un campo de kintone existente
• update_form_layout: Cambiar el diseño del formulario de una aplicación de kintone
• update_app_settings: Cambiar la configuración general de la aplicación
• deploy_app: Iniciar la operación de producción de una aplicación de kintone (reflejar en el entorno de producción)
• get_deploy_status: Verificar el estado de reflejo de la configuración de la aplicación en el entorno de producción
• move_app_to_space: Mover una aplicación de kintone a un espacio específico
• move_app_from_space: Hacer que una aplicación de kintone no pertenezca a ningún espacio
• update_app_acl: Actualizar los permisos de acceso de una aplicación de kintone
• update_field_acl: Actualizar los permisos de acceso de los campos de una aplicación de kintone
• update_views: Actualizar la configuración de las vistas (listas) de una aplicación de kintone
• update_reports: Actualizar la configuración de gráficos de una aplicación de kintone
• update_notifications: Actualizar la configuración de condiciones de notificación de una aplicación de kintone
• update_per_record_notifications: Actualizar la configuración de notificaciones por registro de una aplicación de kintone
• update_reminder_notifications: Actualizar la configuración de notificaciones de recordatorio de una aplicación de kintone
• update_process_management: Actualizar la configuración de gestión de procesos de una aplicación de kintone
• update_app_actions: Actualizar la configuración de acciones de una aplicación de kintone

Operaciones con espacios

• get_space: Obtener información general de un espacio
• update_space: Actualizar la configuración de un espacio
• update_space_body: Actualizar el cuerpo (descripción) de un espacio
• get_space_members: Obtener la lista de miembros de un espacio
• update_space_members: Actualizar los miembros de un espacio
• add_thread: Agregar un hilo a un espacio
• update_thread: Actualizar un hilo
• add_thread_comment: Agregar un comentario a un hilo
• add_guests: Agregar un usuario invitado
• update_space_guests: Actualizar los miembros invitados de un espacio

Información de usuarios y grupos

• get_users: Obtener información de usuarios de kintone
• get_groups: Obtener información de grupos de kintone
• get_group_users: Obtener la lista de usuarios que pertenecen a un grupo específico

Información de conexión a kintone

• get_kintone_domain: Obtener el dominio de conexión de kintone
• get_kintone_username: Obtener el nombre de usuario utilizado para la conexión a kintone

Otros

He escrito en un blog sobre lo que se puede hacer con este servidor MCP, así que échele un vistazo.

• La buena relación entre kintone y la IA generativa (Claude)
• El estado actual de kintone AI Lab y el servidor MCP para kintone

Además, publicamos por separado aquí un código de muestra de un servidor MCP remoto con soporte OAuth que se puede utilizar desde Claude (versión de navegador web) o ChatGPT.

"kintone" es una marca registrada de Cybozu, Inc.

El contenido descrito aquí tiene fines informativos y no se brinda soporte individual. Tenga en cuenta que no podemos responder a preguntas sobre la configuración ni a informes de que no funciona en su entorno.