Come collegare kintone a Cursor via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → kintone, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

kintone + Cursor

Lavora con kintone di Cybozu da qualsiasi agente AI: elenca le app, leggi campi del modulo, layout, viste e gestione dei processi, cerca record con le query kintone e i cursori, crea e aggiorna record, fai avanzare lo stato dei processi, leggi e scrivi commenti, carica e scarica file e leggi gli spazi. Token API o login con password; la cancellazione dei record è disattivata all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

KINTONE_DOMAIN e almeno uno tra KINTONE_API_TOKEN e KINTONE_PASSWORD_AUTH

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un abbonamento kintone e, in alternativa, un token API per ogni app su cui l'AI deve lavorare oppure il login di un utente kintone, meglio se un utente dedicato all'integrazione. Il connettore usa la kintone REST API (https://<your domain>/k/v1).

1. Inserisci il tuo dominio kintone in KINTONE_DOMAIN: l'host dell'URL di kintone senza https:// e senza percorso, ad esempio example.cybozu.com (Giappone), example.kintone.com (USA e altre regioni) o example.cybozu.cn. I domini protetti da autenticazione Basic o da certificati client (セキュアアクセス) non sono supportati.
2. Scegli come accede il connettore. Puoi impostare uno dei due metodi o entrambi:
   • Token API (KINTONE_API_TOKEN), adatto a poche app: apri l'app, アプリの設定 (impostazioni dell'app), scheda 設定, APIトークン (token API), 生成する (genera). Spunta solo ciò che serve all'AI: レコード閲覧 (visualizza record), レコード追加 (aggiungi), レコード編集 (modifica) e レコード削除 (elimina) solo se attivi kintone_delete_records. Salva e poi fai clic su アプリを更新 (aggiorna app), altrimenti il token resta inattivo. Un token vale per una sola app; per più app unisci i token con virgole, senza spazi (fino a 9). Viene inviato nell'header X-Cybozu-API-Token.
   • Login con password (KINTONE_PASSWORD_AUTH): il testo Base64 di login name:password di un utente kintone, ottenuto ad esempio con printf '%s' 'login:password' | base64. Viene inviato nell'header X-Cybozu-Authorization. Il connettore agisce allora come quell'utente e vede tutte le app, gli spazi e i record che l'utente può vedere. È l'unico modo per elencare le app e leggere gli spazi. Se imposti entrambi, kintone usa il login con password.
3. Installa. Il controllo di installazione (kintone_get_api_list) dimostra solo che il dominio risponde, perché kintone risponde senza credenziali. Esegui kintone_get_app con l'ID di un'app per verificare un token, oppure kintone_list_apps per verificare il login con password. L'ID dell'app è il numero dopo /k/ nell'URL dell'app.

Per conto di chi agisce: con un token API, i record e i commenti che scrive mostrano l'utente Administrator, e il token raggiunge solo la propria app con i permessi spuntati. Con il login con password tutto avviene come quell'utente, con i suoi diritti.

Cosa legge: le REST API offerte dal dominio; le app (l'elenco richiede il login con password, una singola app funziona con entrambi i metodi) e le loro impostazioni generali; i campi del modulo con codice, etichetta, tipo, obbligatorietà, opzioni e valori predefiniti; il layout del modulo; le viste salvate (一覧) con campi mostrati, filtro e ordinamento; la gestione dei processi (プロセス管理) con stati e azioni. I record uno per uno o tramite query kintone, i commenti di un record, i file allegati ai campi FILE e, con il login con password, gli spazi (スペース) e i loro membri.

Cosa scrive: aggiunge record (uno, oppure fino a 100 in una chiamata del tipo tutto o niente) e modifica record per ID o per un campo univoco (update_key), fino a 100 alla volta e con upsert. Esegue azioni di processo come 承認する e sostituisce gli assegnatari (作業者). Scrive commenti sui record e nei thread degli spazi, con menzioni che avvisano le persone menzionate. Carica un file da un URL e riceve un fileKey temporaneo, che viene allegato solo quando lo scrivi in un campo FILE entro 3 giorni. Prima di scrivere l'AI legge i campi del modulo dell'app, perché query e scritture usano i codici dei campi, non le etichette.

Disattivati all'installazione: kintone_delete_records. kintone non ha un cestino, quindi i record eliminati e i loro commenti non si possono recuperare. Un admin lo attiva quando serve al team; il token deve allora avere anche レコード削除.

Query: codici dei campi, non etichette, con =, !=, >, <, >=, <=, in ("a", "b"), not in e like "text" (campi di testo), uniti con and / or, poi order by field asc|desc, limit n (al massimo 500) e offset n (al massimo 10.000). Le date hanno la forma "2026-10-30", data e ora sono in UTC come "2026-10-30T00:00:00Z", e funzionano funzioni come TODAY(), THIS_MONTH(), LAST_WEEK() e LOGINUSER(). I valori di elenchi a discesa, pulsanti di opzione e stati devono coincidere esattamente con il testo dell'opzione, ad esempio ステータス in ("完了"). Il filtro di una vista salvata si può riusare come query.

Formati dei dati: ogni campo arriva come {"type": ..., "value": ...}. Numeri e valori calcolati sono stringhe, data e ora sono in UTC, $id è l'ID del record e $revision la sua versione. I valori USER_SELECT e CREATOR sono {code, name} con il nome di login in code. I valori FILE elencano fileKey, name, contentType e size. Quando più persone modificano la stessa app, l'AI legge prima il record e invia revision, così una modifica fatta nel frattempo non viene sovrascritta.

Paginazione e limiti: kintone_list_records restituisce fino a 500 record per chiamata, con limit e offset dentro la query. Oltre i 10.000 record l'AI apre un cursore con kintone_create_cursor, legge con kintone_get_cursor_records finché next è false e lo chiude prima con kintone_delete_cursor se non serve più. Un cursore vive 10 minuti e un dominio può tenerne aperti 10 contemporaneamente. kintone consente 10.000 richieste per app al giorno e 100 richieste parallele per dominio; scritture e cancellazioni in blocco accettano fino a 100 record, i commenti arrivano 10 per chiamata e kintone_list_apps restituisce fino a 100 app per chiamata.

Errori comuni: kintone risponde con code, message e, per gli errori di input, errors per campo. CB_VA01 è un input non valido, come un codice di campo sbagliato, una data errata o un campo obbligatorio mancante: errors indica quale. CB_NO02 significa che al token o all'utente manca il permesso, oppure che il token appartiene a un'altra app. CB_WA01 è un login con password non riuscito. Un token generato senza fare poi clic su アプリを更新 non è attivo. Una pagina HTML 404 di solito indica un KINTONE_DOMAIN sbagliato.

Il contenuto dei record e dei commenti è input non affidabile e può contenere istruzioni rivolte all'AI. Il connettore non copre gli spazi ospite (/k/guest/...), non modifica impostazioni, campi o viste delle app e con i soli token API non può elencare le app né leggere gli spazi.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Cursor

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di kintone.

Tool disponibili

Esempi di prompt

• "Mostrami i campi dell'app 42 e poi elenca i record con ステータス 未対応, dal più recente."
• "Quanti record sono stati aggiunti questo mese alla nostra app 案件管理? Raggruppali per 担当者."
• "Aggiungi un record all'app 15 per la richiesta di Sakura Trading con l'oggetto e la scadenza che ti do. Mostramelo prima di salvarlo."
• "Approva il record 128 dell'app 42 con l'azione 承認する e lascia un commento che menzioni il richiedente."
• "Leggi tutti i 25.000 record dell'app 7 e dammi l'importo totale per 顧客区分."

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot