Cómo conectar kintone a ChatGPT vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → kintone, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

kintone + ChatGPT

Trabaja con kintone de Cybozu desde cualquier agente de IA: lista apps, lee campos de formulario, diseños, vistas y gestión de procesos, busca registros con consultas de kintone y cursores, crea y actualiza registros, avanza estados de proceso, lee y publica comentarios, sube y descarga archivos y lee espacios. Token de API o inicio de sesión con contraseña; el borrado de registros viene desactivado al instalar.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

KINTONE_DOMAIN y al menos uno de KINTONE_API_TOKEN o KINTONE_PASSWORD_AUTH

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una suscripción a kintone y, o bien un token de API para cada app con la que deba trabajar la IA, o bien el inicio de sesión de un usuario de kintone, mejor uno dedicado a la integración. El conector usa la kintone REST API (https://<your domain>/k/v1).

1. Introduce tu dominio de kintone en KINTONE_DOMAIN: el host de tu URL de kintone sin https:// y sin ruta, por ejemplo example.cybozu.com (Japón), example.kintone.com (EE. UU. y otras regiones) o example.cybozu.cn. No se admiten dominios protegidos con autenticación Basic o certificados de cliente (セキュアアクセス).
2. Elige cómo inicia sesión el conector. Puedes configurar uno o los dos:
   • Token de API (KINTONE_API_TOKEN), práctico para pocas apps: abre la app, アプリの設定 (configuración de la app), pestaña 設定, APIトークン (token de API), 生成する (generar). Marca solo lo que necesita la IA: レコード閲覧 (ver registros), レコード追加 (añadir), レコード編集 (editar) y レコード削除 (eliminar) solo si activas kintone_delete_records. Guarda y luego haz clic en アプリを更新 (actualizar app); si no, el token queda inactivo. Un token sirve para una sola app; para varias apps une sus tokens con comas, sin espacios (hasta 9). Se envía en la cabecera X-Cybozu-API-Token.
   • Inicio de sesión con contraseña (KINTONE_PASSWORD_AUTH): el texto Base64 de login name:password de un usuario de kintone, por ejemplo con printf '%s' 'login:password' | base64. Se envía en la cabecera X-Cybozu-Authorization. El conector actúa entonces como ese usuario y ve todas las apps, espacios y registros que ese usuario puede ver. Es la única forma de listar apps y leer espacios. Si configuras ambos, kintone usa el inicio de sesión con contraseña.
3. Instala. La comprobación de instalación (kintone_get_api_list) solo demuestra que el dominio responde, porque kintone la contesta sin credenciales. Ejecuta kintone_get_app con el id de una app para comprobar un token, o kintone_list_apps para comprobar el inicio de sesión con contraseña. El id de la app es el número tras /k/ en la URL de la app.

En nombre de quién actúa: con un token de API, los registros y comentarios que escribe muestran el usuario Administrator, y el token solo llega a su propia app con los permisos marcados. Con el inicio de sesión con contraseña, todo ocurre como ese usuario y con sus derechos.

Qué lee: las REST API que ofrece el dominio; las apps (la lista requiere el inicio de sesión con contraseña, una app concreta funciona con ambos métodos) y su configuración general; los campos del formulario con código, etiqueta, tipo, obligatoriedad, opciones y valores por defecto; el diseño del formulario; las vistas guardadas (一覧) con campos visibles, filtro y orden; la gestión de procesos (プロセス管理) con estados y acciones. Registros uno a uno o mediante consulta de kintone, los comentarios de un registro, los archivos de los campos FILE y, con el inicio de sesión con contraseña, los espacios (スペース) y sus miembros.

Qué escribe: añade registros (uno, o hasta 100 en una llamada de todo o nada) y modifica registros por id o por un campo único (update_key), hasta 100 a la vez y con upsert. Ejecuta acciones de proceso como 承認する y sustituye a los responsables (作業者). Publica comentarios en registros y en hilos de espacios, con menciones que avisan a las personas mencionadas. Sube un archivo desde una URL y obtiene un fileKey temporal, que solo queda adjunto cuando se escribe en un campo FILE en un plazo de 3 días. Antes de escribir, la IA lee los campos del formulario de la app, porque las consultas y escrituras usan códigos de campo, no etiquetas.

Desactivadas al instalar: kintone_delete_records. kintone no tiene papelera, así que los registros borrados y sus comentarios no se pueden recuperar. Un admin la activa cuando el equipo la necesita; el token necesita entonces también レコード削除.

Consultas: códigos de campo, no etiquetas, con =, !=, >, <, >=, <=, in ("a", "b"), not in y like "text" (campos de texto), unidos con and / or, después order by field asc|desc, limit n (como máximo 500) y offset n (como máximo 10.000). Las fechas tienen la forma "2026-10-30", las fechas con hora van en UTC como "2026-10-30T00:00:00Z", y funcionan funciones como TODAY(), THIS_MONTH(), LAST_WEEK() y LOGINUSER(). Los valores de desplegables, botones de opción y estados deben coincidir exactamente con el texto de la opción, por ejemplo ステータス in ("完了"). El filtro de una vista guardada se puede reutilizar como consulta.

Formatos de datos: cada campo llega como {"type": ..., "value": ...}. Los números y los valores calculados son cadenas, las fechas con hora están en UTC, $id es el id del registro y $revision su versión. Los valores USER_SELECT y CREATOR son {code, name} con el nombre de inicio de sesión en code. Los valores FILE listan fileKey, name, contentType y size. Cuando varias personas editan la misma app, la IA lee primero el registro y envía revision, para no sobrescribir un cambio hecho entretanto.

Paginación y límites: kintone_list_records devuelve hasta 500 registros por llamada, con limit y offset dentro de la consulta. Por encima de 10.000 registros la IA abre un cursor con kintone_create_cursor, lee con kintone_get_cursor_records hasta que next sea false y lo cierra antes con kintone_delete_cursor si ya no hace falta. Un cursor vive 10 minutos y un dominio puede tener 10 abiertos a la vez. kintone permite 10.000 peticiones por app y día y 100 peticiones en paralelo por dominio; las escrituras y borrados masivos admiten hasta 100 registros, los comentarios llegan de 10 en 10 y kintone_list_apps devuelve hasta 100 apps por llamada.

Errores comunes: kintone responde con code, message y, en errores de entrada, errors por campo. CB_VA01 es una entrada no válida, como un código de campo erróneo, una fecha incorrecta o un campo obligatorio vacío: errors indica cuál. CB_NO02 significa que al token o al usuario le falta el permiso, o que el token pertenece a otra app. CB_WA01 es un inicio de sesión con contraseña fallido. Un token generado sin hacer clic después en アプリを更新 no está activo. Una página HTML 404 suele indicar un KINTONE_DOMAIN incorrecto.

El contenido de registros y comentarios es una entrada no fiable y puede contener instrucciones dirigidas a la IA. El conector no cubre los espacios de invitados (/k/guest/...), no cambia la configuración, los campos ni las vistas de las apps y, solo con tokens de API, no puede listar apps ni leer espacios.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en ChatGPT

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: kintone.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "Muéstrame los campos de la app 42 y luego lista los registros con ステータス 未対応, los más recientes primero."
• "¿Cuántos registros se han añadido este mes a nuestra app 案件管理? Agrúpalos por 担当者."
• "Añade un registro a la app 15 para la consulta de Sakura Trading con el asunto y la fecha límite que te doy. Enséñamelo antes de guardarlo."
• "Aprueba el registro 128 de la app 42 con la acción 承認する y deja un comentario que mencione al solicitante."
• "Lee los 25.000 registros de la app 7 y dame el importe total por 顧客区分."

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot