Apidogが公開したオンラインAPIドキュメ��ントをApidog MCPサーバー経由でAIに接続する

Apidog MCPサーバーは、AIがApidogによって公開されたオンラインAPIドキュメントに接続し、利用することを可能にします。

この設定方法は、公開されたオンラインドキュメントのみをサポートし、パスワードやホワイトリスト設定があるドキュメントはサポートしていません。
非公開のドキュメントについては、プロジェクトIDと個人APIアクセス・トークンを使用してApidogプロジェクトデータを読み取ることをお勧めします。
詳細については、Apidogプロジェクト内のAPI仕様をApidog MCPサーバー経由でAIに接続するを参照してください。

オンラインドキュメントのMCP有効化

Apidogのバージョンは2.7.2以上である必要があります。

MCPサービスを有効化

Apidogプロジェクトに移動し、「Share Docs」→「Publish Docs Sites」→「AI Features」でMCPサービスを有効化します。

設定ファイルを取得

有効化後、オンラインドキュメントにアクセスすると「Vibe Coding(via MCP)」ボタンが表示されます。

ボタンをクリックすると、設定ガイドとMCP設定ファイルが表示され、ドキュメントのsite-idが自動的に含まれます。この設定をコピーしてIDEに統合するだけです。

MCPクライアントの設定

前提条件

Node.js環境がインストールされていること（バージョン18以上、最新のLTS推奨）

MCPをサポートする任意のIDE：

Cursor

VSCode + Cline拡張

その他

ApidogオンラインドキュメントからコピーしたMCP JSON設定

CursorでのMCP設定

MCP設定ファイルを編集

Cursorエディタを開き、設定アイコン（右上）をクリックし、左メニューから「MCP」を選択し、「+ Add new global MCP server」をクリックします。

設定を追加

オンラインドキュメントからコピーしたMCP JSON設定を開いたmcp.jsonファイルに貼り付けます：

macOS / Linux

Windows

{
  "mcpServers": {
    "apidog-site-123456": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456"
      ]
    }
  }
}

設定を確認

AIに（エージェントモードで）接続をテストします。例えば：

MCP経由でAPIドキュメントを取得し、プロジェクトに存在するAPIの数を教えてください。

AIが正しいAPI情報を返す場合、接続は成功しています。

重要な注意事項

異なるAPIドキュメントを扱う必要がある場合、設定ファイルに複数のMCPサーバー設定を追加するだけです。各APIドキュメントには固有の<site-id>が必要です。

オンプレミスデプロイメントのユーザーは、IDEのMCP設定にオンプレミスサーバーのAPIアドレスを含めてください："--apidog-api-base-url=<オンプレミスサーバーのAPIアドレス>"。また、www.npmjs.comへのネットワークアクセスが適切に行われていることを確認してください。

 {
  "mcpServers": {
    "apidog-site-123456": {
      "command": "npx",
      "args": [
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456",
        // オンプレミスデプロイメント用：
        "--apidog-api-base-url=<オンプレミスサーバーのAPIアドレス>"
      ]
    }
  }
}

他のデータリソースをAIに接続

Apidogプロジェクト内のAPI仕様をApidog MCPサーバー経由でAIに接続

Apidog MCPサーバーを介してOpenAPIファイルをAIに接続する

よくある質問

Windowsでの設定問題

Windowsで標準設定が失敗する場合、以下を使用してください：

{
  "mcpServers": {
    "apidog-site-123456": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "apidog-mcp-server@latest",
        "--site-id=123456"  // あなたのSite IDに置き換えてください
      ]
    }
  }
}

Node.jsのバージョン問題

AIが更新されたAPIドキュメントから最新データを読み取る方法

Apidogが公開したオンラインAPIドキュメントをApidog MCPサーバー経由でAIに接続する

オンラインドキュメントのMCP有効化#

MCPクライアントの設定#

前提条件#

CursorでのMCP設定#

重要な注意事項#

他のデータリソースをAIに接続#