elaan

@elaanio/mcp

Elaan 用の Model Context Protocol サーバーです。通知連携の面倒な作業をコンソールで手作業するのではなく、エディター内で行えます。通知タイプの作成、3 つのチャネル向けのテンプレート作成、テナントごとのブランド設定、メッセージが届かなかった原因の調査などが可能です。

ドキュメント： elaan.io/docs.html

セットアップ

コンソールで サービスキー（sk_…）を作成し、アシスタントの MCP 設定にサーバーを追加します。インストールは不要です。初回実行時に npx が取得します。

Claude Code — プロジェクト内の .mcp.json、またはすべてのプロジェクトで使う場合は ~/.claude.json：

{
  "mcpServers": {
    "elaan": {
      "command": "npx",
      "args": ["-y", "@elaanio/mcp"],
      "env": { "ELAAN_API_KEY": "sk_..." }
    }
  }
}

Cursor — .cursor/mcp.json に同じブロックを記述します。ほとんどの他の MCP クライアントも同じ形式です。

Elaan をセルフホストしていますか？独自のインストール先を指定してください：

"env": {
  "ELAAN_API_KEY": "sk_...",
  "ELAAN_API_BASE": "https://elaan.internal.example.com/v1"
}

できること

領域	ツール
通知タイプ	一覧表示、取得、作成、更新（チャネルのデフォルト、変数、オプトアウトポリシー）、削除、復元
テンプレート	メール／受信箱／プッシュ通知の一覧表示、取得、作成、更新、削除；メールのレンダリングをプレビュー；タイプの変数の影響を受けるテンプレートを報告
ブランド	一覧表示、作成、更新（値と送信者）、削除
連絡先	一覧表示、取得、作成、設定の読み取りと変更
送信	1～100 人の受信者に通知を送信
デバッグ	チャネルごとの結果を含むイベントのステータス、フィルター付き配信ログ、集計統計

希望する内容を伝えれば、必要な処理をまとめて実行します：

メールと受信箱に送る order_shipped タイプを、order_id 変数付きで作成し、acme ブランドを使って両方のテンプレートを作成してください。

お客様から、発送通知メールが届いていないと連絡がありました。イベント ID は 01J… です。何が起きましたか？

意図的に対応していないこと

トランスポートの認証情報。 /v1/email-transport と /v1/push-transport は一切公開されていません。これらには SMTP パスワードと FCM サービスアカウントが含まれており、エージェントが読み取ったりローテーションしたりするべきものではありません。コンソールで設定してください。

API キーの参照。 API キーは環境から読み取られ、ツールの引数として受け付けられることはありません。引数はモデルから参照でき、会話記録に残るためです。

なお、delete_template は復元できない完全削除ですが、delete_notification_type は restore_notification_type で元に戻せる論理削除です。trigger_notification は実際のメッセージを送信します。

開発

pnpm install
pnpm --filter @elaanio/mcp build
pnpm --filter @elaanio/mcp test    # spawns the server, speaks JSON-RPC to a stub API

このテストではソースをインポートするのではなく、stdio 経由で実際のバイナリーを実行します。これにより、プロセスを抜ける前にすべての create_notification_type 呼び出しが失敗する原因となっていた zod v4 の挙動を発見できました。

ライセンス

MIT