Resend Email

Resend MCP Sunucusu

Yapay zeka ajanı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 e-postaları, 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ı (Akışkan HTTP) destekleyen herhangi bir MCP istemcisini bağlayın. Kurulacak hiçbir şey ve çalıştırılacak yerel bir süreç yoktur, bu da onu Claude gibi web tabanlı istemciler ve barındırılan ajan platformları için en iyi seçenek haline getirir.

Bağlandığınızda, istemciniz Resend'de oturum açmak ve OAuth kullanarak erişimi onaylamak 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 girişini tamamlamak için resend'i seçin.

Claude

Claude'da (web veya masaüstü), Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle'yi açın ve şunu girin:

https://mcp.resend.com/mcp

Cursor

Komut paletini açın ve "Cursor Ayarları" > "MCP" > "Yeni genel MCP sunucusu ekle"yi seçin.

{
  "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'u kullanmak için settings.json dosyanıza aşağıdakini ekleyin:

{
  "mcp": {
    "servers": {
      "resend": {
        "type": "http",
        "url": "https://mcp.resend.com/mcp"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "resend": {
      "serverUrl": "https://mcp.resend.com/mcp"
    }
  }
}

Warp

Warp'ın Ayarlarında, Ajanlar > MCP sunucuları'na gidin ve yeni bir sunucu eklemek için +Ekle'ye tıklayın.

{
  "resend": {
    "serverUrl": "https://mcp.resend.com/mcp"
  }
}

API anahtarı ile kimlik doğrulama

İstemciniz tarayıcı girişinin mümkün olmadığı bir yerde (bir sunucu, CI veya başsız bir ajan) çalışıyorsa, OAuth kullanmak yerine bir Resend API anahtarını Bearer belirteci 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), 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 bulunan aynı açık kaynak kodunu çalıştırır. Sunucuyu kendiniz çalıştırmayı tercih ederseniz, npx kullanarak desteklenen herhangi bir MCP istemcisine entegre edebilirsiniz. Şunları yapmanız gerekecek:

• Bir API anahtarı oluşturun
• Alan adınızı doğrulayın

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 yerine gerçek API anahtarınızı yazmayı unutmayın.

Stdio Aktarımı (Varsayılan)

Hızlı Kurulum

Algılanan/seçilen tüm ajanlar ve düzenleyiciler için kurulum yapın:

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 Ayarları" > "MCP" > "Yeni genel MCP sunucusu ekle"yi seçin.

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Claude Desktop

Claude Desktop ayarlarını açın > "Geliştirici" sekmesi > "Yapılandırmayı Düzenle".

{
  "mcpServers": {
    "resend": {
      "command": "npx",
      "args": ["-y", "resend-mcp"],
      "env": {
        "RESEND_API_KEY": "re_xxxxxxxxx"
      }
    }
  }
}

Copilot

VS Code'da GitHub Copilot'u kullanmak için settings.json dosyanıza aşağıdakini 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, Ayarlar > Bağlantılar > MCP Sunucuları'nı açın ve Özel bir MCP ekle'ye tıklayın. Adım adım talimatlar 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 veya web tabanlı entegrasyonlar için sunucuyu HTTP üzerinden çalıştırın. HTTP modunda, her istemci Authorization başlığında kendi Resend API anahtarını Bearer belirteci olarak ileterek kimlik doğrulaması yapar.

Sunucuyu başlatın:

npx -y resend-mcp --http --port 3000

Sunucu http://127.0.0.1:3000 adresini dinleyecek ve MCP uç noktasını Akışkan HTTP kullanarak /mcp adresinde sunacaktır.

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 Ayarları" > "MCP" > "Yeni genel MCP sunucusu ekle"yi seçin.

{
  "mcpServers": {
    "resend": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer re_xxxxxxxxx"
      }
    }
  }
}

Bağlantı noktasını MCP_PORT ortam değişkeni aracılığıyla da ayarlayabilirsiniz:

MCP_PORT=3000 npx -y resend-mcp --http

Kütüphane olarak kullanma

HTTP aktarımı, CLI aracılığıyla çalıştırılmak yerine başka bir hizmete gömülebilmesi için dışa aktarılır. Bağlanan her istemci, Bearer belirteci olarak iletilen kendi Resend API anahtarıyla 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 Host doğrulaması uygular (DNS yeniden bağlama koruması). Sunucunun istek başına Bearer API anahtarı ile korunduğu bir ters proxy veya yük dengeleyici arkasında dağıtım yaparken, proxy'nin iletilen Host ve yük dengeleyici sağlık kontrollerinin 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 aracılığıyla bu, --host / --allowed-hosts (veya MCP_HOST / MCP_ALLOWED_HOSTS) ile eşleşir.

Seçenekler

Yerel sunucuyu yapılandırmak için ek argümanlar iletebilirsiniz:

• --key: Resend API anahtarınız (HTTP modu istemciden Bearer belirtecini kullandığı için yalnızca stdio modu)
• --sender: Doğrulanmış bir alan adından varsayılan gönderen e-posta adresi
• --reply-to: Varsayılan yanıtlama adresi (birden çok kez belirtilebilir)
• --http: stdio yerine HTTP aktarımı kullan (varsayılan: stdio)
• --port: --http kullanırken HTTP bağlantı noktası (varsayılan: 3000 veya MCP_PORT ortam değişkeni)
• --host: --http kullanırken DNS yeniden bağlama koruması için ana bilgisayar (varsayılan: 127.0.0.1 veya MCP_HOST). Bir 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ırken virgülle ayrılmış Host izin listesi

Ortam değişkenleri:

• RESEND_API_KEY: Resend API anahtarınız (stdio için gerekli, istemciler Bearer belirteci ile ilettiği için HTTP için isteğe bağlı)
• 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ıtlama e-posta adresleri (isteğe bağlı)
• MCP_PORT: --http kullanırken HTTP bağlantı noktası (isteğe bağlı)
• MCP_HOST: --http kullanırken DNS yeniden bağlama koruması için ana bilgisayar (isteğe bağlı)
• MCP_ALLOWED_HOSTS: --http kullanırken virgülle ayrılmış Host izin listesi (isteğe bağlı)

[!NOTE] Bir gönderen e-posta adresi sağlamazsanız, MCP sunucusu aracı her çağırdığınızda bir tane sağlamanızı isteyecektir.

MCP Sunucu Araçları

Resend'in MCP sunucusu, yapay zeka ajanınıza tek bir entegrasyonla tüm Resend platformuna yerel erişim sağlar. E-posta altyapınızın tüm yönlerini doğal dil kullanarak yönetebilirsiniz.

• E-postalar: E-postaları gönderin, listeleyin, alın, iptal edin, güncelleyin ve toplu gönderin. HTML, düz metin, ekler (yerel dosya, URL veya base64), CC/BCC, yanıtlama, 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.
• Şablonlar: E-posta şablonlarını oluşturun, listeleyin, alın, güncelleyin, yayınlayın, çoğaltın ve kaldırın. Şablon içeriği ve {{{VARIABLE}}} yer tutucuları oluşturmayı destekler.
• Kişiler: Kişileri oluşturun, listeleyin, alın, güncelleyin ve kaldırın. Segment üyeliklerini, konu aboneliklerini ve CSV kişi içe aktarmalarını yönetin. Özel kişi özelliklerini destekler.
• Toplu E-postalar: Toplu e-posta kampanyalarını oluşturun, gönderin, listeleyin, alın, güncelleyin ve kaldırın. Zamanlama, kişiselleştirme yer tutucuları ve önizleme metnini destekler.
• Otomasyonlar: Otomasyonları oluşturun, listeleyin, alın, güncelleyin ve kaldırın. Bir otomasyonun çalışmalarını inceleyin.
• Olaylar: Bir kişi için otomasyonları tetiklemek üzere olaylar gönderin. Olay tanımlarını oluşturun, güncelleyin ve kaldırın.
• Alan Adları: Gönderen alan adlarını oluşturun, listeleyin, alın, güncelleyin, kaldırın ve doğrulayın. İzleme, TLS ve gönderme/alma yeteneklerini yapılandırın. Alan adı taleplerini oluşturun ve doğrulayın.
• Segmentler: Kitle segmentlerini oluşturun, listeleyin, alın ve kaldırın.
• Engellemeler: Engelleme listesi girişlerini tek tek veya toplu olarak listeleyin, alın, ekleyin ve kaldırın. Sert geri dönüşler ve spam şikayetleri otomatik olarak engellenir; iletişim kurmama taleplerini karşılamak için adresleri manuel olarak ekleyin.
• Konular: Abonelik konularını oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
• Kişi Özellikleri: Özel kişi özniteliklerini oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
• API Anahtarları: API anahtarlarını oluşturun, listeleyin ve kaldırın.
• Web Kancaları: Olay bildirimleri için web kancalarını oluşturun, listeleyin, alın, güncelleyin ve kaldırın.
• Günlükler: Tam istek ve yanıt gövdeleri dahil olmak üzere API istek günlüklerini listeleyin ve inceleyin.
• Düzenleyici: Toplu e-postalar ve şablonlar üzerinde işbirliği yaparken Resend panosundaki görsel düzenleyiciye bağlanın (ve bağlantıyı kesin) ve 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

2. 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"
      }
    }
  }
}

Bir MCP İstemcisi ile Canlı Test

Geliştirme yaparken, başka bir yerde kod düzenlerken değişiklikleri gerçek bir MCP istemci oturumunda test edebilirsiniz.

Fikir: dist/ dosyasını sürekli olarak yeniden derlemek için tsc --watch komutunu çalıştırın ve ayrı bir MCP istemcisini farklı bir dizinden derlenmiş dist/index.js dosyasına yönlendirin. Kod değişikliklerini almak 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 ile Örnek:

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ı işaret eden 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 almak için yeni bir Claude Code oturumu başlatın.

Aynı prensip herhangi bir MCP istemcisi 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 derledikten 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 UI):

   • stdio'yu seçin (bir süreç başlatın).
   • Komut: node
   • Argümanlar: dist/index.js (veya dist/index.js dosyasının tam yolu)
   • Ortam: RESEND_API_KEY=re_your_key_here (veya aynı terminalde zaten dışa aktardıysanız boş bırakın).
   • Bağlan'a tıklayın, ardından sunucunun çalıştığını doğrulamak için "Araçları listele"yi kullanın.

HTTP Aktarımını Kullanma

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

   node dist/index.js --http --port 3000
   

2. Başka bir terminalde inspector'ı başlatın:

   pnpm inspector
   

3. Tarayıcıda (Inspector UI):

   • Akışkan 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 düğmeyi etkinleştirin.
   • Bağlan'a tıklayın, ardından sunucunun çalıştığını doğrulamak için "Araçları listele"yi kullanın.