meser10-mcp

Meser10 MCP サーバー

Meser10 のメールおよび SMS プラットフォームを、任意の MCP クライアント（Claude、Cursor、自作のエージェント）に接続します。

ヘブライ語のドキュメント（インストール手順付き）：https://www.meser10.co.il/features/mcp-server/

2026 年 9 月 19 日から公式 MCP Registry に掲載されています。io.github.meser10/meser10-mcp （v1.0.2、MIT）として登録されています。アカウント不要で、個別に確認できます。

https://registry.modelcontextprotocol.io/v0/servers?search=meser10

イスラエルのメール／SMS マーケティングプラットフォームが 2 つ、公式レジストリに掲載されています。こちらは、オープンソースとして公開され、パッケージとしてインストールできる唯一のものです。もう一方はリポジトリもパッケージもないリモートエンドポイントです。

ツールは稼働中の WSDL から生成されます。 61 個のツール定義を手作業で記述する必要はありません。そのため、サーバーはすべての API 機能を網羅し、プラットフォームに新しい操作が追加されても乖離しません。

クイックスタート

export MESER10_API_KEY=...      # issued in the Meser10 UI
export MESER10_USER_ID=...      # your account number - optional, see below
npx @meser10/mcp-server

MESER10_USER_ID は起動時に必須ではありません。61 個の操作のうち 17 個はキーだけで認証されます。残りの 44 個ではアカウント番号を明示的に指定する必要があり、設定されていない場合は明確なメッセージとともに失敗します。最初のグループだけを使うとわかっている場合を除き、設定してください。アカウント番号は識別子であり、秘密情報ではありません。Meser10 の UI で確認できます。

Claude Desktop／Claude Code：

{
  "mcpServers": {
    "meser10": {
      "command": "npx",
      "args": ["-y", "@meser10/mcp-server"],
      "env": { "MESER10_API_KEY": "...", "MESER10_USER_ID": "..." }
    }
  }
}

安全モデル

サーバーは読み取り専用で起動します。オプトインしない限り、費用が発生する操作、実在の人にメッセージを送る操作、レコードを削除する操作は実行できません。

MESER10_MODE	追加される機能	ツール
read (デフォルト)	Get* ファミリー	16
write	連絡先、グループ、キャンペーンの下書き	+27
send	実際の宛先に配信し、クレジットを消費します	+13
destructive	完全削除	+5

さらに 2 つのガード機能があります。

• MESER10_MAX_RECIPIENTS（デフォルトは 100）は、上限を超えるアドレスを対象とする送信を拒否します。モデルがプロンプトを読み違えても、リスト全体にメールを送信することはありません。
• 認証情報は注入され、公開されません。 oLogin と iUserID はすべてのツールスキーマから除外され、サーバーによって設定されます。モデルがこれらを見たり、推測したり、漏えいさせたりすることはできません。CLoginInfo は UserName／Password も受け取れますが、このサーバーは意図的に設定せず、ApiKey のみを使用します。

エラーについて知っておくべきこと

失敗時も含め、すべての操作が HTTP 200 を返します。成功かどうかはステータスコードではなく、CCallResult の Result フィールドで確認します。このサーバーは Result を読み取り、値が Success または PartialSuccess 以外の場合は例外をスローし、対処方法を添えます。

LoginFailed: bad key - MESER10_API_KEY was rejected. Reissue the key in the Meser10 UI and restart.

PartialSuccess は、バッチ内の一部のレコードが登録されなかったことを意味するため、通知されずに成功扱いされるのではなく、警告として示されます。

設計上の注意点

レガシー版は非表示です。 コントラクトには 5 つの機能に対して、5 組の Ex／Ex2 ファミリー（合計 15 操作）が公開されています。すべてを提供すると、モデルはよく似たツールから選ぶことになり、誤ったものを選ぶ可能性があります。最も機能が充実したバリアントを公開し、残りは MESER10_EXPOSE_LEGACY=true で非表示にしています。

呼び出し側にわかりやすい名前を付けています。 GetGroupsList はプラットフォームでの名称です。開発者が使うのは list_groups です。基盤となる操作名は常に説明に記載されるため、情報が隠されることはありません。

ハンガリー記法のプレフィックスは型ヒントになります。 saGroups は文字列の配列、eLang は列挙型、iUserID は int です。ジェネレーターはこれを使って、より適切なスキーマとわかりやすいタイトルを生成します。

トラブルシューティング

5 分前まで使えていたキーで LoginFailed が発生する場合。 プラットフォームは、認証に数回失敗すると、呼び出し元の IP をブロックします。ブロック期間は長く、3 時間 45 分を超えることもあります。エラーは Incorrect user name or password と表示されるため、誤ったキーを使った場合と区別できません。そのため、キーを再発行して再試行したくなりますが、事態を悪化させます。ブロック対象はキーではないため、新しいキーもブロックされます。

この問題が発生した場合は、呼び出しを停止して、待機してください。認証の再試行ループは設定しないでください。認証失敗を自動で再試行してはいけません。再試行がブロックを引き起こし、共有サーバーでは同じアドレスから送信するほかのすべての連携も停止させてしまいます。

NotEnoughPermissions。 キーが、設定した MESER10_USER_ID とは異なるアカウントに属しているか、そのアカウントは実在するものの、キーでアクセスできる範囲外にあります。プラットフォームがまったく解決できないアカウント番号の場合は、ApplicationError という別のエラーが発生します。そのため、このメッセージが表示された場合、その番号は存在しています。

ツールがステータスを返すものの、データがない場合。 1.0.0 で修正済みです。アップグレードしてください。

PartialSuccess。 バッチ処理の一部が反映されていません。サーバーはこれを成功として黙って処理するのではなく、警告として通知します。バッチ全体を再試行する前に、欠落しているレコードを確認してください。

サポート

[email protected] · 03-7440020 · 日曜日から木曜日、イスラエル時間 9:00～17:00。

操作名と、返された Result の値を記載してください。API キーは決して記載しないでください。どこかで共有してしまった場合は、キーを再発行してください。

開発

npm install && npm run build
npm test            # 43 unit tests + 12 end-to-end tests over real MCP stdio

E2E テストスイートは、プラットフォームのローカルな代替環境を実行するため、認証情報は不要で、データの送信も行いません。

ステータス

2026-09-12 に本番エンドポイントで読み取りモードの検証を実施済みです。ApiKey のみを使った認証、ツール一覧の取得、および一連の処理を通じたライブデータを返す 4 つの操作を検証しました。

また、WSDL の解析、スキーマの生成、安全性ゲート、エンベロープの構築、認証情報の注入、エラーのマッピング、受信者数の上限、および stdio 経由の MCP プロトコルもローカルで検証済みです。

書き込み、送信、削除の各操作は実装されており、代替環境に対するテストで網羅されています。このプロジェクトでは、本番アカウントに対してこれらの操作を意図的に一度も実行していません。