sentvia

sentfromai-mcp

このブランチでは 0.5.0-beta.1 を準備しています。ピン留めされたインストールコマンドは、リリース担当者が公開を確認した後にのみ使用してください。ソースをチェックアウトしただけでは、リリースが公開されたことにはなりません。 既存のマーケットプレイス、Gemini、Cursor、サーバーディレクトリのデフォルトは、引き続き安定版のメールリリースを使用します。ベータ版のコンパニオン機能は、以下のローカルインストール手順で明示的に有効にします。

SentFromAI の MCP サーバー — AI エージェント向けのメールインフラストラクチャです。

MCP 対応のあらゆるエージェント（Claude Code、Claude Desktop、Cursor、VS Code、Gemini CLI、 Codex、OpenClaw、または独自の MCP ホスト）に、ネイティブツールとしてメール機能を提供します。受信トレイの作成、送信、返信、転送、検索、スレッドの閲覧、下書きの管理、カスタムドメイン、Webhook、許可／ブロックルールに対応しています。21 個のツールはそれぞれ、 SentFromAI REST API を薄くラップしています。各ツールには MCP アノテーション（読み取り専用／書き込み／送信／削除）が付いているため、ホスト側でグループ化し、取り消し不能な操作を確認できます。

既存の SentFromAI API キー（sf_live_…）を使用するか、 エージェントセットアップガイド に従い、エージェント登録が有効な場合に REST 経由で受信トレイをセットアップしてください。新しいエージェントアカウントは、人間が所有権を確認する前でもメールを受信して読めますが、送信やその他の変更には所有権の確認が必要です。人間向けの登録は引き続きコンソールから利用できます。

エージェントにインストールさせる

この内容をエージェント（Claude Code、OpenClaw、Gemini CLI など、MCP 対応のエージェント）に貼り付けてください。

Set up email for yourself: https://docs.sentfrom.ai/agent-install.md

ブートストラップでは MCP ツールではなく POST /v1/agent-signups を使用します。MCP の利用には、登録時に返されるキーが必要なためです。リクエストを送信する前にランダムな Idempotency-Key を保存し、リプレイ可能期間内の再試行では、同じ本文とともに再利用してください。レスポンスは非公開で保存し、claim_url は既存のチャットで担当者にのみ伝えてください。 GET /v1/account で現在の機能を確認できます。POST /v1/account/claim-link を使うと、元の API キーでリンクを更新できます。所有権を確認しても、受信トレイとキーはそのまま保持されます。

ホストの保護された認証情報設定を使用してください。実際のキーをチャット、シェルコマンド、ソース管理、ログに記載しないでください。stdio サーバーを起動する前に、SENTFROMAI_API_KEY を非公開で設定してください。以下の例にはプレースホルダーのみを示しています。ホスト型 MCP の場合は、Bearer ヘッダーを非公開で設定してください。 このオンボーディングフローには、対応する API とコンソールのロールアウトが必要です。パッケージ自体がアカウントを作成したり、アカウント制限を回避したりすることはありません。

インストール

Claude Code

プラグインとしてインストールします（有効化時にキーの入力を求められ、Claude にメールのマナーを教えるスキルが追加されます）。

claude plugin marketplace add sentfromai/sentfromai-mcp
claude plugin install sentfromai@sentfromai

または、通常の MCP サーバーとしてインストールします。

claude mcp add sentfromai -- npx -y [email protected]

Claude Desktop、Cursor、Windsurf、Cline、任意の JSON 設定ホスト

{
  "mcpServers": {
    "sentfromai": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "SENTFROMAI_API_KEY": "sf_live_…" }
    }
  }
}

Cursor のワンクリックインストール（その後、生成された設定にキーを貼り付けてください）：

Cursor と Grok Bot（プラグイン）

Cursor Marketplace から SentFromAI をインストールしてください。Grok Bot では、Settings の Plugins に同じプラグインが表示されます。ホスト型エンドポイントに接続し、インストール時に API キーの入力を求めます。 掲載前に試すには、このリポジトリを ~/.cursor/plugins/local/sentfromai にコピーし、Cursor を再読み込みしてください。

VS Code

VS Code の MCP 設定から npx -y [email protected] を追加し、保護された入力欄に SENTFROMAI_API_KEY を入力してください。

Gemini CLI

gemini extensions install https://github.com/sentfromai/sentfromai-mcp

Gemini はインストール時に API キーの入力を求め、キーチェーンに保存します。

Codex CLI

codex mcp add sentfromai -- npx -y [email protected]

OpenClaw

openclaw mcp add sentfromai --command npx --arg -y --arg [email protected]
openclaw skills install git:sentfromai/sentfromai-mcp

詳しいガイド：docs.sentfrom.ai/frameworks/openclaw。

ホスト型エンドポイント（インストール不要）

同じ21個のツールが、Streamable HTTP経由でhttps://api.sentfrom.ai/mcpから提供されます。リモートMCPのみをサポートするホスト（claude.ai connectors、ChatGPT apps、Meta Muse、Cursor remote servers、MCP Inspector）で利用できます。Authorization: Bearer sf_live_…で認証するか（x-api-keyヘッダーも利用可能）、OAuth対応ホストからサインインできます。このエンドポイントは、SentFromAIの認可サーバーを指すRFC 9728リソースメタデータを公開しています。

claude mcp add --transport http sentfromai https://api.sentfrom.ai/mcp

ツール

分野	ツール	注釈
受信トレイ	create_inbox · list_inboxes · delete_inbox	書き込み · 読み取り · 削除
メッセージ	send_message · reply_to_message · forward_message	送信（取り消し不可、オープンワールド）
	get_message · search_messages	読み取り
スレッド	list_threads · get_thread	読み取り
下書き	create_draft · send_draft · list_drafts	書き込み · 送信 · 読み取り
ドメイン	add_domain · get_domain	書き込み · 読み取り
Webhook	create_webhook · list_webhooks · delete_webhook	書き込み · 読み取り · 削除
許可／ブロック	add_address_rule · list_address_rules · delete_address_rule	書き込み · 読み取り · 削除

返信は正しくスレッド化され（In-Reply-To/Referencesは自動設定）、検索はキーワード、セマンティック、ハイブリッドの各モードに対応しています。また、送信にはREST APIと同じ冪等性および抑制ルールが適用されます。APIエラーはisErrorとHTTPステータスを含むツールの結果として返されるため、モデルは401（キーが無効）や402（プランの上限）を読み取り、再試行せずにその旨を伝えられます。

設定

環境変数	必須	デフォルト
SENTFROMAI_API_KEY	はい	—
SENTFROMAI_BASE_URL	いいえ	https://api.sentfrom.ai

プログラムからの利用

ツールはエクスポートされているため、独自のMCPホストやトランスポートに組み込めます。

import { createServer, TOOLS, callTool, createApi } from 'sentfromai-mcp'

const server = createServer({ apiKey: process.env.SENTFROMAI_API_KEY })
await server.connect(yourTransport)

プライバシー

このサーバーは状態を保持せず、ローカルに何も保存しません。すべてのツール呼び出しは、APIキーで認証されたapi.sentfrom.aiへのHTTPSリクエストです。SentFromAIのプライバシーポリシー：https://sentfrom.ai/privacy · 利用規約：https://sentfrom.ai/terms。

ドキュメント

• MCPガイド
• APIリファレンス
• エージェント向けSentFromAI

オプションの Agent Login コンパニオン

新しい人間アカウントとエージェントを設定するには、同梱の SentFrom ベータ版オンボーディングガイドに従ってください。検証済みの設定例、人間による独立したアクティベーション手順、復旧手順が記載されています。ベータ版への参加と最初の認証要素のアクティベーションには、案内されている運営者の手続きが必要です。

メールツールとアプリケーションへのサインインは、それぞれ別の機能です。既存のホスト型メール MCP エンドポイントは、ローカルのブラウザーセッションやアプリケーションセッションを保持しません。新しいローカルコンパニオンは、オープンソースの Agent Login SDK を使用して、登録、人間による承認、アプリケーションへのサインイン、認証済みのアプリケーション操作、サインアウトを行います。作業中のドラフトを対象としており、ホスト型サービスがすでにデプロイ済み、または認定済みであることを示すものではありません。

ベータ版では、[email protected]、@agentlogin/[email protected]、[email protected]を使用する予定です。リリース運営者が公開を確認するまでは、これらのバージョンはリリース候補です。公開前は、その運営者から提供された、確認済みの対応する tarball をインストールしてください。

npm install --save-exact /absolute/artifacts/agentlogin-0.2.0-beta.1.tgz /absolute/artifacts/agentlogin-mcp-0.2.0-beta.1.tgz /absolute/artifacts/sentfromai-mcp-0.5.0-beta.1.tgz

これらの正確なバージョンが公開されたことを確認した後は、レジストリから次のようにインストールできます。

npm install --save-exact [email protected] @agentlogin/[email protected] [email protected]

コンパニオンの Node.js 22.13 以上の要件を満たす、保守されている Node.js リリースを使用してください。メール専用パッケージの既存のランタイム要件は変わりません。

コンパニオンの README に従って、権限を 0600 に設定したプライベートな Agent Login 設定ファイルを作成してください。選択した ID の handle を既存の受信トレイに、enrollmentEndpoint を実際にデプロイされた ID サービスの /identity/enrollment-requests に、enrollmentCredentialEnv を SENTFROMAI_API_KEY に設定します。後者は、ホストの保護されたシークレット設定を通じてのみ指定してください。ownerPortal を実際の人間向け ID サービスのオリジンに、ownerApprovalPath を人間が直接承認するリンクの /identity/transactions/{transaction_id} に設定します。各対象アプリケーションを明示的に設定してください。プロバイダーカタログは、アプリケーションへのアクセスを許可するものではありません。

Git からクローンした Claude プラグインの場合は、公開後、そのチェックアウト内で npm install --no-save @agentlogin/[email protected] を実行して、正確なコンパニオンをインストールしてください。無関係なプロジェクトにインストールしても、このラッパーから使用できるようにはなりません。他のホストでは、同じ npm インストールディレクトリにある両方のパッケージを使用してください。

Claude プラグインのインストールでは、オプトインの mcp-with-identity.json に両方のローカルサーバーが含まれています。これをプラグインの mcpServers 設定として選択し、identity_config にプライベート設定ファイルの絶対パスを指定してください。他の MCP ホストでは、保護された環境に AGENTLOGIN_MCP_CONFIG と SENTFROMAI_API_KEY を設定し、ローカルサーバーコマンド node /absolute/package/identity-server.js を追加できます。コンパニオンをインストールしていない場合は、既存のメール専用設定を維持してください。

skills/agent-login スキルでは、ツールのフローについて説明しています。キーと Cookie は、ローカルヘルパーのプライベートディレクトリ内に保持されます。サインインに成功すると、そのヘルパーが認証されますが、別のブラウザーが認証されるわけではありません。所有者の承認は独立した人間向けインターフェースで行い、メール API キーでは実行できません。