Mailgun Docs MCP Server

Mailgun Docs MCP Server とは？

Mailgun Docs MCP Server は、Mailgun のドキュメントサイト上にある無料の公開 MCP エンドポイントで、AI コーディングアシスタントが Mailgun のドキュメントを検索し、OpenAPI 定義を読めるようにします。読み取り専用で API キーは不要、メールを送信したりアカウントに触れたりすることはありません。

Mailgun は Sinch 傘下のメール API で、メールの送信、受信、検証、追跡に使われます。アシスタントと一緒に Mailgun 連携を書くとき難しいのは、エンドポイントのパス、パラメーター、リージョンごとのベース URL を正しく指定することです。このドキュメントサーバーは Mailgun 自身が公開している仕様から答えるため、アシスタントが書くコードは記憶ではなく最新のリファレンスに基づきます。

Mailgun Docs MCP Server の使い方

サーバーは Mailgun のドキュメントサイトでホストされているため、インストールも認証情報の設定も不要です。

https://documentation.mailgun.com/mcp

Streamable HTTP を使用します。私たちのプローブは匿名で接続でき、サーバーは「Docs MCP server」と名乗りました。

Claude Code

claude mcp add --transport http mailgun-docs https://documentation.mailgun.com/mcp

Claude Desktop と claude.ai

Settings > Connectors を開き、Add custom connector を選んで名前を「Mailgun Docs」とし、https://documentation.mailgun.com/mcp を貼り付けます。サインインの手順はありません。

Cursor

~/.cursor/mcp.json に次を追加します。

{
  "mcpServers": {
    "mailgun-docs": {
      "url": "https://documentation.mailgun.com/mcp"
    }
  }
}

VS Code

ワークスペースの .vscode/mcp.json に次を追加します。

{
  "servers": {
    "mailgun-docs": {
      "type": "http",
      "url": "https://documentation.mailgun.com/mcp"
    }
  }
}

Mailgun Docs MCP Server の主な機能

• documentation.mailgun.com でホスト。API キー、アカウント、OAuth なしで無料で使える。
• 設計上読み取り専用：サンドボックスにはネットワークアクセスがないため、Mailgun API の呼び出しやメール送信はできない。
• Mailgun のドキュメントページを全文検索。
• 公開されている OpenAPI 定義（Mailgun API、Validations Service、Email Preview API、Alerts）への構造化アクセス。
• エンドポイントの照会で、パラメーター、例、セキュリティ要件、米国（api.mailgun.net）と EU（api.eu.mailgun.net）のサーバー URL を取得。
• 「コードモード」設計：アシスタントは複数の照会を 1 つのサンドボックススクリプトにまとめるため、往復回数とコンテキスト消費を抑えられる。

Mailgun Docs MCP Server のツール

私たちのプローブでは 2 つの MCP ツールが返され、これらを通じて一連のドキュメント関数にアクセスします。

• describe-tools はサンドボックス関数の正確な TypeScript シグネチャを返します。アシスタントは最初のスクリプトの前に一度呼び出し、パラメーター名を推測せずに済みます。
• execute は、唯一のグローバルが tools であるサンドボックスで JavaScript を実行します。fetch、console、Node.js API はなく、すべての照会は次の関数を通じて行います。
  • listApis はサイトで公開されている API 定義を一覧表示します。
  • getEndpoints は 1 つの API のすべてのパスとメソッドを一覧表示します。
  • getEndpointInfo は 1 つのエンドポイントについて、パラメーター、例、セキュリティを含む詳細を返します。
  • getSecuritySchemes と getFullApiDescription は API の認証方式または完全な OpenAPI ドキュメントを返します。
  • search はドキュメントの内容を検索します。
  • submitFeedback は誤りや不足のあるドキュメントページを報告します。

Mailgun Docs MCP Server のユースケース

• 送信コードの作成：「Mailgun のドキュメントに基づいて、添付ファイル付きメッセージを送るエンドポイントと必須フィールドを教えて」
• リージョンの確認：「Mailgun の EU リージョンでホストしているドメインにはどのベース URL を使えばいい？」
• メールアドレス検証：「Validations Service で単一アドレスを検証するエンドポイントを探して、パラメーターを一覧にして」
• 認証の質問：「Mailgun API はどの認証方式を使っている？」
• アップグレード前に、既存の連携を最新のリファレンスと照らし合わせてレビュー。

Mailgun Docs MCP Server と代替ツールの比較

Mailgun は Mailgun MCP Server（@mailgun/mcp-server）も公開しています。これは Mailgun の API キーを使ってローカルで動作し、メール送信、統計の取得、ドメイン管理などの実際のアカウント操作を行います。Mailgun の MCP ページによると、このサーバーはローカル専用でホスト版は提供されていません。このページのドキュメントサーバーはその逆で、ホスト型、キー不要、ドキュメントのみです。開発中はドキュメントサーバーを、アシスタントにアカウントを操作させたいときはローカルサーバーを使います。

Mailgun Docs MCP Server のトラブルシューティング

• アシスタントが関数名をでっち上げる： まず describe-tools を呼ぶよう指示してください。ツールの説明はシグネチャを推測しないようモデルに求めています。
• 想定と違う API バージョンが返る： 複数の定義が同じタイトルを共有しています（Validations Service など）。結果の otherMatches に候補が示されるので、listApis が返す filePath を渡して選択してください。
• スクリプト内から Mailgun へのリクエストが失敗する： サンドボックスはネットワーク通信ができません。生成されたコードをプロジェクトにコピーし、自分のキーで実行してください。