Getmailer MCP

🚀 GetMailer MCP Server

GetMailer 用のMCP (Model Context Protocol) サーバーです。ClaudeのようなAIアシスタントからトランザクションメールを送信できます。

🚀 クイックスタート

最も早く始める方法は、MCPを通じて直接サインアップすることです。

1. Claude DesktopにMCPサーバーを追加 (まだAPIキーは必要ありません):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"]
    }
  }
}

2. Claudeにサインアップを依頼する:

"email user@example.com とパスワード MyPassword123 でGetMailerにサインアップしてください"

3. ClaudeがAPIキーを返します。設定を更新します:

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"],
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

4. Claude Desktopを再起動 して、メール送信を開始しましょう！

📦 インストール

npm install -g getmailer-mcp

Claude Desktopでの設定 (既存ユーザー向け)

すでにAPIキーを持っている場合は、Claude Desktopの設定ファイルに以下を追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "getmailer": {
      "command": "npx",
      "args": ["getmailer-mcp"],
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

または、グローバルにインストールした場合は:

{
  "mcpServers": {
    "getmailer": {
      "command": "getmailer-mcp",
      "env": {
        "GETMAILER_API_KEY": "gm_your_api_key_here"
      }
    }
  }
}

✨ 主な機能

signup

Claudeから直接新しいGetMailerアカウントを作成します。APIキーを返し、確認メールを送信します。

重要: メールを送信する前に、メールアドレスを確認する必要があります。サインアップ後に受信トレイを確認してください！

パラメーター:

• email (必須): メールアドレス (使い捨てメールアドレスは不可)
• password (必須): パスワード (最小8文字、大文字、小文字、数字を含む必要があります)
• name: 名前 (オプション)

例:

私のメールアドレス developer@example.com でGetMailerにサインアップしてください

account_status

メールの確認状況、サブスクリプションプラン、送信制限などのアカウントの状態を確認します。

パラメーター: なし

例:

私のGetMailerアカウントの状態を確認してください

返り値:

• メールの確認状況
• サブスクリプションプランと残りのメール数
• 検証済みのドメインの数
• メールを送信できるかどうか
• 必要なアクション (メールの確認、ドメインの追加など)

send_email

トランザクションメールを送信します。

パラメーター:

• from (必須): 送信元メールアドレス
• to (必須): 受信者アドレスの配列
• subject (必須): メールの件名
• html: HTMLコンテンツ
• text: プレーンテキストコンテンツ
• cc: CC受信者
• bcc: BCC受信者
• replyTo: 返信先アドレス
• templateId: テンプレートID (html/textの代わりに使用)
• variables: テンプレート変数

例:

hello@myapp.com から user@example.com へ件名「Welcome!」でHTMLコンテンツ「<h1>Hello!</h1>」のメールを送信してください

list_emails

送信済みのメールをステータス情報とともにリスト表示します。

パラメーター:

• limit: 返すメールの数 (デフォルト: 20)
• cursor: ページネーションのカーソル

get_email

特定のメールの詳細を配信イベントを含めて取得します。

パラメーター:

• id (必須): メールID

list_templates

利用可能なメールテンプレートをリスト表示します。

create_template

新しいメールテンプレートを作成します。

パラメーター:

• name (必須): テンプレート名
• subject (必須): 件名 ( {{variables}} を含むことができます)
• html (必須): HTMLコンテンツ ( {{variables}} を含むことができます)
• text: プレーンテキストコンテンツ

list_domains

検証済みの送信ドメインをリスト表示します。

add_domain

新しい送信ドメインを追加します。

パラメーター:

• domain (必須): ドメイン名 (例: example.com)

設定が必要なDNSレコードを返します。

verify_domain

ドメインが検証されているかどうかを確認します。

パラメーター:

• id (必須): ドメインID

get_analytics

メールの分析情報と統計を取得します。

パラメーター:

• type: "summary" または "daily"
• days: 日次統計の日数

list_suppression

抑制リストに登録されているメールアドレスをリスト表示します。

パラメーター:

• limit: 返すエントリの数

add_to_suppression

メールアドレスを抑制リストに追加します。

パラメーター:

• emails (必須): メールアドレスの配列
• reason: MANUAL、BOUNCE、またはCOMPLAINT

create_batch

バッチメールジョブを作成します。

パラメーター:

• name (必須): バッチ名
• from (必須): 送信元アドレス
• recipients (必須): {to, variables} オブジェクトの配列
• subject: メールの件名
• html: HTMLコンテンツ
• text: プレーンテキストコンテンツ
• templateId: テンプレートID
• replyTo: 返信先アドレス

list_batches

バッチメールジョブをリスト表示します。

get_batch

特定のバッチジョブのステータスと進捗を取得します。

パラメーター:

• id (必須): バッチID

💻 使用例

設定が完了したら、Claudeに以下のように依頼できます。

• "notifications@myapp.com から user@example.com へ注文が出荷されたことを伝えるメールを送信してください"
• "最近送信したメールをリスト表示してください"
• "メール abc123 のステータスを確認してください"
• "パスワードリセット用のメールテンプレートを作成してください"
• "過去1週間のメール分析情報を表示してください"
• "user@spam.com を抑制リストに追加してください"

🔧 技術詳細

環境変数

• GETMAILER_API_KEY: GetMailerのAPIキー (サインアップ時はオプション、その他のツールでは必須)
• GETMAILER_API_URL: カスタムAPI URL (デフォルト: https://getmailer.app)

APIキーの取得方法

オプション1: MCP経由でサインアップ (おすすめ)

• Claudeから直接 signup ツールを使用します - ウェブブラウザは必要ありません！

オプション2: ウェブ経由でサインアップ

1. getmailer.app でサインアップします。
2. API Keys にアクセスします。
3. 新しいAPIキーを作成します。

📚 ドキュメント

• ドキュメント: getmailer.app/docs
• 問題報告: GitHub Issues