​
MCP サーバーについて

Model Context Protocol（MCP）は、AI アプリケーションとドキュメントなどの外部サービスを標準化された方法で接続するためのオープンプロトコルです。Mintlify は、あなたのドキュメントと OpenAPI 仕様から MCP サーバーを生成し、Claude、Cursor、Goose などのあらゆる MCP クライアントがドキュメントや API に接続できるよう、より広範な AI エコシステム向けにコンテンツを整備します。 MCP サーバーは、AI アプリケーションがドキュメントを検索したり、API とやり取りしたりするためのツールを公開します。

​
MCP サーバーへのアクセス

MCP サーバーは公開ドキュメントに対してのみ生成されます。エンドユーザー認証の背後にあるドキュメントは、サーバー生成の対象にはなりません。
Mintlify はドキュメント用の MCP サーバーを自動生成し、ドキュメントの URL の /mcp パスでホストします。たとえば、Mintlify の MCP サーバーは https://mintlify.com/docs/mcp で利用できます。 ダッシュボードで MCP サーバーの URL を確認し、コピーできます。 /mcp パスはホストされる MCP サーバー用に予約されており、他のナビゲーション要素には使用できません。

​
MCP サーバーの設定

すべての MCP サーバーには標準で search ツールが含まれており、ユーザーは他のツールからドキュメント内の情報を検索できます。 Pro または Enterprise プランをご利用の場合、OpenAPI 仕様のエンドポイントを MCP ツールとして公開できます。 エンドポイントを MCP ツールとして公開するには、ファイル単位またはエンドポイント単位で、x-mint 拡張の mcp オブジェクトを使用します。たとえば、Mintlify の MCP サーバーには、アシスタントのチャット作成、ステータスの取得、更新のトリガーを行うツールが含まれます。 MCP サーバーはセキュリティを最優先とし、API エンドポイントは既定では公開されません。エンドポイントを MCP ツールとして利用可能にするには、明示的に有効化する必要があります。AI ツール経由での公開に適した、安全なエンドポイントのみを公開してください。
​
mcp
object
エンドポイントの MCP 設定。

​
ファイル単位の設定

OpenAPI 仕様ファイルで、デフォルトで全エンドポイントに MCP を有効にし、特定のエンドポイントのみを選択的に除外します: 
{
  "openapi": "3.1.0",
  "x-mint": {
    "mcp": {
      "enabled": true
    }
  },
  // ...
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": false // このエンドポイントでは MCP を無効にする
          }
        },
        // ...
      }
    }
  }
}

​
エンドポイント単位の設定

特定のエンドポイントで MCP を有効にします: 
{
  "paths": {
    "/api/v1/users": {
      "get": {
        "x-mint": {
          "mcp": {
            "enabled": true,
            "name": "get-users",
            "description": "Get a list of users"
          },
          // ...
        }
      }
    },
    "/api/v1/delete": {
      "delete": {
        // `x-mint: mcp` がないため、このエンドポイントは MCP ツールとして公開されません
        // ...
      }
    }
  }
}

​
MCPサーバーの利用方法

ユーザーは、普段使っているAIツールにあなたのMCPサーバーを接続する必要があります。
  1. MCPサーバーのURLを公開します。
  2. ユーザーがMCPサーバーのURLをコピーし、各自のツールに追加します。
  3. ユーザーはそのツールから、あなたのドキュメントやAPIエンドポイントにアクセスします。
ユーザーがあなたのMCPサーバーに接続しやすくするための方法は次のとおりです。
ドキュメントの任意のページからユーザーがあなたのMCPサーバーに接続できるように、コンテキストメニューにオプションを追加します。
OptionIdentifierDescription
Copy MCP server URLmcpユーザーのクリップボードにMCPサーバーのURLをコピーします。
Connect to CursorcursorCursorにMCPサーバーをインストールします。
Connect to VS CodevscodeVS CodeにMCPサーバーをインストールします。

​
例: Mintlify MCP サーバーへの接続

Mintlify MCP サーバーに接続して、Mintlify API を操作し、ドキュメントを検索します。これにより、ローカル環境での Mintlify の使い方に関するより正確な回答が得られ、あわせてユーザーが自分たちの MCP サーバーに接続する方法の参考にもなります。
このページ上部のコンテキストメニューから Connect to Cursor または Connect to VS Code を選択し、任意の IDE に Mintlify MCP サーバーを接続します。

​
認証

MCP 用に API エンドポイントを有効化すると、サーバーは OpenAPI の securitySchemes および securityRequirement に定義された認証要件を反映します。各種キーはツール側で直接取り扱われ、Mintlify によって保存・処理されることはありません。 ユーザーが AI ツールに保護されたエンドポイントの呼び出しを指示した場合、ツールはその時点で必要な認証情報の入力をユーザーに求めます。

​
MCPサーバーの監視

ダッシュボードのMCPサーバーページにあるAvailable toolsセクションで、利用可能なMCPツールをすべて確認できます。
「Available tools」セクションを強調したMCPダッシュボード

​
トラブルシューティング