Resend Email
resmiResend API'sini kullanarak doğrudan editörünüzden e-posta gönderin.
Resend Email MCP ile neler yapabilirsiniz?
- E-posta gönderme ve zamanlama — Asistanınızdan CC/BCC, yanıt adresi, ekler ve etiketlerle HTML veya düz metin e-posta göndermesini ya da gönderimi zamanlamasını isteyin.
- Kişileri ve segmentleri yönetme — Kişiler oluşturun, güncelleyin ve kaldırın; segment üyeliklerini ve konu aboneliklerini yönetin, CSV içe aktarımları çalıştırın.
- Toplu e-posta kampanyaları yürütme — Toplu e-postalar oluşturun, zamanlayın, gönderin veya iptal edin; ardından alıcıları etkinlik türüne ve tıklanan bağlantılara göre inceleyin.
- Gelen e-postaları ve gelen kutularını yönetme — Alınan e-postaları listeleyin ve okuyun, ekleri indirin; gelen kutusu ileti dizilerini, etiketleri ve taslakları yönetin.
- Alan adlarını ve engelleme listelerini yönetme — Gönderen alan adları oluşturun, doğrulayın ve yapılandırın; engelleme listesi girdileri ekleyin veya kaldırın.
- Günlükleri ve kullanımı inceleme — Tam istek ve yanıt gövdeleriyle API istek günlüklerini inceleyin; hesap kullanımını ve kotayı kontrol edin.
Barındırılan MCP Sunucusu
npx add-mcp 'https://mcp.resend.com/mcp'Claude Code, Codex, Cursor ve daha fazlasına kurulur
Dokümantasyon
Resend MCP Server
AI aracınızı Resend platformuna bağlayın. Claude, Cursor veya Claude Code gibi herhangi bir MCP istemcisinden doğrudan e-posta gönderip alın; kişileri, toplu gönderimleri, alan adlarını ve daha fazlasını yönetin.
Resend tarafından barındırılan bir uzak MCP sunucusu ve bir yerel MCP sunucusu (bu paket) sunuyoruz.
Uzak MCP Sunucusu
Resend, MCP sunucusunu şu adreste barındırır:
https://mcp.resend.com/mcp
Uzak sunucuları (Streamable HTTP) destekleyen herhangi bir MCP istemcisini bağlayın. Yüklenecek bir şey veya çalıştırılacak yerel bir süreç yoktur; bu nedenle Claude gibi web tabanlı istemciler ve barındırılan aracı platformları için en iyi seçenektir.
Bağlandığınızda istemciniz, Resend'de oturum açmanız ve OAuth kullanarak erişimi onaylamanız için bir tarayıcı penceresi açar.
Claude Code
claude mcp add --transport http resend https://mcp.resend.com/mcp
Ardından Claude Code'da /mcp komutunu çalıştırın ve OAuth oturum açma işlemini tamamlamak için resend seçeneğini belirleyin.
Claude
Claude'da (web veya masaüstü), Settings > Connectors > Add custom connector bölümünü açın ve şunu girin:
https://mcp.resend.com/mcp
Cursor
Komut paletini açın ve "Cursor Settings" > "MCP" > "Add new global MCP server" seçeneklerini belirleyin.
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp"
}
}
}
Codex
codex mcp add resend --url https://mcp.resend.com/mcp
Copilot
VS Code'da GitHub Copilot'ı kullanmak için aşağıdakini settings.json dosyanıza ekleyin:
{
"mcp": {
"servers": {
"resend": {
"type": "http",
"url": "https://mcp.resend.com/mcp"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
}
Warp
Warp'ın Settings bölümünde Agents > MCP servers yolunu izleyin ve yeni bir sunucu eklemek için +Add seçeneğine tıklayın.
{
"resend": {
"serverUrl": "https://mcp.resend.com/mcp"
}
}
API anahtarıyla kimlik doğrulama
İstemciniz tarayıcıda oturum açmanın mümkün olmadığı bir yerde çalışıyorsa (sunucu, CI veya başsız bir aracı gibi), OAuth kullanmak yerine Resend API anahtarını Bearer token olarak iletin.
Claude Code:
claude mcp add --transport http resend https://mcp.resend.com/mcp --header "Authorization: Bearer re_xxxxxxxxx"
JSON yapılandırması (Cursor, Windsurf ve diğerleri) için bir Authorization başlığı ekleyin:
{
"mcpServers": {
"resend": {
"url": "https://mcp.resend.com/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Yerel MCP Sunucusu
Barındırılan sunucu, NPM'de resend-mcp olarak sunulan açık kaynak kodun aynısını çalıştırır. Sunucuyu kendiniz çalıştırmayı tercih ederseniz, npx kullanarak desteklenen herhangi bir MCP istemcisine entegre edebilirsiniz. Şunları yapmanız gerekir:
Yerel sunucu iki aktarım modunu destekler: stdio (varsayılan) ve HTTP.
Başlamak için aşağıdan tercih ettiğiniz modu ve istemciyi seçin. re_xxxxxxxxx değerini gerçek API anahtarınızla değiştirmeyi unutmayın.
Stdio Aktarımı (Varsayılan)
Hızlı Kurulum
Algılanan/seçilen tüm aracı ve düzenleyiciler için yükleyin:
npx add-mcp resend-mcp --name resend --env "RESEND_API_KEY=re_xxxxxxxxx"
Claude Code
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- npx -y resend-mcp
Codex
codex mcp add resend \
--env RESEND_API_KEY=re_xxxxxxxxx \
-- npx -y resend-mcp
Cursor
Komut paletini açın ve "Cursor Settings" > "MCP" > "Add new global MCP server" seçeneklerini belirleyin.
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Claude Desktop
Claude Desktop ayarlarını açın > "Developer" sekmesi > "Edit Config".
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Copilot
VS Code'da GitHub Copilot'ı kullanmak için aşağıdakini settings.json dosyanıza ekleyin:
{
"mcp": {
"servers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
}
Gemini CLI
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
OpenCode
opencode.json yapılandırmanıza ekleyin:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"resend": {
"type": "local",
"command": ["npx", "-y", "resend-mcp"],
"enabled": true,
"environment": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Windsurf
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Devin
Devin'de Settings > Connections > MCP Servers bölümünü açın ve Add a custom MCP seçeneğine tıklayın. Adım adım tüm yönergeler için Devin kılavuzuna bakın.
{
"mcpServers": {
"resend": {
"command": "npx",
"args": ["-y", "resend-mcp"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx",
"SENDER_EMAIL_ADDRESS": "onboarding@resend.dev"
}
}
}
}
HTTP Aktarımı
Resend'in barındırılan uzak MCP sunucusunu kullanmak yerine, örneğin kendi tünelinizin veya ters proxy'nizin arkasında, uzak ya da web tabanlı entegrasyonlar için sunucuyu HTTP üzerinden çalıştırın. HTTP modunda her istemci, Resend API anahtarını Authorization başlığında Bearer token olarak ileterek kimlik doğrulaması yapar.
Sunucuyu başlatın:
npx -y resend-mcp --http --port 3000
Sunucu http://127.0.0.1:3000 üzerinde dinler ve Streamable HTTP kullanarak MCP uç noktasını /mcp adresinde sunar.
Claude Code
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor
Komut paletini açın ve "Cursor Settings" > "MCP" > "Add new global MCP server" seçeneklerini belirleyin.
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
Bağlantı noktasını MCP_PORT ortam değişkeniyle de ayarlayabilirsiniz:
MCP_PORT=3000 npx -y resend-mcp --http
Kitaplık olarak kullanma
HTTP aktarımı da dışa aktarılır; böylece CLI üzerinden çalıştırılmak yerine başka bir hizmete gömülebilir. Bağlanan her istemci, kendi Resend API anahtarını Bearer token olarak ileterek kimlik doğrulaması yapar.
import { runHttp } from 'resend-mcp/http';
// Options are optional — pass `senderEmailAddress` / `replierEmailAddresses`
// to set defaults. Binds the port and returns the Node http.Server, exposing
// the MCP endpoint at POST/GET/DELETE /mcp and a GET /health check.
const server = await runHttp({}, 3000);
Varsayılan olarak sunucu, yalnızca localhost için Host doğrulaması uygular (DNS yeniden bağlama koruması). Ters proxy veya yük dengeleyici arkasında dağıtım yaparken, sunucu her istek için Bearer API anahtarıyla korunuyorsa, proxy'nin ilettiği Host ve yük dengeleyici sağlık denetimlerinin 403 Invalid Host ile reddedilmemesi için host değerini 0.0.0.0 olarak ayarlayın:
const server = await runHttp({}, 3000, { host: '0.0.0.0' });
// or pin specific hostnames instead of disabling validation:
const server = await runHttp({}, 3000, { allowedHosts: ['mcp.example.com'] });
CLI üzerinden bu, --host / --allowed-hosts (veya MCP_HOST /
MCP_ALLOWED_HOSTS) değerlerine karşılık gelir.
Seçenekler
Yerel sunucuyu yapılandırmak için ek bağımsız değişkenler iletebilirsiniz:
--key: Resend API anahtarınız (yalnızca stdio modunda; HTTP modu istemciden gelen Bearer token'ı kullanır)--sender: Doğrulanmış bir alan adından varsayılan gönderen e-posta adresi--reply-to: Varsayılan yanıt adresi e-posta adresi (birden çok kez belirtilebilir)--http: stdio yerine HTTP aktarımını kullan (varsayılan: stdio)--port:--httpkullanılırken HTTP bağlantı noktası (varsayılan: 3000 veyaMCP_PORTenv var)--host:--httpkullanılırken DNS yeniden bağlama koruması için ana bilgisayar (varsayılan:127.0.0.1veyaMCP_HOST). Proxy/yük dengeleyici arkasındaHostdoğrulamasını devre dışı bırakmak için0.0.0.0olarak ayarlayın.--allowed-hosts:--http(veyaMCP_ALLOWED_HOSTS) kullanılırken virgülle ayrılmışHostizin listesi--allowed-file-dirs: Yerel dosya eklerinin ve CSV içe aktarımlarının okunabileceği, virgülle ayrılmış dizinler (veyaMCP_ALLOWED_FILE_DIRS). Ayarlanmadığında stdio'da kısıtlama yoktur; ayarlanmadığı sürece--httpüzerinden her zaman devre dışıdır.
Ortam değişkenleri:
RESEND_API_KEY: Resend API anahtarınız (stdio için gereklidir; HTTP için isteğe bağlıdır, çünkü istemciler anahtarı Bearer token olarak iletir)SENDER_EMAIL_ADDRESS: Doğrulanmış bir alan adından varsayılan gönderen e-posta adresi (isteğe bağlı)REPLY_TO_EMAIL_ADDRESSES: Virgülle ayrılmış yanıt adresi e-posta adresleri (isteğe bağlı)MCP_PORT:--httpkullanılırken HTTP bağlantı noktası (isteğe bağlı)MCP_HOST:--httpkullanılırken DNS yeniden bağlama koruması için ana bilgisayar (isteğe bağlı)MCP_ALLOWED_HOSTS:--httpkullanılırken virgülle ayrılmışHostizin listesi (isteğe bağlı)MCP_ALLOWED_FILE_DIRS: Yerel dosyaların okunabileceği, virgülle ayrılmış dizinler (isteğe bağlı)
[!NOTE] Gönderen e-posta adresi belirtmezseniz MCP sunucusu, aracı her çağırdığınızda sizden bir adres girmenizi ister.
[!WARNING]
send-email(attachments[].filePath) vecreate-contact-import(filePath) yerel dosyaları okur.--httpüzerinden bu özellik varsayılan olarak devre dışıdır; böylece uzak istemciler sunucunun diskini okuyamaz. Belirli dizinlere izin vermek için--allowed-file-dirskullanın. stdio'da, istemi kötüye kullanan bir aracının seçtiğiniz klasörlerin dışındaki dosyaları eklemesini önlemek için--allowed-file-dirsayarını yapın.
MCP Sunucusu Araçları
Resend'in MCP sunucusu, tek bir entegrasyon aracılığıyla AI aracınıza Resend platformunun tamamına yerel erişim sağlar. E-posta altyapınızın tüm yönlerini doğal dil kullanarak yönetebilirsiniz.
- E-postalar: E-posta gönderin, listeleyin, alın, iptal edin, güncelleyin, paylaşın ve toplu olarak gönderin. Teslimat ve etkileşim ölçümlerini alın. HTML, düz metin, ekler (yerel dosya, URL veya base64), CC/BCC, yanıt adresi, zamanlama, etiketler, özel başlıklar, konu tabanlı gönderim ve idempotency anahtarlarını destekler.
- Alınan E-postalar: Gelen e-postaları listeleyin ve okuyun. Alınan e-posta eklerini listeleyin ve indirin.
- Gelen Kutuları: Gelen kutuları oluşturun, listeleyin, alın, güncelleyin ve kaldırın. Gelen kutusu aracısı ayarlarını okuyun ve güncelleyin. Konuları listeleyin, arayın, alın, güncelleyin ve kaldırın; etiketlerini ekleyin, ayarlayın veya kaldırın. Konu e-postalarını listeleyin ve alın; ekler ve özel başlıklarla yanıtlayın veya iletin. Etiketler oluşturun, listeleyin, güncelleyin ve kaldırın. Taslakları oluşturun, listeleyin, alın, güncelleyin, kaldırın ve gönderin; base64 içeriğinden veya URL'den ekler ekleyin. Bir konu başlatmak için gelen kutusundan yeni bir e-posta gönderin. Yanıtlama, iletme, taslak oluşturma, taslak gönderme ve yeni e-posta gönderme işlemlerinde idempotency anahtarlarını destekler.
- Şablonlar: E-posta şablonları oluşturun, listeleyin, alın, güncelleyin, yayımlayın, çoğaltın ve kaldırın. Şablon içeriği oluşturmayı ve
{{{VARIABLE}}}yer tutucularını destekler. - Kişiler: Kişiler oluşturun, listeleyin, alın, güncelleyin ve kaldırın. Segment üyeliklerini, konu aboneliklerini ve CSV kişi içe aktarımlarını yönetin. Özel kişi özelliklerini destekler.
- Toplu Gönderimler: Toplu gönderim kampanyaları oluşturun, gönderin, iptal edin, çoğaltın, listeleyin, alın, güncelleyin ve kaldırın. Bir toplu gönderimin tıklanan bağlantılarını ve alıcılarını etkinlik türüne göre (gönderildi, teslim edildi, açıldı, tıklandı, geri döndü, şikâyet edildi, abonelikten çıkıldı, engellendi) listeleyin. Zamanlamayı, kişiselleştirme yer tutucularını ve önizleme metnini destekler.
- Otomasyonlar: Otomasyonlar oluşturun, listeleyin, alın, güncelleyin, çoğaltın ve kaldırın. Bir otomasyonun çalıştırmalarını inceleyin.
- Etkinlikler: Bir kişi için otomasyonları tetiklemek üzere etkinlik gönderin. Etkinlik tanımlarını oluşturun, güncelleyin ve kaldırın.
- Alan Adları: Gönderen alan adları oluşturun, listeleyin, alın, güncelleyin, kaldırın ve doğrulayın. İzleme, TLS ve gönderme/alma özelliklerini yapılandırın. Alan adı talepleri oluşturun ve doğrulayın.
- Segmentler: Hedef kitle segmentleri oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
- Engelleme Listeleri: Engelleme listesi girdilerini tek tek veya toplu olarak listeleyin, alın, ekleyin ve kaldırın. Kalıcı geri dönen e-postalar ve spam şikâyetleri otomatik olarak engellenir; iletişim kurulmaması taleplerine uymak için adresleri elle ekleyin.
- Konular: Abonelik konuları oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
- Kişi Özellikleri: Özel kişi nitelikleri oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
- API Anahtarları: API anahtarları oluşturun, listeleyin, güncelleyin ve kaldırın.
- Web Kancaları: Etkinlik bildirimleri için web kancaları oluşturun, listeleyin, alın, güncelleyin ve kaldırın; ayrıca teslimat geçmişlerini inceleyin: bir web kancasına gönderilen etkinlikleri, bir etkinliğin yükünü ve teslimat girişimlerini görüntüleyin. Başka bir teslimat kuyruğa almak için bir etkinliği yeniden oynatın ve web kancasının imzalama gizli anahtarını döndürün.
- Günlükler: Tam istek ve yanıt gövdeleri dahil olmak üzere API istek günlüklerini listeleyin ve inceleyin.
- Kullanım: Hesap düzeyindeki kullanım ve kota bilgilerini alın: e-postalar, kişiler, segmentler, toplu gönderimler, AI kredileri, otomasyon çalıştırmaları, alan adları ve API hız sınırı.
- Düzenleyici: Resend panosundaki görsel düzenleyiciye bağlanın (ve bağlantıyı kesin) ve toplu gönderimler ile şablonlar üzerinde iş birliği yaparken bir taslağın içeriğini okuyun.
Yerel Geliştirme
- Bu projeyi klonlayın ve derleyin:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
- Yerel derlemeyi kullanmak için
npxkomutunu yerel derlemenizin yolu ile değiştirin:
Claude Code (stdio):
claude mcp add resend -e RESEND_API_KEY=re_xxxxxxxxx -- node ABSOLUTE_PATH_TO_PROJECT/dist/index.js
Claude Code (HTTP):
claude mcp add resend --transport http http://127.0.0.1:3000/mcp --header "Authorization: Bearer re_xxxxxxxxx"
Cursor / Claude Desktop (stdio):
{
"mcpServers": {
"resend": {
"command": "node",
"args": ["ABSOLUTE_PATH_TO_PROJECT/dist/index.js"],
"env": {
"RESEND_API_KEY": "re_xxxxxxxxx"
}
}
}
}
Cursor (HTTP):
{
"mcpServers": {
"resend": {
"url": "http://127.0.0.1:3000/mcp",
"headers": {
"Authorization": "Bearer re_xxxxxxxxx"
}
}
}
}
MCP İstemcisiyle Canlı Test
Geliştirme sırasında, kodu başka bir yerde düzenlerken gerçek bir MCP istemci oturumunda değişiklikleri test edebilirsiniz.
Yöntem: tsc --watch komutunu çalıştırarak dist/ dosyasını sürekli yeniden derleyin ve ayrı bir MCP istemcisini başka bir dizindeki derlenmiş dist/index.js dosyasına yönlendirin. Kod değişikliklerini uygulamak istediğinizde MCP istemci oturumunu yeniden başlatın (MCP sunucuları, sıcak yeniden yükleme yapmayan uzun ömürlü stdio süreçleridir).
Claude Code örneği:
-
Kaydedildiğinde otomatik olarak yeniden derlemek için TypeScript izleyicisini çalıştırın:
pnpm tsc --watch -
Ayrı bir dizinde, derleme çıktısını gösteren bir
.mcp.jsonoluşturun:mkdir -p /tmp/mcp-test// /tmp/mcp-test/.mcp.json { "mcpServers": { "resend-dev": { "command": "node", "args": ["/absolute/path/to/resend-mcp/dist/index.js"], "env": { "RESEND_API_KEY": "re_xxxxxxxxx" } } } } -
Claude Code'u bu dizinden başlatın ve MCP araçlarını kullanın. Kod değişiklikleri yaptıktan sonra yeni derlemeyi kullanmak için yeni bir Claude Code oturumu başlatın.
Aynı yöntem tüm MCP istemcileri için geçerlidir: test ortamınızı geliştirme ortamınızdan ayırın, dist/index.js için mutlak bir yol kullanın ve yeniden derlemeden sonra MCP sunucusuna yeniden bağlanın.
MCP Inspector ile Test
Not: Önce projeyi derlediğinizden emin olun (yukarıdaki Yerel Geliştirme bölümüne bakın).
Stdio Aktarımını Kullanma
-
API anahtarınızı ayarlayın:
export RESEND_API_KEY=re_your_key_here -
Inspector'ı başlatın:
pnpm inspector -
Tarayıcıda (Inspector arayüzü):
- stdio'yu seçin (bir işlem başlatın).
- Komut:
node - Argümanlar:
dist/index.js(veyadist/index.jsiçin tam yol) - Ortam:
RESEND_API_KEY=re_your_key_here(veya aynı terminalde zaten dışa aktardıysanız boş bırakın). - Connect'e tıklayın, ardından sunucunun çalıştığını doğrulamak için "List tools" seçeneğini kullanın.
HTTP Aktarımını Kullanma
-
HTTP sunucusunu bir terminalde başlatın:
node dist/index.js --http --port 3000 -
Inspector'ı başka bir terminalde başlatın:
pnpm inspector -
Tarayıcıda (Inspector arayüzü):
- Streamable HTTP'yi seçin (URL'ye bağlanın).
- URL:
http://127.0.0.1:3000/mcp - Özel bir başlık ekleyin:
Authorization: Bearer re_your_key_hereve geçiş düğmesini etkinleştirin. - Connect'e tıklayın, ardından sunucunun çalıştığını doğrulamak için "List tools" seçeneğini kullanın.