Zapmail MCP

🚀 Zapmail MCP Server

Zapmail API用のモデルコンテキストプロトコル（MCP）サーバーです。ドメイン管理、メールボックス操作、エクスポートに自然言語でアクセスできます。このパッケージにより、ClaudeなどのAIアシスタントが自然言語コマンドでZapmailとやり取りできます。

✨ 主な機能

• Zapmail APIを完全にカバー（46以上のツール）
• 自然言語コマンドの処理
• APIドキュメントからの動的ツール生成
• Reachinbox、Instantly、Smartlead、Reply.io、CSVへのエクスポートサポート
• TTL付きのキャッシュシステム
• レート制限とエラーハンドリング
• マルチワークスペースサポート
• Claude DesktopとCursorとのMCP統合

📦 インストール

オプション1: npxを使用する（推奨）

インストール不要で、npxで直接実行できます。

npx zapmail-mcp

オプション2: グローバルインストール

永続的にアクセスするためにグローバルにインストールします。

npm install -g zapmail-mcp

MCPの設定

Claude Desktop用

claude_desktop_config.jsonを作成または更新します。

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

npxを使用する場合（推奨）

{
  "mcpServers": {
    "zapmail": {
      "command": "npx",
      "args": ["zapmail-mcp"],
      "env": {
        "ZAPMAIL_API_KEY": "your-zapmail-api-key"
      }
    }
  }
}

グローバルインストールを使用する場合

{
  "mcpServers": {
    "zapmail": {
      "command": "zapmail-mcp",
      "args": [],
      "env": {
        "ZAPMAIL_API_KEY": "your-zapmail-api-key"
      }
    }
  }
}

Cursor用

CursorのMCP設定に追加します。

npxを使用する場合（推奨）

{
  "mcpServers": {
    "zapmail": {
      "command": "npx",
      "args": ["zapmail-mcp"],
      "env": {
        "ZAPMAIL_API_KEY": "your-zapmail-api-key"
      }
    }
  }
}

グローバルインストールを使用する場合

{
  "mcpServers": {
    "zapmail": {
      "command": "zapmail-mcp",
      "args": [],
      "env": {
        "ZAPMAIL_API_KEY": "your-zapmail-api-key"
      }
    }
  }
}

🚀 クイックスタート

1. Zapmail APIキーを取得する
   • Zapmailにサインアップします。
   • API設定に移動します。
   • 新しいAPIキーを生成します。
2. MCPクライアントを設定する
   • 好みのMCPクライアント（Claude DesktopまたはCursor）を選択します。
   • 上記の設定JSONをMCP設定に追加します。
   • your-zapmail-api-keyを実際のAPIキーに置き換えます。
3. 接続をテストする
   • MCPクライアントを開きます。
   • 次のような自然言語コマンドを試してみます。
     • "List all my Zapmail workspaces"
     • "Show me my domains"
     • "Check if example.com is available for purchase"

💻 使用例

基本的な使用法

ドメイン操作

ドメインの可用性を確認する

Claude DesktopまたはCursorで

"Check if example.com is available for 1 year"

ドメインを購入する

Claude DesktopまたはCursorで

"Buy example.com and test.com for 1 year using wallet if possible"

メールボックス管理

空のドメインにメールボックスを作成する

Claude DesktopまたはCursorで

"Create 5 mailboxes on domains that have zero mailboxes"

メールボックスを一括更新する

Claude DesktopまたはCursorで

"Update all mailboxes with new names and details"

エクスポート操作

Reachinboxにエクスポートする

Claude DesktopまたはCursorで

"Connect my Reachinbox account and export all mailboxes"

エクスポートガイダンスを取得する

Claude DesktopまたはCursorで

"Help me export 100 mailboxes to Reachinbox"

複雑なワークフロー

多段階操作

Claude DesktopまたはCursorで

"Buy example.com and test.com, create 5 mailboxes on each, and export to reachinbox"

ワークスペース管理

Claude DesktopまたはCursorで

"Show me all my workspaces and switch to the one with the most domains"

システムモニタリング

ヘルスチェック

Claude DesktopまたはCursorで

"Check the health of my Zapmail connection"

メトリクスを取得する

Claude DesktopまたはCursorで

"Show me performance metrics for my Zapmail operations"

高度な使用法

MCPクライアントに接続したら、自然言語でZapmailを制御できます。

ワークスペースとドメイン管理

• "List all my workspaces"
• "Show domains in current workspace containing 'lead'"
• "Check if leadconnectlab.com is available for 2 years"
• "Buy leadconnectlab.com and outreachprohub.com for 1 year using wallet if possible"

メールボックス管理

• "Create 3 mailboxes per domain where there are zero mailboxes"
• "Setup 100 mailboxes and connect to Instantly.ai for me"
• "Update all mailboxes with new names"

エクスポート操作

• "Export all mailboxes to reachinbox"
• "Export mailboxes to instantly"
• "Export mailboxes as CSV"
• "Export specific mailboxes"
• "Export mailboxes from leadconnectio.com domain"

サードパーティ統合

• "Connect reachinbox account"
• "Add instantly credentials"
• "Link smartlead account"
• "Setup reply.io integration"

利用可能なツール

コア管理ツール

• set_context - ワークスペースとプロバイダーのコンテキストを設定する
• wallet_balance - ウォレット残高を取得する
• list_workspaces - すべてのワークスペースをリストする
• list_domains - ワークスペース内のドメインをリストする
• check_domain_availability - ドメインの可用性を確認する
• purchase_domains - ドメインを購入する（ウォレット優先）
• create_mailboxes_for_zero_domains - 空のドメインにメールボックスを作成する
• add_third_party_account - サードパーティのエクスポートアカウントを追加する
• call_endpoint - 任意のZapmailエンドポイントを呼び出す
• generate_usernames - メールボックスのユーザー名を生成する
• generate_name_pairs - 名前のペアを生成する
• generate_domains - AIによるドメインの提案を生成する
• check_domain_availability_batch - バッチでドメインの可用性を確認する
• plan_and_execute - 自然言語での計画と実行
• get_server_info - サーバー情報を取得する

システム管理ツール

• get_metrics - システムメトリクスとパフォーマンスデータを取得する
• clear_cache - システムキャッシュをクリアする
• health_check - システムのヘルスチェックを行う

高度なメールボックスツール

• bulk_update_mailboxes - メールボックスを一括更新する
• search_mailboxes - 高度なフィルターでメールボックスを検索する

エクスポートシステムツール

• get_export_info - エクスポートシステムの情報を取得する
• get_export_scenario - エクスポートシナリオの指示を取得する
• validate_export_request - エクスポート要求のパラメーターを検証する
• export_guidance - エクスポートのガイダンスとベストプラクティスを取得する

APIドキュメントツール

• get_api_info - 包括的なAPIエンドポイント情報を取得する
• search_api_endpoints - キーワードでAPIエンドポイントを検索する
• get_api_scenarios - 一般的なAPI使用シナリオを取得する
• get_api_best_practices - APIのベストプラクティスと推奨事項を取得する
• generate_api_examples - APIの使用例を生成する

動的APIツール

すべてのドキュメント化されたAPIエンドポイントが自動的にツールとして生成されます。

トラブルシューティング

MCP接続問題

1. MCPサーバーが見つからない

問題: "zapmail-mcp command not found" または "npx zapmail-mcp not found" 解決策: npxを使用する場合

# npxを直接テストする
npx zapmail-mcp --version

# npxが失敗した場合は、明示的なパッケージバージョンで試す
npx zapmail-mcp@latest --version

# ヘルプ情報を取得する
npx zapmail-mcp --help

グローバルインストールを使用する場合

# パッケージをグローバルにインストールする
npm install -g zapmail-mcp

# インストールを確認する
zapmail-mcp --version

2. MCPクライアントがサーバーを検出しない

問題: ZapmailツールがClaude Desktop/Cursorに表示されない 解決策:

• MCPクライアント（Claude Desktop/Cursor）を再起動します。
• MCP設定ファイルの構文を確認します。
• 設定内のコマンドパスを検証します。

3. APIキーの問題

問題: "ZAPMAIL_API_KEY not configured" 解決策:

• MCP設定で環境変数を設定します。

{
  "mcpServers": {
    "zapmail": {
      "command": "npx",
      "args": ["zapmail-mcp"],
      "env": {
        "ZAPMAIL_API_KEY": "your-api-key"
      }
    }
  }
}

• またはグローバルに設定します。

export ZAPMAIL_API_KEY="your-api-key"

4. ワークスペースコンテキストの問題

問題: 間違ったワークスペースからデータを取得している 解決策: MCP設定でワークスペースを設定します。

{
  "env": {
    "ZAPMAIL_WORKSPACE_KEY": "your-workspace-id"
  }
}

パフォーマンス問題

1. 応答時間が遅い

問題: MCP操作に時間がかかりすぎる 解決策:

• キャッシュを有効にする: ZAPMAIL_ENABLE_CACHE="true"
• レート制限の遅延を増やす: ZAPMAIL_RATE_LIMIT_DELAY="2000"
• インターネット接続を確認する

2. レート制限

問題: "Too many requests" エラー 解決策: MCP設定でレート制限の遅延を増やします。

{
  "env": {
    "ZAPMAIL_RATE_LIMIT_DELAY": "2000"
  }
}

デバッグモード

詳細なトラブルシューティングのためにデバッグロギングを有効にします。

{
  "env": {
    "ZAPMAIL_LOG_LEVEL": "DEBUG"
  }
}

ヘルスチェック

MCP接続をテストします。 Claude DesktopまたはCursorで

"Check the health of my Zapmail connection"

一般的なMCP設定エラー

1. 無効なJSON構文

問題: MCPクライアントが設定を読み込めない 解決策: JSONバリデーターを使用してJSON設定を検証します。

2. 誤ったコマンドパス

問題: MCPクライアントで "Command not found" 解決策: 完全なパスを使用するか、zapmail-mcp がPATHに含まれていることを確認します。

3. 環境変数が読み込まれない

問題: APIキーがMCPサーバーに渡されない 解決策: MCP設定の env セクションを使用して、グローバル環境変数ではなく設定するようにします。

MCPの始め方

ステップ1: パッケージをインストールする

オプションA: npxを使用する（推奨） インストール不要で、npxを使用します。

npx zapmail-mcp

オプションB: グローバルインストール

npm install -g zapmail-mcp

ステップ2: Zapmail APIキーを取得する

1. Zapmailにサインアップします。
2. API設定に移動します。
3. 新しいAPIキーを生成します。
4. ワークスペースIDをメモします（オプションだが推奨）。

ステップ3: MCPクライアントを設定する

好みのMCPクライアントを選択し、上記の設定手順に従います。

ステップ4: 接続をテストする

MCPクライアントを開き、簡単なコマンドを試してみます。

• "List my Zapmail workspaces"
• "Show me my domains"

ステップ5: 高度な機能を探索する

接続したら、次のことができます。

• 自然言語でドメインとメールボックスを管理する
• サードパーティプラットフォームにエクスポートする
• 複雑な自動化ワークフローを設定する
• パフォーマンスとヘルスを監視する

パッケージ情報

属性	详情
パッケージ名	zapmail-mcp
バージョン	0.0.2
NPM	zapmail-mcp
GitHub	dsouzaalan/zapmail-mcp
ライセンス	MIT

コマンドラインオプション

MCPサーバーは次のコマンドラインオプションをサポートしています。

バージョン情報

npx zapmail-mcp --version
# または
npx zapmail-mcp -v

ヘルプ情報

npx zapmail-mcp --help
# または
npx zapmail-mcp -h

サポート

サポートや質問については、以下のことを行ってください。

• 上記のトラブルシューティングセクションを確認する
• MCP設定例を確認する
• ヘルスチェックで接続をテストする
• 詳細なエラー情報のためにデバッグロギングを有効にする
• 問題や議論のためにGitHubリポジトリを訪問する

コントリビュートする方法

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. 適用可能な場合はテストを追加する
5. プルリクエストを送信する

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

---

Made with ❤️ for the Zapmail community