Mailly

mailly-mcp

Mailly のコネクターを支える MCP サーバーと、Claude および Codex 用の Mailly プラグインです。

• src/：Cloudflare Worker である MCP サーバーです。Mailly のメール、下書き、送信、ドメイン、連絡先、テンプレート、キャンペーン、ワークフロー、Webhook 用の型付きツールを提供します。各ツールは呼び出し元の Mailly API キーを使って Mailly REST API を呼び出すため、認証、課金、ワークスペースの分離はすべて API 側で管理されます。
• ui/：MCP Apps の UI（メールと下書きのカード）です。ui:// リソースにバンドルされています。MCP_APPS=1 を設定しない限り無効です。
• plugins/mailly：Claude（claude.ai、Cowork、Claude Code）および Codex 用のプラグインです。ホスト済みサーバーを参照し、メールを安全に扱うためのスキルを追加します。

ホスト済みサーバーを使う

https://mcp.mailly.site/mcp をリモート MCP サーバーとして追加し、Mailly アカウントでサインイン（OAuth）してください。Claude Code では、代わりにプラグインをインストールできます。

/plugin install mailly --marketplace superagents-lab/mailly-mcp

このサーバーは OAuth で保護されたリソースです。Mailly の API（https://api.mailly.site/api/auth）が認可サーバーです。クライアントは /.well-known/oauth-protected-resource を通じて認可サーバーを見つけ、そこでユーザーをサインインさせて、アクセストークンをこのサーバーに送信します。サーバーはトークンまたは API キーを変更せずに Mailly REST API へ渡し、API がそれらと付与されているスコープを検証します。ツールの一覧は同じスコープに合わせて絞り込まれます（GET /me）。

自分で実行する

npm install
npm run dev          # wrangler dev on http://localhost:8787/mcp

Authorization: Bearer <your Mailly API key>（https://mailly.site/app/developers から取得）を指定して /mcp を呼び出します。MAILLY_API サービスバインディングがない場合は、インターネット経由で MAILLY_API_URL（デフォルトは https://api.mailly.site）を呼び出します。自分でコピーをホストするには、wrangler.jsonc の mcp.mailly.site ルートを変更してください。OAuth によるサインインは、Mailly がそのリソース向けのトークンを発行するため、https://mcp.mailly.site/mcp でのみ機能します。それ以外の場所では API キーを使用してください。

開発

npm run typecheck
npm test             # builds dist/worker.js and runs it in Miniflare against a stub API

Mailly サーバーのリポジトリでは、隣接するこのリポジトリのチェックアウトにある dist/worker.js に対して、OAuth とエンドツーエンドテストを実行します。

server.json は、MCP Registry に site.mailly/mcp として登録されているエントリーです。site.mailly 名前空間は mailly.site の DNS TXT レコードで所有権が証明されているため、キーを保持するマシンから mcp-publisher login dns --domain mailly.site --private-key <key> と mcp-publisher publish を実行して公開してください。リリースごとに version を更新してください。

ライセンス

MIT