kintone Documentation MCPサーバー(β)
kintone Documentation MCPサーバーとは
kintone Documentation MCPサーバーは、AIが最新のkintone公式ドキュメントやAPI情報を常に取得できるツールです。
kintone MCPサーバー
とは異なり、実際のkintone環境に対する操作は行いません。
次のようなユースケースに適しています。
- 利用する生成AIの学習時点に関係なく、常に最新の公式ドキュメントを利用したい。
- kintoneカスタマイズのベストプラクティスやコーディングガイドラインを理解したうえで回答してもらいたい。
- 生成AIプラットフォームの既存の検索ツールを使うより、消費するトークン数を抑えたAI開発をしたい。
クイックスタート
kintone Documentation MCPサーバーは、リモートサーバー版とパッケージ版の2種類を提供しています。
いずれも動作や機能は同じです。
リモートサーバー版
お好みの生成AIツールにhttps://mcp.cybozu.dev/mcpを指定するだけで利用できます。
Claudeの場合
- ClaudeのWeb版やDesktop版で、左パネルのカスタマイズから[コネクタ]を選択する。
- コネクタのURLフィールドに
https://mcp.cybozu.dev/mcpを記入する。
- [追加]を押して、追加されたことを確認する。
Claude Codeの場合
次のコマンドを実行する。
|
|
任意で、--scopeオプションを使って設定の適用範囲を指定できます。
上記のコマンドのように、省略した場合はlocalスコープ(現在のプロジェクト内でのみ有効)で追加されます。
設定方法の詳細は
Claude Codeの公式ドキュメント
を参照してください。
ChatGPTの場合
https://mcp.cybozu.dev/mcpを記入する。
[認証]で「認証なし」を選択する。
Cursorの場合
~/.cursor/mcp.json(グローバル設定)または.cursor/mcp.json(プロジェクト設定)に以下を追記する。
1
2
3
4
5
6
7
{
"mcpServers": {
"kintone-docs": {
"url": "https://mcp.cybozu.dev/mcp"
}
}
}
注意
ここで紹介しているAIツールは一例です。
設定方法は各製品の公式ドキュメントを参照してください。
また、ご利用の生成AIツールのセキュリティ設定によっては、リモートMCPサーバーを追加できない場合があります。
管理者の承認や設定変更が必要な場合もあります。
パッケージ版
Claudeを利用される場合は、次のMCPBファイルからインストールできます。
インストール手順は次のリンクを参考にしてください。
kintone MCPサーバーのインストール手順
- インストール形式はMCPBですが、処理自体はリモートサーバー側で行われます。
- パッケージ版は自動更新機能がないため、ご自身で最新になっているかを確認する必要があります。
フィードバックのお願い
kintone Documentation MCPサーバーは、生成AIによるkintone開発の体験向上を目的としたツールです。
日々cybozu developer networkをご利用していただいている皆さんのフィードバックをぜひお聞かせください。(所要時間:約3分)
リリースの目的、狙い
生成AIを活用した開発が増える中、AIにとって処理しやすい形でkintoneのドキュメントを提供することへのニーズが高まっています。
今回のkintone Documentation MCPサーバーは、生成AI活用時に直面する課題の解決で役立つよう提供しています。
解決する課題点
生成AIの学習データには学習時点までの情報しか含まれていないため、最近追加されたAPIの仕様を正確に出力できないケースがあります。
その結果、存在しないAPIや非推奨のAPI・書き方を使ったコードを生成してしまうことがあります。
また、kintone特有の開発方法やベストプラクティスに沿わない、ガイドライン違反な実装や動作しないコードが返ってくることもあります。
こうした問題を防ぐために毎回大量のドキュメントをコンテキストに貼り付ける方法もあるものの、トークン消費が課題となります。
利用時の注意事項
kintone Documentation MCPサーバーは生成AIモデルが使用するツールです。
利用する際は以下の点に注意してください。
- ご利用のモデルによって、回答やMCPツールの使い方が変わります。
- 最新のドキュメントを参照しても、生成AI側での扱い方は保証できないため、プロンプトで適切に誘導する必要があります。
- ツールを繰り返し呼び出すため、トークンの利用数増加の可能性があります。
- 過剰な呼び出しを防止するために、サーバー側でAI向けにツールの使い方を説明しています。
- トークンの利用数が気になる場合は、ご利用のAIツールでkintone Documentation MCPサーバーを無効にできます。
- モデルや設定によってはツールが利用されないこともあります。
その際はプロンプトに「ツールを使って調べてください」と明示すれば解決することが多いです。
ロードマップ
β版リリース時点では、次のツールを用意しています。
cybozu developer network内の記事を検索します。
-
search_docs
API仕様を全件検索する。 -
search_resources
その他の外部連携・SDK・ベストプラクティス関連記事を全件検索する。 -
get_page
特定のドキュメントのページをパスで取得する。
今後は、次の機能追加を検討しています。
-
check_updates
カスタマイズやプラグインのコードを提供すると、kintone APIの更新履歴を参照して該当する仕様変更があったかどうかを回答する。 -
plan_app
kintoneアプリの設計と構成案を提案する。
これらの機能と kintone MCPサーバー を併用することで、より高度なkintone開発用エージェントの実現を期待しています。
