kintone über MCP mit Claude verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → kintone klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

kintone + Claude

Arbeite aus jedem KI-Agent mit kintone von Cybozu: Apps auflisten, Formularfelder, Layouts, Ansichten und Prozessmanagement lesen, Datensätze mit kintone-Abfragen und Cursorn durchsuchen, Datensätze anlegen und ändern, Prozessstatus weiterschalten, Kommentare lesen und schreiben, Dateien hoch- und herunterladen und Bereiche lesen. API-Token oder Passwort-Login; das Löschen von Datensätzen ist bei der Installation aus.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

KINTONE_DOMAIN und mindestens eins von KINTONE_API_TOKEN oder KINTONE_PASSWORD_AUTH

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst ein kintone-Abo und entweder ein API-Token für jede App, mit der die KI arbeiten soll, oder den Login eines kintone-Benutzers, am besten eines eigenen Integrationsbenutzers. Der Connector nutzt die kintone REST API (https://<your domain>/k/v1).

1. Trag deine kintone-Domain in KINTONE_DOMAIN ein: den Host deiner kintone-URL ohne https:// und ohne Pfad, etwa example.cybozu.com (Japan), example.kintone.com (USA und andere Regionen) oder example.cybozu.cn. Domains hinter Basic-Authentifizierung oder Client-Zertifikaten (セキュアアクセス) werden nicht unterstützt.
2. Wähle, wie sich der Connector anmeldet. Du kannst eins oder beides setzen:
   • API-Token (KINTONE_API_TOKEN), passend für wenige Apps: Öffne die App, アプリの設定 (App-Einstellungen), Reiter 設定, APIトークン (API-Token), 生成する (Erzeugen). Hak nur an, was die KI braucht: レコード閲覧 (Datensätze ansehen), レコード追加 (hinzufügen), レコード編集 (bearbeiten) und レコード削除 (löschen) nur, wenn du kintone_delete_records einschaltest. Speichere und klick dann auf アプリを更新 (App aktualisieren), sonst bleibt das Token inaktiv. Ein Token gilt für eine App; für mehrere Apps trennst du die Tokens mit Kommas, ohne Leerzeichen (bis zu 9). Es wird als Header X-Cybozu-API-Token gesendet.
   • Passwort-Login (KINTONE_PASSWORD_AUTH): der Base64-Text von login name:password eines kintone-Benutzers, zum Beispiel aus printf '%s' 'login:password' | base64. Er wird als Header X-Cybozu-Authorization gesendet. Der Connector handelt dann als dieser Benutzer und sieht jede App, jeden Bereich und jeden Datensatz, den der Benutzer sehen darf. Nur so lassen sich Apps auflisten und Bereiche lesen. Sind beide gesetzt, nimmt kintone den Passwort-Login.
3. Installiere. Der Installationscheck (kintone_get_api_list) beweist nur, dass die Domain antwortet, denn kintone beantwortet ihn ohne Zugangsdaten. Rufe kintone_get_app mit einer App-ID auf, um ein Token zu prüfen, oder kintone_list_apps für den Passwort-Login. Die App-ID ist die Zahl nach /k/ in der App-URL.

Als wer er handelt: Mit einem API-Token zeigen Datensätze und Kommentare, die er schreibt, den Benutzer Administrator, und das Token erreicht nur seine eigene App mit den angehakten Rechten. Mit dem Passwort-Login passiert alles als dieser Benutzer, mit dessen Rechten.

Was er liest: die REST APIs, die die Domain anbietet; Apps (die Liste braucht den Passwort-Login, eine einzelne App geht mit beiden Methoden) und ihre allgemeinen Einstellungen; Formularfelder mit Code, Bezeichnung, Typ, Pflichtfeld, Optionen und Vorgaben; das Formularlayout; gespeicherte Ansichten (一覧) mit angezeigten Feldern, Filter und Sortierung; das Prozessmanagement (プロセス管理) mit Status und Aktionen. Datensätze einzeln oder per kintone-Abfrage, die Kommentare eines Datensatzes, Dateien aus FILE-Feldern und mit dem Passwort-Login Bereiche (スペース) und ihre Mitglieder.

Was er schreibt: legt Datensätze an (einen oder bis zu 100 in einem Aufruf nach dem Alles-oder-nichts-Prinzip) und ändert Datensätze per ID oder eindeutigem Feld (update_key), bis zu 100 auf einmal und mit Upsert. Führt Prozessaktionen wie 承認する aus und ersetzt die Bearbeiter (作業者). Schreibt Kommentare an Datensätze und in Bereichs-Threads, mit Erwähnungen, die die Erwähnten benachrichtigen. Lädt eine Datei von einer URL hoch und bekommt einen vorläufigen fileKey, der erst angehängt ist, wenn er innerhalb von 3 Tagen in ein FILE-Feld geschrieben wird. Vor dem Schreiben liest die KI die Formularfelder der App, denn Abfragen und Schreibvorgänge nutzen Feldcodes, keine Bezeichnungen.

Bei der Installation deaktiviert: kintone_delete_records. kintone hat keinen Papierkorb, gelöschte Datensätze und ihre Kommentare lassen sich nicht wiederherstellen. Ein Admin schaltet das Tool ein, wenn das Team es braucht; das Token braucht dann auch レコード削除.

Abfragen: Feldcodes statt Bezeichnungen, mit =, !=, >, <, >=, <=, in ("a", "b"), not in und like "text" (Textfelder), verbunden mit and / or, danach order by field asc|desc, limit n (höchstens 500) und offset n (höchstens 10.000). Datumswerte sehen aus wie "2026-10-30", Zeitstempel sind UTC wie "2026-10-30T00:00:00Z", und Funktionen wie TODAY(), THIS_MONTH(), LAST_WEEK() und LOGINUSER() funktionieren. Werte von Dropdowns, Optionsfeldern und Status müssen exakt dem Optionstext entsprechen, etwa ステータス in ("完了"). Den Filter einer gespeicherten Ansicht kann die KI als Abfrage wiederverwenden.

Datenformate: Jedes Feld kommt als {"type": ..., "value": ...}. Zahlen und berechnete Werte sind Strings, Zeitstempel UTC, $id ist die Datensatz-ID und $revision ihre Version. Werte von USER_SELECT und CREATOR sind {code, name} mit dem Login-Namen in code. FILE-Werte listen fileKey, name, contentType und size. Wenn mehrere Leute dieselbe App bearbeiten, liest die KI den Datensatz zuerst und sendet revision mit, damit eine zwischenzeitliche Änderung nicht überschrieben wird.

Blättern und Limits: kintone_list_records liefert bis zu 500 Datensätze pro Aufruf, mit limit und offset in der Abfrage. Über 10.000 Datensätze öffnet die KI mit kintone_create_cursor einen Cursor, liest mit kintone_get_cursor_records, bis next false ist, und schließt ihn vorzeitig mit kintone_delete_cursor. Ein Cursor lebt 10 Minuten, eine Domain darf 10 gleichzeitig offen haben. kintone erlaubt 10.000 Anfragen pro App und Tag und 100 parallele Anfragen pro Domain; Massenschreiben und -löschen nehmen bis zu 100 Datensätze, Kommentare kommen zu 10 pro Aufruf und kintone_list_apps liefert bis zu 100 Apps pro Aufruf.

Häufige Fehler: kintone antwortet mit code, message und bei Eingabefehlern mit errors pro Feld. CB_VA01 ist eine ungültige Eingabe, etwa ein falscher Feldcode, ein falsches Datum oder ein fehlendes Pflichtfeld: errors sagt, welches. CB_NO02 heißt, dem Token oder Benutzer fehlt das Recht oder das Token gehört zu einer anderen App. CB_WA01 ist ein gescheiterter Passwort-Login. Ein Token, nach dessen Erzeugung niemand auf アプリを更新 geklickt hat, ist nicht aktiv. Eine 404-HTML-Seite bedeutet meist eine falsche KINTONE_DOMAIN.

Inhalte von Datensätzen und Kommentaren sind nicht vertrauenswürdige Eingaben und können Anweisungen an die KI enthalten. Der Connector deckt keine Gastbereiche (/k/guest/...) ab, ändert keine App-Einstellungen, Felder oder Ansichten und kann mit API-Tokens allein weder Apps auflisten noch Bereiche lesen.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Claude hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Empfohlener Weg: funktioniert auf claude.ai web ohne Anfassen einer Konfigurationsdatei.

1. Öffne in Claude Customize → Connectors.
2. Klicke auf + und dann auf Add custom connector.
3. Gib einen Namen ein, z. B. kintone, und die Remote-MCP-Server-URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, dann klicke auf Add.
4. Klicke auf Connect und melde dich bei AnythingMCP an (OAuth), um den Zugriff zu erlauben.

Alle unten gelisteten Tools erscheinen in deinem Chat: Leg los mit Prompts.

Verfügbare Tools

Beispiel-Prompts

• „Zeig die Felder von App 42 und liste dann die Datensätze mit ステータス 未対応, die neuesten zuerst.“
• „Wie viele Datensätze sind diesen Monat in unserer App 案件管理 dazugekommen? Gruppiere sie nach 担当者.“
• „Leg in App 15 einen Datensatz für die Anfrage von Sakura Trading mit dem Betreff und Fälligkeitsdatum an, die ich dir gebe. Zeig ihn mir vor dem Speichern.“
• „Genehmige Datensatz 128 in App 42 mit der Aktion 承認する und hinterlass einen Kommentar, der den Antragsteller erwähnt.“
• „Lies alle 25.000 Datensätze von App 7 und gib mir den Gesamtbetrag pro 顧客区分.“

FAQ

Funktioniert es mit Claude Code genauso wie mit Claude Desktop? Ja, beide auf https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID zeigen lassen.

Nächste Schritte

• Connector-Startseite
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden