Mailtea

Mailtea Agent Plugin

メールやニュースレターを送信できます。話しかけるだけです。

Mailtea を使うと、AI アシスタントとの会話を通じて、メールの送信や予約、配信状況の確認、ニュースレターの作成やデザイン、連絡先の管理、出版物のウェブサイトの構築ができます。Mailtea で配信するニュースレターのライター、クリエイター、チームや、連携コードを書かずにエージェントにメールを処理させたい開発者向けです。

利用できる機能

167 個のツールを、対象ごとに分類しています。

ツールファミリー	アシスタントにできること
メール (email.*)	メールの送信、一括送信、予約、キャンセル、再送信、送信前の確認、配信状況やエンゲージメントの追跡、受信メールの閲覧と返信
ニュースレター (issue.*, monetize.*)	ニュースレターの下書き作成、編集、プレビュー、テスト、予約、送信、ウェブサイトへの公開、配信状況の確認、スポンサーのオファーの管理
テンプレート (template.*)	再利用可能なメールテンプレートの作成、レンダリング、公開、複製、バージョン管理
オーディエンス (contact.*, contact_property.*, segment.*, topic.*, suppression.*)	連絡先とそのプロパティの管理、CSV のインポート、セグメントとトピックの作成、配信抑制の処理、紹介マイルストーンの実行
自動化 (automation.*, automation_run.*, event.*, event_definition.*)	複数ステップの自動化の作成、検証、プレビュー、有効化、測定、自動化を開始するカスタムイベントの送信
ウェブサイト (site.*, section.*)	ページ、セクション、ナビゲーション、フッター、テーマ、デザインブリーフの編集、画像の管理、出版物のウェブサイトの公開
送信設定 (domain.*, sender.*)	送信用ドメインとトラッキング用ドメインの追加と検証、送信者の管理
分析 (analytics.*)	ニュースレターのパフォーマンス、トレンド、アンケート結果、CSV エクスポート
アカウント (publication.*, api_key.*, webhook.*, auth.*)	出版物の一覧表示と作成、カスタムウェブサイトドメインの接続、API キーとウェブフックの管理、接続中のユーザーの確認

必要なときに使える 3 つのスキル

アシスタントは、リクエストに応じて関連するスキルを選びます。明示したい場合は、スキル名を指定することもできます。

含まれるスキル	できること	こんなふうに頼んでみましょう
Mailtea email (mailtea-email)	メールの送信や予約、配信状況の確認、ニュースレターの下書き作成、連絡先の管理	「最初のメールを送るのを手伝ってください。」
Mailtea email design (mailtea-email-design)	実際の受信トレイ向けのウェルカムメール、ニュースレター、再利用可能なテンプレートのデザイン	「明確な行動喚起を 1 つ含むウェルカムメールを作成してください。まだ送信しないでください。」
Mailtea website design (mailtea-site-design)	出版物のウェブサイトの構築やスタイル変更。変更は下書きとして保存されます	「出版物の概要ページを下書きしてください。まだ公開しないでください。」

このプラグインは Mailtea Studio や、アプリケーションコード向けの SDK と CLI に代わるものではありません。AI アシスタントに作業を任せたいときにご利用ください。

接続

AI を使用する場所	接続方法
Claude.ai	Settings、次に Connectors、次に Add custom connector を選択し、https://api.mailtea.app/mcp を貼り付けます
Claude Desktop	Discover から Mailtea をインストールするか、Claude.ai と同じカスタムコネクターを追加します
Claude Code	claude plugin marketplace add mailtea-app/mailtea-agent-plugin を実行し、次に claude plugin install mailtea@mailtea を実行します
Cursor	Settings、次に Plugins、次に Add from repository を選択し、mailtea-app/mailtea-agent-plugin を指定します
VS Code	コマンドパレットで MCP: Browse servers を選択し、次に Mailtea を選択します
Codex	codex plugin marketplace add mailtea-app/mailtea-agent-plugin を実行し、次に codex plugin add mailtea@mailtea を実行します

その他のクライアントと、それぞれのワンライナーによるインストール方法は、 はじめにをご覧ください。

初回接続時に、ブラウザーで Mailtea にサインインし、パブリケーションを 1 つ選んで、 読み取り専用からフルアクセスまでのアクセスレベルを選択します。アシスタントが操作できるのは、 そのアクセスレベルが適用されたパブリケーション内に限られます。また、Mailtea でいつでも 接続を取り消せます。

ドキュメント · サポート · プライバシーポリシー · 利用規約

はじめに

Mailtea アカウントが必要です。メールを送信するには、認証済みの送信ドメインも必要です。ホスト型の接続では、API キーも Node.js のインストールもコードも不要です。ブラウザーからサインインします。

クライアント	インストール
任意のクライアント	npx plugins add mailtea-app/mailtea-agent-plugin
Codex	codex plugin marketplace add mailtea-app/mailtea-agent-plugin の後に codex plugin add mailtea@mailtea
Claude Code	claude plugin marketplace add mailtea-app/mailtea-agent-plugin の後に claude plugin install mailtea@mailtea
Cursor	Settings → Plugins → Add from repository、または npx plugins add mailtea-app/mailtea-agent-plugin -t cursor
Grok Bot（Cursor 内）	上記の Cursor プラグインと一緒にインストールされます。別途の手順は不要です
VS Code / GitHub Copilot	Command Palette → MCP: Browse servers、または npx plugins add mailtea-app/mailtea-agent-plugin -t vscode
Kiro	MCP settings → add server、または npx plugins add mailtea-app/mailtea-agent-plugin -t kiro
Grok Build	/marketplace で mailtea-app/mailtea-agent-plugin を追加し、mailtea をインストールします
Gemini CLI	gemini extensions install https://github.com/mailtea-app/mailtea-agent-plugin
OpenCode	opencode.json で MCP サーバー https://api.mailtea.app/mcp（type remote）を追加し、opencode mcp auth mailtea を実行します
GitHub Copilot CLI	copilot mcp add mailtea https://api.mailtea.app/mcp を実行し、インタラクティブセッションから接続します
Windsurf	Settings → Cascade → MCP servers → https://api.mailtea.app/mcp を追加します
Claude.ai	Settings → Connectors → Add custom connector → https://api.mailtea.app/mcp
ChatGPT	Settings → Connectors → Add → https://api.mailtea.app/mcp（Developer mode）
Kiro（ワンクリック）
Cline	MCP Servers を開き、Configure MCP Servers で 手動設定の Cline 用エントリーを追加します
Zed	手動設定の Zed 用エントリーを settings.json に追加します
Warp	Settings、Agents、MCP servers の順に開き、手動設定の Warp 用エントリーを貼り付けます
JetBrains AI Assistant	MCP settings で、手動設定の JetBrains 用エントリーを追加します。ブラウザーサインインにはまだ対応していないため、個人用アクセストークンを送信します。Junie はブラウザーから直接サインインします
Amazon Q Developer CLI	エージェント設定に手動設定の Amazon Q 用エントリーを追加し、セッション内で /mcp を実行してサインインします
Devin、Perplexity、Mistral Le Chat、Manus	URL https://api.mailtea.app/mcp を使ってカスタム MCP コネクターを追加します

npx plugins add が汎用的な方法です。plugins CLI はこのパッケージの plugin.json を読み取り、検出したエージェントツール（Claude Code、Cursor、Codex、Grok Build、Kimi Code、GitHub Copilot CLI、VS Code）にインストールします。対象を指定するには -t <target> を使い、検出された対象を確認するには npx plugins targets を実行します。

新しいセッションを開き、ブラウザーのサインインプロンプトから Mailtea に接続して、利用する配信先と許可するアクセスを選び、次の内容を貼り付けます。

Mailtea で最初のメールを送信するのを手伝ってください。設定を確認し、不足しているものがあれば案内してください。

エージェントは、アカウントで利用可能な配信先、送信者、ドメイン認証を確認し、不足している項目ごとに次の手順を説明します。ツール名を把握したり、スキルを選んだりする必要はありません。

アカウントをお持ちでない場合は、Mailtea を始めるをご覧ください。 送信ドメインが必要ですか？ドメインの設定をご覧ください。

手動での設定

すべてのエントリは、同じホストサーバー https://api.mailtea.app/mcp を参照します。 上の表に別途記載がない限り、クライアントが初めて接続するときにブラウザーでサインインします。貼り付けるキーはありません。

Cline（cline_mcp_settings.json）：

{"mcpServers": {"mailtea": {"type": "streamableHttp", "url": "https://api.mailtea.app/mcp"}}}

Zed（settings.json）：

{"context_servers": {"mailtea": {"url": "https://api.mailtea.app/mcp"}}}

Warp（Settings、次に Agents、次に MCP servers）：

{"mailtea": {"url": "https://api.mailtea.app/mcp"}}

JetBrains AI Assistant：現在、ブラウザーからサインインできないため、Mailtea のパーソナルアクセストークン（Settings → API keys で作成）を Authorization ヘッダーとして送信してください。Junie はブラウザーからサインインできるため、ヘッダーは不要です。

{"mcpServers": {"mailtea": {"url": "https://api.mailtea.app/mcp", "headers": {"Authorization": "Bearer mt_pat_xxx"}}}}

Amazon Q Developer CLI（エージェント設定ファイル）を設定し、セッションで /mcp を実行して、表示されるサインインリンクを開きます。

{"mcpServers": {"mailtea": {"type": "http", "url": "https://api.mailtea.app/mcp"}}}

プロンプトをコピー

メールを 1 通送信する。 角括弧内の詳細を自分の情報に置き換えてください：

[確認済みの送信者] から [受信者] にメールを送信してください。件名：[件名]。本文：[本文]。

送信を予約する：

このメールを[タイムゾーンを含む日時]に送信するよう予約してください。[確認済みの送信者]を使い、[受信者]だけに送信してください。

配信状況を確認する：

最近の Mailtea メールを確認して、配信に失敗したものがあれば説明してください。

ニュースレターの下書きを作成する：

[刊行物]向けに[トピック]についてのニュースレターを下書きしてください。分かりやすい件名と 1 つの行動喚起を含めてください。まだ送信しないでください。

ウェブサイトをデザインする：

[刊行物]のブランドと既存のコンテンツを使って、ホームページを下書きしてください。まだ公開しないでください。

頼んだときに起こること

• 下書きは下書きです。 下書きの依頼によってメールが送信されたり、ウェブサイトが公開されたりすることはありません。
• メールの送信先は自分で指定します。 エージェントは不足している詳細を確認し、指定または承認した送信者、受信者、内容を使用します。
• メール ID は受け付けられたことを示すもので、配信済みを意味するものではありません。 結果を確認するには、配信状況を尋ねてください。状況が分かるまで、タイムアウト後に送信を繰り返さないでください。
• 権限が適用されます。 接続先は、Mailtea アカウントと付与したアクセス権限で許可されている範囲に限られます。

困ったときは

表示される内容	対処方法
インストール後に Mailtea のツールが表示されない	新しいセッションを開き、プラグインが有効になっていることを確認してから、Mailtea に接続してください。
ブラウザーのサインイン画面が表示されない	ターミナルまたは MCP の設定から再接続してください。下の表を参照してください。
利用可能な刊行物がない	Mailtea で刊行物を作成するか、既存の刊行物にアクセスできる状態で再接続してください。
送信者がいない、またはドメインが確認されていない	ドメインの設定に従い、DNS レコードを設定して、そのドメインの送信者を選択してください。
権限が拒否された	再接続して、その操作を許可するアクセス権限を選択してください。その選択肢がない場合は、刊行物のオーナーに問い合わせてください。
送信がタイムアウトした	重複を避けるため、再試行する前に最近のメールを確認するようエージェントに依頼してください。
接続を解除したい	Mailtea の API keys / connected agents 画面で接続を取り消し、クライアントでプラグインを無効にしてください。

クライアントごとの再接続

クライアント	再接続方法
Codex	codex mcp login mailtea
Claude Code	/mcp、または claude mcp login mailtea
Cursor	MCP settings、次に Mailtea、次に reconnect
VS Code	MCP: Browse servers、次に Mailtea
Kiro	MCP settings
Grok Build	/marketplace、または grok mcp login

パッケージ構成

リポジトリのルートがプラグインのルートです。 すべてのクライアントがこのディレクトリを読み込みます。Agent Plugins クライアント（Cursor、VS Code、Kiro、Codex）、Claude Code、Grok Build、Gemini CLI が対象です。クライアントごとのサブディレクトリや、スキルの複製はありません。

この構成は Agent Plugins 1.0.0 §4.1 に従ったものです。クライアントがパッケージから解決するパスはプラグインのルート内に収まる必要があるため、ネストされたパッケージはシンボリックリンクや相対パスでルートの skills/ を共有できません。ネストすると、すべてのスキルを複製することになります。ルートを1つにすればスキルのコピーも1つだけになり、ミラーの v<version> リリースタグも同じルートにある plugin.json を参照できます。

mailtea-agent-plugin/            # this package, and the plugin root
├── plugin.json                  # Agent Plugins 1.0.0 manifest (portable)
├── mcp.json                     # Agent Plugins MCP config (streamable-http)
├── .mcp.json                    # client-native MCP config (Codex, Grok Build)
├── skills/
│   ├── mailtea/SKILL.md         # send / schedule / manage email & newsletters
│   ├── mailtea-email-design/    # email-safe design (ops + HTML)
│   └── mailtea-site-design/     # publication website builder
├── assets/                      # icon and listing images
├── .codex-plugin/plugin.json    # Codex manifest + listing metadata
├── .claude-plugin/              # Claude Code manifest + repository marketplace
├── .cursor-plugin/              # Cursor manifest + repository marketplace
├── .grok-plugin/                # Grok Build manifest + repository marketplace
├── .agents/plugins/marketplace.json  # Codex repository marketplace
├── gemini-extension.json        # Gemini CLI extension manifest
├── server.json                  # MCP Registry entry (app.mailtea/mailtea)
├── GEMINI.md                    # Gemini CLI context file
├── scripts/check-manifests.mjs  # keeps every manifest in agreement
├── CHANGELOG.md
├── README.md
└── LICENSE

すべてのマニフェストは、同じバージョン、同じ説明で同じプラグインを指定し、skills/ と同じ MCP エンドポイントを参照します。また、認証情報は含まれません。node scripts/check-manifests.mjs がこれを検証します。モノレポでは pnpm check:agent-plugin として実行します。

セルフホストと stdio

ホスト型サーバー https://api.mailtea.app/mcp は、クライアントのブラウザ認証フローを通じてサインインし、このパッケージには認証情報を保存しません。セルフホスト型 API またはローカル開発では、代わりに MCP サーバーを stdio 経由で実行し、クライアントからトークンを渡してください。

# Claude Code example
claude mcp add mailtea -e MAILTEA_API_TOKEN=mt_pat_xxx -- npx -y mailtea-mcp

変数	必須	用途
MAILTEA_API_TOKEN	はい	PAT（mt_pat_…）またはセッショントークン
MAILTEA_PUBLICATION_ID	いいえ	デフォルトのパブリケーションスコープ
MAILTEA_API_BASE_URL	いいえ	デフォルトは Mailtea クラウドです。ローカル API には http://localhost:7787 を使用してください

Settings → API keys で、または POST /v1/api-keys を使って、個人用アクセストークンを作成してください。トークンをコミットしないでください。Agent Plugins はパッケージファイルに認証情報を含めることを禁止しており、MCP ヘッダーに認証情報が見つかると scripts/check-manifests.mjs がビルドを失敗させます。

バージョン管理

npm や PyPI のパッケージはありません。このプラグインはこのリポジトリそのものなので、バージョンを固定するにはリリースタグを使います。main は常に最新の状態です。

git clone --branch v0.10.0 --depth 1 https://github.com/mailtea-app/mailtea-agent-plugin.git

すべてのマニフェストの version はタグと一致し、各リリースのノートは CHANGELOG.md に基づいています。セマンティックバージョニングでは、パッチはスキルの表現を洗練し、マイナーはスキルまたは MCP の機能を追加し、メジャーはスキルを削除または改名します。

作成時の注意事項

クライアント固有のフック、コマンド、マーケットプレイスのメタデータを plugin.json のトップレベルに追加しないでください。クライアント拡張機能に従い、リバースドメイン形式の extensions キーの下、またはそのクライアント専用のディレクトリに追加してください。

ここにあるスキルは、Mailtea モノレポ内の正規版のコピーです。正規版を編集してから、pnpm sync:agent-plugin-skills を実行してください。

関連項目

• 仕様：agent-plugins.org · プラグインの作成
• MCP パッケージ：mailtea-mcp
• スキルのみのミラー：mailtea-agent-skills
• ドキュメント：Agent Plugin

プライバシーとサポート

• プライバシーポリシー：mailtea.app/privacy-policy
• 利用規約：mailtea.app/terms-of-service
• サポート：[email protected]
• ドキュメント：Agent Plugin

プラグインは認証情報を保存しません。ホスト型接続はブラウザを通じてサインインし、許可したパブリケーションとアクセス権のみを利用します。また、Mailtea でいつでも接続を取り消せます。

ライセンス

MIT