Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KINTONE_DOMAIN | Yes | The kintone domain in the format [subdomain].cybozu.com | |
| KINTONE_PASSWORD | Yes | The kintone user's password in plain text | |
| KINTONE_USERNAME | Yes | The kintone username for MCP connection |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_record | kintoneアプリの1レコードを取得します。事前に対象アプリのフィールド構造を把握したい場合は、`get_form_fields` ツールで利用予定のフィールドコードを確認してから本ツールを呼び出してください。 |
| search_records | kintoneアプリのレコードを検索します。事前に対象アプリのフィールド一覧を把握するため、`get_form_fields` ツールで利用予定のフィールドコードやフィールドタイプを確認してからクエリーを作成することを推奨します。 【よく使用されるクエリ例】 • 文字列検索: Customer = "サイボウズ株式会社" (完全一致) • 部分一致: Customer like "株式会社" (部分一致) • ドロップダウン: Status in ("対応中","未対応") (複数値の選択) • 日付範囲: LimitDay >= "2022-09-29" and LimitDay <= "2022-10-29" • 日付関数: LimitDay < TODAY() (今日より前) • 複数条件: Status in ("対応中") and LimitDay < TODAY() • ソート: Status = "対応中" order by 更新日時 desc • ページング: Status = "対応中" order by $id desc limit 20 offset 20 • 空欄チェック: Detail is empty (文字列複数行の空欄) • 非空欄チェック: Detail is not empty (文字列複数行の非空欄) • 添付ファイル有無: Attachments is empty / is not empty • ユーザー検索: 作成者 in (LOGINUSER()) (自分が作成したレコード) 注意: is empty / is not empty は「文字列(複数行)」と「添付ファイル(FILE)」に対してのみ使用でき、「文字列(1行)」などの他のフィールドタイプに対しては使用できません。 クエリ式の詳細仕様や構文とすべての演算子や関数、フィールド別の使用可否といったkintoneの仕様については get_query_language_documentation ツールを実行して確認してください。 |
| create_record | kintoneアプリに新しいレコードを作成します。事前に対象アプリのフィールド構造を把握するため、`get_form_fields` やフォームの配置情報を確認できる`get_form_layout` を実行し、必要なフィールドコードと配置を整理してから本ツールを使用することを推奨します。各フィールドは { "value": ... } の形式で指定します。 例: { "app_id": 1, "fields": { "文字列1行": { "value": "テスト" }, "文字列複数行": { "value": "テスト\nテスト2" }, "数値": { "value": "20" }, "日時": { "value": "2014-02-16T08:57:00Z" }, "チェックボックス": { "value": ["sample1", "sample2"] }, "ユーザー選択": { "value": [{ "code": "sato" }] }, "ドロップダウン": { "value": "sample1" }, "リンク_ウェブ": { "value": "https://www.cybozu.com" }, "テーブル": { "value": [{ "value": { "テーブル文字列": { "value": "テスト" } } }] } } } |
| update_record | kintoneアプリの既存レコードを更新します。更新前に`get_form_fields` や`get_form_layout` でフィールド構造とレイアウトを確認し、利用するフィールドコードが最新であることをチェックしてから操作してください。各フィールドは { "value": ... } の形式で指定します。 例1(レコードIDを指定して更新): { "app_id": 1, "record_id": 1001, "fields": { "文字列1行_0": { "value": "character string is changed" }, "テーブル_0": { "value": [{ "id": 1, "value": { "文字列1行_1": { "value": "character string is changed" } } }]} } } 例2(重複禁止フィールドを指定して更新): { "app_id": 1, "updateKey": { "field": "文字列1行_0", "value": "フィールドの値" }, "fields": { "文字列1行_1": { "value": "character string is changed" }, "テーブル_0": { "value": [{ "id": 1, "value": { "文字列1行_2": { "value": "character string is changed" } } }]} } } レコードIDまたはupdateKeyのいずれかを指定して更新できます。updateKeyを使用する場合は、重複禁止に設定されたフィールドを指定してください。 |
| add_record_comment | kintoneレコードにコメントを追加します |
| update_record_status | kintoneレコードのステータスを更新します(プロセス管理) |
| update_record_assignees | kintoneレコードの作業者を更新します(プロセス管理) |
| get_record_comments | kintoneレコードのコメントを取得します。limit未指定の場合は内部でページングして全件を取得します。大量データになる場合は limit(例: 10)を指定することを推奨します。 |
| create_records | kintoneアプリに複数のレコードを一括作成します(最大100件) |
| upsert_record | 重複禁止フィールド(updateKey)またはレコードIDをキーに、存在すれば更新・無ければ作成する upsert 機能を使用します。実行前に |
| upsert_records | 複数レコードを一括Upsertします。各要素に重複禁止フィールド(updateKey)と更新内容を指定すると、存在するレコードは更新、存在しないレコードは新規作成されます。最大100件。 |
| get_process_management | kintoneアプリのプロセス管理設定を取得します |
| update_process_management | kintoneアプリのプロセス管理設定を更新します |
| get_apps_info | アプリ名(またはその部分文字列)で検索、アプリIDで絞り込み、さらに任意でアプリコードやスペースIDでも絞り込んでkintoneアプリの情報を取得します。 |
| create_app | 新しいkintoneアプリを作成します |
| deploy_app | kintoneアプリの設定をデプロイします |
| get_deploy_status | kintoneアプリのデプロイ状態を確認します |
| update_app_settings | kintoneアプリの一般設定を変更します |
| get_form_layout | kintoneアプリのフォームレイアウトを取得します |
| update_form_layout | kintoneアプリのフォームレイアウトを変更します。トップレベルには ROW と SUBTABLE と GROUP を配置できます。SUBTABLEやGROUPはトップレベルに配置する必要があります。ROW内に配置することはできません。SUBTABLEをレイアウトに含める際には、fieldsプロパティでテーブル内に表示するフィールドとその順序を指定する必要があります。また、ルックアップフィールドをフォームに配置する際は 250 以上の幅を明示的に指定してください。 |
| move_app_to_space | kintoneアプリを指定したスペースに移動します |
| move_app_from_space | kintoneアプリをスペースに所属させないようにします。注意: kintoneシステム管理の「利用する機能の選択」で「スペースに所属しないアプリの作成を許可する」が有効になっている必要があります。 |
| get_preview_app_settings | プレビュー環境のkintoneアプリ設定を取得します |
| get_form_fields | kintoneアプリのフォームフィールド情報を取得します。対象アプリが本番環境に存在しない場合はエラーとなります。プレビュー環境の情報を取得したい場合は get_preview_form_fields を使用してください。 |
| get_preview_form_fields | プレビュー環境のkintoneアプリのフォームフィールド情報を取得します |
| get_preview_form_layout | プレビュー環境のkintoneアプリのフォームレイアウト情報を取得します |
| get_app_actions | kintoneアプリのアクション設定を取得します。レスポンスには各アクションの実行条件(filterCond)も含まれます。filterCondは、アプリアクションを実行できる条件をkintoneクエリ構文で定義したものです。 |
| get_app_plugins | kintoneアプリに追加されているプラグインの一覧を取得します |
| get_views | kintoneアプリの一覧(ビュー)の設定を取得します |
| update_views | kintoneアプリの一覧(ビュー)の設定を更新します |
| get_app_acl | kintoneアプリのアクセス権限を取得します |
| get_field_acl | kintoneアプリのフィールドのアクセス権限を取得します |
| update_field_acl | kintoneアプリのフィールドのアクセス権限を更新します |
| get_reports | kintoneアプリのグラフ設定を取得します |
| update_reports | kintoneアプリのグラフ設定を更新します |
| get_notifications | kintoneアプリの通知条件設定を取得します |
| update_notifications | kintoneアプリの通知条件設定を更新します |
| get_per_record_notifications | kintoneアプリのレコード単位の通知設定を取得します |
| update_per_record_notifications | kintoneアプリのレコード単位の通知設定を更新します |
| get_reminder_notifications | kintoneアプリのリマインダー通知設定を取得します |
| update_reminder_notifications | kintoneアプリのリマインダー通知設定を更新します |
| update_app_actions | kintoneアプリのアクション設定を更新します。各アクションにはfilterCondプロパティを指定して実行条件を設定できます。例: {"actions": {"アクション名": {"name": "アクション名", "index": "0", "filterCond": "Status = "対応中"", ...}}} |
| update_plugins | kintoneアプリのプラグイン設定を更新します |
| get_app_customize | kintoneアプリのJavaScript/CSSカスタマイズ設定を取得します |
| update_app_customize | kintoneアプリのJavaScript/CSSカスタマイズ設定を更新します |
| update_app_acl | kintoneアプリのアクセス権限を更新します |
| get_record_acl | 指定したレコードのアクセス権限を取得します |
| evaluate_records_acl | 指定した条件でレコードのアクセス権限を評価します |
| get_space | スペースの一般情報を取得します |
| update_space | スペースの設定を更新します |
| update_space_body | スペースの本文を更新します |
| get_space_members | スペースメンバーのリストを取得します |
| update_space_members | スペースメンバーを更新します |
| add_thread | スペースにスレッドを追加します |
| update_thread | スレッドを更新します |
| add_thread_comment | スレッドにコメントを追加します |
| update_space_guests | スペースのゲストメンバーを更新します |
| add_fields | kintoneアプリにフィールドを追加します。各フィールドには code(フィールドコード)、type(フィールドタイプ)、label(表示名)の指定が必須です。
初期値を設定する際は、フィールドタイプごとに
|
| update_field | 既存のkintoneフィールドの設定を更新します。 注意: システムフィールドタイプ(CREATOR, MODIFIER, RECORD_NUMBER, CREATED_TIME, UPDATED_TIME)は更新できません。 例: { "app_id": 123, "field_code": "text_field", "field": { "type": "SINGLE_LINE_TEXT", "code": "text_field", "label": "更新後のラベル", "required": true } } |
| create_choice_field | 選択肢フィールド(ラジオボタン、チェックボックス、ドロップダウン、複数選択)の設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "field_type": "RADIO_BUTTON", "code": "radio_field", "label": "ラジオボタン", "choices": ["選択肢1", "選択肢2", "選択肢3"], "align": "HORIZONTAL" } |
| create_reference_table_field | 関連テーブルフィールドの設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "code": "related_table", "label": "関連テーブル", "relatedAppId": 123, "conditionField": "customer_id", "relatedConditionField": "customer_id" } |
| create_lookup_field | ルックアップフィールドの設定を生成します。 フィールドコードに使用できる文字: ひらがな、カタカナ、漢字、英数字、記号(__・・$¥) 例: { "code": "lookup_field", "label": "ルックアップ", "relatedAppId": 123, "relatedKeyField": "customer_id", "fieldMappings": [ { "field": "name", "relatedField": "customer_name" }, { "field": "email", "relatedField": "customer_email" } ] } |
| get_field_type_documentation | フィールドタイプに関するドキュメントを取得します |
| get_available_field_types | 利用可能なフィールドタイプの一覧を取得します |
| get_documentation_tool_description | ドキュメントツールの説明を取得します |
| get_field_creation_tool_description | フィールド作成ツールの説明を取得します |
| get_query_language_documentation | kintoneクエリ言語(検索クエリ)に関する詳細なドキュメントを取得します。演算子、条件式、並び替え、ページングなどの使い方を説明します。 |
| create_form_layout | フィールド情報からフォームレイアウトを自動生成します |
| add_layout_element | 既存のフォームレイアウトに要素を追加します |
| create_group_layout | グループ要素を作成します |
| create_table_layout | テーブルレイアウトを作成します |
| get_users | kintoneのユーザー情報を取得します |
| get_groups | kintoneのグループ情報を取得します |
| get_group_users | 指定したグループに所属するユーザーの一覧を取得します |
| add_guests | ゲストユーザーを追加します |
| get_kintone_domain | kintoneの接続先ドメインを取得します |
| get_kintone_username | kintoneへの接続に使用されるユーザー名を取得します |
| download_file | kintoneアプリからファイルをダウンロードします。注意: 現在の実装では1MB以上のファイルは正常にダウンロードできない場合があります。 |
| upload_file | kintoneアプリにファイルをアップロードします |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |