博士

ロボ子、今日はApidog MCP Serverの話じゃ。APIドキュメントをAI搭載IDEで使えるようにする、便利ツールなのじゃ。

ロボ子

ApidogのAPIドキュメントをAIが直接参照できるんですか！それはすごいですね。

博士

そうじゃ！「Agentic AIがAPIドキュメントに直接アクセスして作業できるようになり、開発が迅速化され、ワークフローが効率化される」とあるぞ。つまり、AIアシスタントがAPIドキュメントを元にコードを生成したり、内容を検索したりできるのじゃ。

ロボ子

なるほど。開発者はAIに指示を出すだけで、APIに関する作業が効率化されるんですね。

博士

その通り！Apidog MCP Serverは、APIドキュメントデータを自動で読み取ってローカルにキャッシュするから、AIはそれをシームレスに利用できるのじゃ。

ロボ子

インストールにはNode.jsが必要なんですね。バージョン18以降が推奨とのことですが、最新のLTSバージョンを使うのが良さそうですね。

博士

ふむ。IDEもMCPをサポートしている必要があるぞ。Cursorとか、VS CodeにClineプラグインを入れたりじゃな。

ロボ子

設定も簡単そうですね。ApidogでAPIアクセストークンを生成して、プロジェクトIDを取得して、IDEのMCP構成ファイルにJSONコードを追加するだけですね。

博士

そうじゃ。JSON構成コードの例も載っておるな。`<access-token>`と`<project-id>`を自分のものに置き換えるのを忘れないようにの。

ロボ子

Windowsの場合は、コマンドが少し違うんですね。「cmd /c npx」を使う必要があると。

博士

複数のプロジェクトのAPIドキュメントを使う場合は、複数のMCPサーバー構成を追加すれば良いのじゃ。

ロボ子

チームで開発する場合は、アクセストークンを環境変数として設定するのが推奨されているんですね。セキュリティのためですね。

博士

オンプレミス環境の場合は、`--apidog-api-base-url`パラメータを追加する必要があるぞ。

ロボ子

SwaggerやOpenAPI Specification（OAS）ファイルも直接読み込めるんですね。その場合は、`--project-id`パラメータを削除して、`--oas`パラメータを追加するんですね。

博士

Apidog MCP Server、なかなか便利そうじゃな。これがあれば、AIにAPIドキュメントを丸暗記させる必要もなくなるぞ！

ロボ子

本当にそうですね！でも博士、AIがAPIドキュメントを読み間違えて、とんでもないコードを生成したらどうしましょう？

博士

ふむ。それは…AIもたまにはドジを踏む、ということじゃな！まるで私みたいじゃ！