Sidemail

Sidemail Model Context Protocol（MCP）サーバー

Sidemail MCP サーバーは、Sidemail.io に Model Context Protocol（MCP）を統合し、VS Code の MCP エージェントモードやその他の MCP クライアントを通じて、Sidemail のトランザクションメール、連絡先、ドメイン、Messenger 機能にプログラムからアクセスできるようにします。

機能

• 送信ドメインを管理する
• トランザクションメールの送信をテストする
• 連絡先とグループを管理する
• Messenger の下書きを作成、更新、削除する
• 送信済みメールと連絡先を検索する

前提条件

• Node.js v18 以降
• Sidemail API Key

Microsoft VS Code のセットアップ（ガイド付き）

1. コマンドパレット（Ctrl/Cmd + Shift + P）を開きます。
2. “MCP: Add Server…” と入力して選択します。
3. "NPM Package" を選択します。
4. @sidemail/mcp と入力して確定します。
5. インストールを確定します。
6. Sidemail API キーを入力して確定します。

Microsoft VS Code のセットアップ（手動）

または、mcp.json 設定ファイルを変更して、手動でインストールできます。

1. コマンドパレット（Ctrl/Cmd + Shift + P）を開きます。
2. “MCP: Open User Configuration” と入力して選択します。
3. 以下の設定を追加して、変更を保存します。

{
	"servers": {
		"sidemail-mcp": {
			"type": "stdio",
			"command": "npx",
			"args": ["-y", "@sidemail/mcp"],
			"env": {
				"SIDEMAIL_API_KEY": "${input:sidemail-key}",
			},
		},
	},
	"inputs": [
		{
			"type": "promptString",
			"id": "sidemail-key",
			"description": "Sidemail API Key",
			"password": true,
		},
	],
}

Claude Desktop のセットアップ

設定ファイルを編集（または作成）します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

{
	"mcpServers": {
		"sidemail": {
			"command": "npx",
			"args": ["-y", "@sidemail/mcp"],
			"env": { "SIDEMAIL_API_KEY": "your-key" }
		}
	}
}

Cursor のセットアップ

~/.cursor/mcp.json を作成または編集します。

{
	"mcpServers": {
		"sidemail": {
			"command": "npx",
			"args": ["-y", "@sidemail/mcp"],
			"env": { "SIDEMAIL_API_KEY": "your-key" }
		}
	}
}

コマンドラインの使用方法

npx @sidemail/mcp

MCP サーバーのツール

ドメイン

• list-domains：すべての送信ドメインを一覧表示する
• create-domain：新しい送信ドメインを追加する
• delete-domain：送信ドメインを削除する

Messenger

• list-messenger-drafts：Messenger の下書きを一覧表示する
• get-messenger-draft：ID を指定して Messenger の下書きを取得する
• create-messenger-draft：Messenger の下書きを作成する
• update-messenger-draft：Messenger の下書きを更新する
• delete-messenger-draft：Messenger の下書きを削除する

グループ

• list-groups：すべての連絡先グループを一覧表示する
• create-group：新しい連絡先グループを作成する
• update-group：連絡先グループを更新する

連絡先

• create-or-update-contact：連絡先を作成または更新する
• query-contacts：フィルターを指定して連絡先を検索する
• find-contact：メールアドレスで連絡先を検索する
• delete-contact：連絡先を削除する

メール

• send-email：トランザクションメールを送信する（テスト専用）
• query-emails：送信済みメールを検索する