Resend Email

resmi

Resend 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

npm version

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: --http kullanılırken HTTP bağlantı noktası (varsayılan: 3000 veya MCP_PORT env var)
  • --host: --http kullanılırken DNS yeniden bağlama koruması için ana bilgisayar (varsayılan: 127.0.0.1 veya MCP_HOST). Proxy/yük dengeleyici arkasında Host doğrulamasını devre dışı bırakmak için 0.0.0.0 olarak ayarlayın.
  • --allowed-hosts: --http (veya MCP_ALLOWED_HOSTS) kullanılırken virgülle ayrılmış Host izin listesi
  • --allowed-file-dirs: Yerel dosya eklerinin ve CSV içe aktarımlarının okunabileceği, virgülle ayrılmış dizinler (veya MCP_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: --http kullanılırken HTTP bağlantı noktası (isteğe bağlı)
  • MCP_HOST: --http kullanılırken DNS yeniden bağlama koruması için ana bilgisayar (isteğe bağlı)
  • MCP_ALLOWED_HOSTS: --http kullanılırken virgülle ayrılmış Host izin 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) ve create-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-dirs kullanı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-dirs ayarı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

  1. Bu projeyi klonlayın ve derleyin:
git clone https://github.com/resend/resend-mcp.git
pnpm install
pnpm run build
  1. Yerel derlemeyi kullanmak için npx komutunu 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:

  1. Kaydedildiğinde otomatik olarak yeniden derlemek için TypeScript izleyicisini çalıştırın:

    pnpm tsc --watch
    
  2. Ayrı bir dizinde, derleme çıktısını gösteren bir .mcp.json oluş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"
          }
        }
      }
    }
    
  3. 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

  1. API anahtarınızı ayarlayın:

    export RESEND_API_KEY=re_your_key_here
    
  2. Inspector'ı başlatın:

    pnpm inspector
    
  3. Tarayıcıda (Inspector arayüzü):

    • stdio'yu seçin (bir işlem başlatın).
    • Komut: node
    • Argümanlar: dist/index.js (veya dist/index.js iç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

  1. HTTP sunucusunu bir terminalde başlatın:

    node dist/index.js --http --port 3000
    
  2. Inspector'ı başka bir terminalde başlatın:

    pnpm inspector
    
  3. 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_here ve 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.