sendsoon

SendSoon AI MCP

English | 简体中文 | 日本語

SendSoon MCP は、Codex、Claude、WorkBuddy から SendSoon の機能（メールの送信、公開 IP の検索、ローカルドキュメントの Markdown への変換）を利用できる Model Context Protocol (MCP) サーバーです。

一度設定すれば、あとは自然言語でタスクを説明するだけです。通常、毎回のプロンプトで SendSoon に言及する必要はありません。

できること

ツール	用途	例
send_email	1 通のメールを送信する	「テストメールを送って」
ip_lookup	公開 IP 情報を検索する	「8.8.8.8 の所在地を調べて」
markitdown_convert	ローカルドキュメントを Markdown に変換する	「この PDF を Markdown に変換して」

日常的な使用例

Send an email to [email protected] with the subject “Meeting reminder” and the body “The meeting starts at 3 PM today.”

Look up the location and ISP for 8.8.8.8.

Convert /path/to/report.pdf to Markdown and summarize the key points.

エージェントが自動的にツールを選択しない場合は、次のように指示してください。

Use the sendsoon MCP to complete this task.

AI クライアントにインストールする

以下の手順では、Codex、Claude Desktop、WorkBuddy を対象に説明します。

Codex

設定ファイル： ユーザーレベルの ~/.codex/config.toml（macOS / Linux）または %USERPROFILE%\.codex\config.toml（Windows）。

[mcp_servers.sendsoon]
command = "npx"
args = ["-y", "@sendsoon/mcp"]

[mcp_servers.sendsoon.env]
SENDSOON_API_KEY = ""

確認： ファイルを保存し、Codex を再起動して、チャットで /mcp を実行します。sendsoon が接続済みと表示されるはずです。デスクトップアプリでは、Settings > MCP servers も確認してください。

初回の使用： 新しい会話を開始し、簡単なタスク（例：「8.8.8.8 を調べて」）を依頼します。Codex が許可を求めた場合は、ツールの使用を承認してください。

Claude Desktop

設定ファイル：

OS	パス
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json

Claude Desktop 内の Settings > Developer > Edit Config から開くこともできます。

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": ["-y", "@sendsoon/mcp"],
      "env": {
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

確認： ファイルを保存し、Claude Desktop を完全に終了して（システムトレイからも終了して）、再度起動します。新しいチャットを開始し、ツールメニューまたは設定に sendsoon ツールが表示されることを確認してください。

初回の使用： 初めてツールを呼び出すとき、Claude がツールへのアクセスを承認するよう求める場合があります。続行を許可してください。

WorkBuddy

WorkBuddy では、コネクターの JSON を MCP Server Management に直接貼り付けて SendSoon を追加できます。

設定ファイル： %USERPROFILE%\.workbuddy-ai\mcp.json（Windows）または ~/.workbuddy-ai/mcp.json（macOS / Linux）。

1. WorkBuddy を開き、MCP Server Management に移動します。
2. Add MCP をクリックします。
3. 以下の JSON をエディターに貼り付けます。Key をお持ちの場合は SENDSOON_API_KEY を入力します。匿名トライアルの場合は空欄のままにします。
4. Save をクリックします。

{
  "mcpServers": {
    "sendsoon": {
      "command": "npx",
      "args": [
        "-y",
        "@sendsoon/mcp"
      ],
      "env": {
        "SENDSOON_API_KEY": ""
      }
    }
  }
}

スクリーンショットには、WorkBuddy のコネクターエディターが表示されています。上部に設定ファイルのパスがあり、エディターに sendsoon の JSON が貼り付けられています。保存後、MCP の一覧に戻り、sendsoon が接続済みであることを確認してください。

確認： 新しい会話を開始し、簡単なタスク（例：「8.8.8.8 を調べて」）を依頼します。WorkBuddy が許可を求めた場合は、ツールの使用を承認してください。

設定を準備する

任意の環境変数：

設定	必須	入力内容
SENDSOON_API_KEY	いいえ	未登録のトライアルでは空欄のままにします。1 つの公開 IP から、1 日に最大 3 通の無料テストメールを送信できます。継続して使用するには、生成した Key を入力します

実際の Key を Git にコミットしたり、他の人と共有したりしないでください。

API Key を取得する

1. SendSoon 登録ページで登録またはサインインします。
2. プロフィールを開き、API Key セクションで Key を生成します。
3. 1 回限り表示される ssk_live_... Key をすぐにコピーし、MCP の設定で SENDSOON_API_KEY として入力します。
4. 設定を保存し、MCP クライアントを再起動します。有効な Key を使ったリクエストでは、匿名 IP の 1 日あたりの上限を消費しません。

匿名利用の上限に達すると、send_email から登録して Key を設定するよう案内されます。無効または取り消された Key は拒否され、匿名利用の上限に切り替わることはありません。

Google Colab で試す

ローカル環境のセットアップを省略して、ブラウザーで ip_lookup、markitdown_convert、send_email を試せます。

このノートブックでは、これらの MCP ツールで使用されているものと同じ SendSoon HTTP API を呼び出します。

---

ビジュアルによるローカルテスト（MCP Inspector）

AI クライアントにインストールする前に、ブラウザーですべての 3 つのツールを表示して、手動で操作するには、MCP Inspector を使用してください。

Node.js 20 以降が必要です。ターミナルで以下のコマンドを実行すると、Inspector が Web UI を自動的に開きます。

npx @modelcontextprotocol/inspector npx -y @sendsoon/mcp

テスト方法

1. ターミナルに MCP Inspector Web is up and running と表示されるまで待ちます。ブラウザーが開かない場合は、ターミナルに表示された http://127.0.0.1:6274?... の URL を貼り付けます。
2. ページのヘッダーに Connected と表示されていることを確認します。
3. ページの右上にある Tools タブを開きます。
4. 左側のリストからツールを選択し、パラメーターを入力して Execute Tool をクリックします。
5. 右側の Results パネルで応答を確認します。失敗した場合は、error.code と error.message を調べます。

ライセンス

LICENSE を参照してください。