Mailrith e-posta pazarlama platformu üzerinden aboneleri, yayınları, dizileri, otomasyonları ve raporlamayı yönetin.
Ayrıca bilinen adı anrawool/mailrith-agent-platform, mailrith, @mailrith/mcp-server
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- 771
- En son sürüm
- 2.0.1
- Son commit
- 11 Kas 2026
- Lisans
- MIT
Mailrith MCP nedir?
Mailrith e-posta pazarlama platformu üzerinden aboneleri, yayınları, dizileri, otomasyonları ve raporlamayı yönetin.
Özet, projenin README dosyasından oluşturuldu
Mailrith MCP sunucusu hakkında
Mailrith Email Marketing, bir MCP server aracılığıyla e-posta pazarlama operasyonlarını yönetmek için bir arayüz sağlar. Geliştiriciler ve kullanıcılar aboneler, yayınlar, diziler ve otomasyonlar ile etkileşime girebilirler. Sunucu, api.mailrith.com/mcp adresindeki barındırılan bir uç nokta üzerinden uzak bağlantıları ve stdio veya self-hosted HTTP taşıma protokollerini kullanan yerel kurulumları destekler. Claude Desktop gibi uzak istemciler Mailrith OAuth kullanarak bağlanırken, yerel stdio kurulumları MAILRITH_API_KEY ortam değişkeni aracılığıyla sağlanan bir workspace API key gerektirir.
Bu sunucu; submitted, compact ve custom dahil olmak üzere farklı uyumluluk profilleri sunar. Submitted profili, genel amaçlı agent'lar için tasarlanmıştır ve subscribers_list, broadcasts_create ve broadcasts_schedule gibi araçları içerir. Kullanıcının sahip olduğu OAuth kapsamlarına veya workspace API key'ine bağlı olarak sıkı izin kontrolleri uygular. Sistem, otomasyon okumaları sırasında hassas webhook token'larını gizleyerek ve kimlik bilgilerinin kabuk geçmişinde (shell history) görünmesini önlemek için komut argümanı olarak geçirilmesini reddederek güvenliği sağlar.
Neler yapabilirsiniz
- 1E-posta abone listelerini yönetinYapay zekadan mevcut e-posta abone listenizi getirmesini veya görüntülemesini isteyin.
- 2Pazarlama yayınlarını planlayınAgent'a belirli bir zaman için yeni bir e-posta yayını hazırlamasını ve planlamasını talimat verin.
- 3Otomasyon durumlarını güncelleyinMevcut e-posta otomasyonlarının veya dizilerinin durumunu istemci aracılığıyla değiştirin.
- 4Yayın öncesi kontrol testleri yapınBir yayını alıcılara resmi olarak gönderilmeden önce doğrulamak için agent'ı kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Mailrith MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleMailrith MCP'yi Claude Code içine yükleyin
$ claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-serverMailrith MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Mailrith MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"mailrith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Mailrith MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"mailrith","type":"stdio","command":"npx","args":["-y","@mailrith/mcp-server"],"env":{"MAILRITH_API_KEY":"<YOUR_MAILRITH_API_KEY>"}}'Mailrith MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Mailrith MCP'yi Codex içine yükleyin
$ codex mcp add mailrith --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' -- npx -y @mailrith/mcp-serverMailrith MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.mailrith] command = "npx" args = ["-y", "@mailrith/mcp-server"] [mcp_servers.mailrith.env] MAILRITH_API_KEY = "<YOUR_MAILRITH_API_KEY>"
Mailrith MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user -e 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith npx -- -y @mailrith/mcp-serverMailrith MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Yapılandırma
MAILRITH_API_KEYGerekliGizliA Mailrith workspace API key.
| Ad | Açıklama | Sunucu |
|---|---|---|
| MAILRITH_API_KEY | A Mailrith workspace API key. | GerekliGizli |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebiliranrawool/mailrith-agent-platform is public and reachablegithub.com/anrawool/mailrith-agent-platform ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@mailrith/mcp-server names anrawool/mailrith-agent-platform as sourcenpmjs.com/package/@mailrith/mcp-server ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for @mailrith/mcp-servernpmjs.com/package/@mailrith/mcp-server/v/2.0.1#provenance ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-11github.com/anrawool/mailrith-agent-platform ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @mailrith/mcp-serverGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok101 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorinitialize answered with protocol 2025-06-18 in 98 msGeçti
Mailrith MCP Server
Official MCP server for Mailrith.
The server uses the stable @modelcontextprotocol/sdk package for hosted and
stdio transports while preserving Mailrith's generated operation schemas.
Use the remote MCP endpoint at https://api.mailrith.com/mcp for hosted agent
integrations, or run the local server from this repo for stdio or self-hosted HTTP use.
Claude Desktop and other user-connected remote MCP clients authenticate through
Mailrith OAuth. Code-first clients that can safely store credentials may send a
workspace API key or OAuth access token as Authorization: Bearer <credential>.
Official MCP Registry
The registry metadata in server.json identifies the server as
com.mailrith/mailrith. Clients can use the canonical Streamable HTTP endpoint
at https://api.mailrith.com/mcp, which authenticates through OAuth, or install
the local stdio package from npm. Local installs require a workspace API key in
MAILRITH_API_KEY.
The hosted server requests Full Email Marketing Access by default for a
general-purpose agent. It covers every public email-marketing operation in the
selected workspace, but not billing, team, account-security,
credential-reading, or internal administration. The
discovery_get_capabilities connection check requests the complete public
permission catalog so Mailrith can show every Work Profile and default to Full
Email Marketing Access. The user can choose Reporting, another focused Work
Profile, or custom permissions instead. OAuth stores only the permissions the
user approves, and every tool checks those permissions again when it runs.
MAILRITH_API_KEY="<secret>" pnpm --filter @mailrith/mcp-server exec tsx src/cli.ts --transport stdio
Local stdio reads MAILRITH_API_KEY from the client secret environment. The
server rejects credentials passed as command arguments so they do not appear in
process listings or shell history. Local stdio stops with a clear setup error
when the environment variable is missing because it has no browser-based OAuth
flow.
Self-hosted HTTP does not read a process-wide API key. Each client must send its
own workspace API key or OAuth access token in the Authorization header. The
built-in HTTP listener accepts only 127.0.0.1 or localhost; put a TLS reverse
proxy in front of it when another machine needs access.
The default submitted profile exposes a fixed reviewed catalog of focused
tools such as:
subscribers_listbroadcasts_createbroadcasts_preflightbroadcasts_schedulebroadcasts_sendsequences_update_statusautomations_update_status
Every submitted tool has a human-readable top-level title and
annotations.title, a narrow description, exact input and output schemas,
explicit safety annotations, and machine-readable operation permissions.
Request-body inputs expose their JSON type directly as well as their exact
referenced schema so connector review tools can validate them without expanding
$ref values first. Tools other than the connection check advertise their
exact OAuth permissions. The connection check advertises the complete
permission catalog so OAuth can offer every Work Profile; its result still
reports the exact permissions granted to the connection. The catalog stays the
same for every user so clients can review and select tools reliably. Workspace
role, plan, product readiness, and granted permissions are enforced when a tool
runs.
Anonymous clients may initialize and list this static catalog so ChatGPT and
other hosts can start OAuth linking. Anonymous tool calls never reach the
Mailrith product API and return HTTP 401 with a standards-based
WWW-Authenticate challenge instead. Authenticated calls that need more
permissions return HTTP 403 with the complete replacement permission set.
Single-tool responses also include MCP's tool-level OAuth challenge metadata
for clients that use it when linking or reconnecting an account.
Each anonymous HTTP request accepts one JSON-RPC message. Authenticated
requests may batch up to 25 messages. These limits keep discovery and tool
responses predictable for every connected workspace.
Automation reads never return saved webhook bearer tokens or custom header values. They return only whether each value is configured. If a client reads an Automation and sends the redacted definition back during an update, Mailrith preserves the existing values unless the client explicitly replaces or removes them. Changing the webhook destination requires new credential values so an old secret cannot be carried to another service.
The package also preserves two explicit compatibility profiles:
compactexposes the earlier seven discovery and routing tools.customexposes generated focused tools with caller-selected Work Profile, permission, and read-only filters.
Use these profiles only for local or purpose-built clients. The public ChatGPT/Codex plugin
and the Claude Connector use the fixed submitted profile at the single /mcp
endpoint.
Official Builds And Forks
Modified public versions must use distinct package, registry, plugin, and service names and clearly say that they are unofficial. See the Mailrith Trademark And Unofficial Fork Policy.
Mailrith MCP soruları
Mailrith MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-server komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Mailrith MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Mailrith MCP server ile nasıl kimlik doğrulaması yapabilirim?
Claude Desktop ve diğer uzak istemciler Mailrith OAuth kullanırken, kod odaklı istemciler Authorization başlığında bir workspace API key veya OAuth erişim token'ı kullanabilirler.
Varsayılan profilde hangi araçlar mevcuttur?
Varsayılan 'submitted' profili; aboneleri yönetmek, yayın oluşturmak ve planlamak ile dizilerin ve otomasyonların durumunu güncellemek için gerekli araçları içerir.