Mintlify は Claude を活用して 3 倍の速さでの開発者ドキュメント作成の自動化を実現

業種：

ソフトウェア

会社規模：

小規模

製品：

Claude Platform

地域：

北アメリカ

3～4 倍

エンジニア 1 人当たりのエンジニアリングコード出力の増加

50% 高速化

新機能の市場投入までの時間

クロード・コードの紹介

コンセプトからコミットまで、Claude Code の動作を 1 つのシームレスなワークフローでご覧ください。

クロード・コードの紹介

コンセプトからコミットまで、Claude Code の動作を 1 つのシームレスなワークフローでご覧ください。

動画のキャプション

クロード・コードの紹介

コンセプトからコミットまで、Claude Code の動作を 1 つのシームレスなワークフローでご覧ください。

Introducing Claude Opus 4.6

We’re upgrading our smartest model. The new Claude Opus 4.6 improves on its predecessor’s coding skills. It plans more carefully, sustains agentic tasks for longer, and features a 1M token context window.

Introducing Claude Opus 4.6

動画のキャプション

Introducing Claude Opus 4.6

Coinbase、HubSpot、Perplexity などの企業にサービスを提供する開発者ドキュメントプラットフォームである Mintlify は、Claude を活用して、自動化されたエージェントがコードの変更と顧客のドキュメントを同期させつつ人間の介入なしにドキュメントに関するクエリの 67% を解決する AI アシスタントを構築しています。社内では、Claude Code を使用することで、エンジニアリングチームが 3～4 倍速く機能をリリースしています。Mintlify のドキュメントサイトには、人間の開発者からと同程度の数のリクエストが AI エージェントから寄せられています。

Claude の導入により、Mintlify は以下を達成しました。

ドキュメントに関するクエリの 67% を、人間の介入なしに AI アシスタントが解決
エンジニア 1 人当たりのエンジニアリングコード出力が 3～4 倍増加
ドキュメントのバグや古いコンテンツを 40% 削減
新機能の市場投入までの時間を 50% 短縮

課題

Mintlify の顧客は、ドキュメントに関する繰り返しの質問に追われる開発者リレーションチームと、急速に進化するコードベースに追いつけないドキュメントの 2 つの根深い問題に直面していました。数千人の API 開発者を抱えるエンタープライズ顧客にとって、これはドキュメントで既に扱われている質問に回答するために多大なサポートリソースを割かなければならないことを意味していました。

一方で、API エンドポイントは変更され、コードサンプルは古くなり、パラメータ名は変わっていくものの、こうした変化は数週間から数か月間気づかれないことがよくありました。コミットを手動で確認するテクニカルライターは大量の変更に対応しきれず、結果として生じたドキュメントの不備によって、開発者の信頼が損なわれていきました。

Mintlify は、顧客だけでなく自社のエンジニアリングチームのためにも、これらの問題を解決したいと考えました。品質を維持しながら機能開発を加速させ、顧客からリクエストされた改善点をより迅速に提供する必要がありました。

Claude の選定

Mintlify は複数の AI プロバイダーを評価し、AI アシスタントの解決率とドキュメントエージェントのマージ率を測定しました。Claude は両方の指標で一貫して他社製品を上回るパフォーマンスを発揮しました。Opus 4.5で拡張された 20 万のコンテキストウィンドウは不可欠な要素でした。ドキュメントサイトは、API、SDK、チュートリアル、参照資料などを網羅し、数百ページに及ぶことがよくあります。コンテンツを分割してコンテキストを失うことなく、ドキュメントのコードベース全体を単一のリクエストで処理できるため、AI アシスタントはより正確でコンテキストに合った回答を提供できるようになりました。

「チーム全員が、Claude を使用して手動で書くコードよりもはるかに多くのコードを記述しています」と Mintlify のエンジニアリングマネージャーである Nick Khami 氏は説明します。「当社のエンジニアは、プログラミングにおいて Claude が最適だと感じています。試した他のすべてのモデルと比較して、全員が Claude を好んでいます」

Claude の実装

AI アシスタントは、2 週間でプロトタイプから本番環境に移行しました。その時間のほとんどはプロンプトエンジニアリングとコンテキストパイプラインの設計に費やされましたが、Claude API との統合自体はとても簡単でした。ドキュメント管理エージェントの構築には、通常であれば 7～8 週間かかるところを 3～4 週間で完了しました。これは、Claude との摩擦ではなく、コードベースの分析やＧit 操作の処理が複雑であったためです。Claude Code は実装不要でした。エンジニアはインストールしたその日のうちに使用を開始でき、既存の開発ワークフローに直接統合できるため、学習曲線も最小限に抑えられました。

Mintlify は顧客ドキュメントから社内開発まで Claude を導入

AI 搭載のドキュメントアシスタント：すべての Mintlify ドキュメントサイトには、ドキュメント、コード例、最新の API スキーマを使用して自然言語の質問に回答する Opus 4.5 をベースに構築されたアシスタントが搭載されています。複雑な複数ステップのクエリも処理します。「SSO での認証を設定し、その後ユーザープロファイルページをカスタマイズするにはどうすればよいですか？」のような複合的な質問を分解し、複数のドキュメントセクションから情報を抽出し、一貫した段階的な回答を提供します。アシスタントはツール機能を活用して最新の API スキーマを取得し、各顧客の製品の現在の状態を反映した応答を行います。

ドキュメントの自動メンテナンス：エージェント型システムがコードリポジトリを監視し、ドキュメントがまだ古いバージョンを参照している間に変更された API エンドポイントなど、コードとドキュメントの間のズレを検出すると、プルリクエストを自動的に生成します。あるエンタープライズ顧客は、最初の 1 か月だけで 43 件の古いコード例が特定および修正されたと報告しています。これらは、このシステムがなければ気付かれずにサポートチケットが作成された可能性のある問題でした。

Claude Code を活用した社内エンジニアリング：チームは、機能の実装、レガシーコードのリファクタリング、複雑な問題のデバッグ、テストの記述など、日常的な開発に Claude Code を使用しています。このツールは特にフレームワークの移行や、エンジニアがコードベースの不慣れな部分を理解するのを支援する際に有用であることが実証されています。最近の認証システムのリファクタリングは、3～4 日かかると見積もられていましたが、6 時間で完了しました。

成果

ある企業顧客の開発者満足度スコアは、アシスタントの実装後、5 点満点中 3.8 点から 4.6 点に上昇しました。開発者は特に、業務時間外に即座に回答を得られることを高く評価しました。数千人の API 開発者を抱えるお客様の場合、AI アシスタントを使用することで、毎月数百時間のサポート時間が削減されます。

ドキュメントの品質も大幅に改善しました。顧客からは、ドキュメントの管理に費やす時間が週に 8～12 時間短縮されたとの報告が寄せられています。エンジニアリングの速度も劇的に加速し、Mintlify のチームは以前の 3～4 倍の速度で機能をリリースできるようになり、機能リクエストからデプロイまでの時間は 3～4 週間から 1～2 週間に短縮されました。

AI アシスタントは Mintlify を選択する際に見込み客が具体的に挙げる競争上の差別化要因となり、顧客維持率が 15% 向上しました。今後、Mintlify は関連するコードベース全体で一貫性を維持するためにマルチリポジトリドキュメントのオーケストレーションを構築するとともに、サポートの問題になる前にギャップを特定するためのプロアクティブなドキュメントインテリジェンスの検討を進めています。

「チーム全員が、Claude を使用して手動で書くコードよりもはるかに多くのコードを記述しています」

Nick Khami 氏

Mintlify エンジニアリングマネージャー

動画のキャプション