Mailrith 이메일 마케팅 플랫폼 내에서 구독자, 브로드캐스트, 시퀀스, 자동화 및 보고서를 관리합니다.
다른 이름 anrawool/mailrith-agent-platform, mailrith, @mailrith/mcp-server
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 771
- 최신 버전
- 2.0.1
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
Mailrith MCP란?
Mailrith 이메일 마케팅 플랫폼 내에서 구독자, 브로드캐스트, 시퀀스, 자동화 및 보고서를 관리합니다.
프로젝트 README에서 생성된 요약
Mailrith MCP server 정보
Mailrith Email Marketing은 MCP server를 통해 이메일 마케팅 운영을 관리할 수 있는 인터페이스를 제공합니다. 개발자와 사용자는 구독자, 브로드캐스트, 시퀀스 및 자동화와 상호작용할 수 있습니다. 이 서버는 api.mailrith.com/mcp의 호스팅 엔드포인트를 통한 원격 연결과 stdio 또는 self-hosted HTTP 트랜스포트를 사용하는 로컬 설치를 모두 지원합니다. Claude Desktop과 같은 원격 클라이언트는 Mailrith OAuth를 사용하여 연결하며, 로컬 stdio 설정은 MAILRITH_API_KEY 환경 변수를 통해 제공되는 workspace API key가 필요합니다.
이 서버는 submitted, compact, custom을 포함한 다양한 호환성 프로필을 제공합니다. submitted 프로필은 범용 에이전트용으로 설계되었으며 subscribers_list, broadcasts_create, broadcasts_schedule과 같은 도구를 포함합니다. 사용자가 부여받은 OAuth scope 또는 workspace API key를 기반으로 엄격한 권한 확인을 수행합니다. 또한 자동화 읽기 시 민감한 webhook token을 마스킹하고, 쉘 히스토리에 노출되는 것을 방지하기 위해 커맨드 인자로 전달된 자격 증명을 거부하여 보안을 유지합니다.
활용 사례
- 1이메일 구독자 리스트 관리AI에게 현재 이메일 구독자 리스트를 조회하거나 확인하도록 요청합니다.
- 2마케팅 브로드캐스트 예약에이전트에게 특정 시간에 맞춰 새로운 이메일 브로드캐스트를 준비하고 예약하도록 지시합니다.
- 3자동화 상태 업데이트클라이언트를 통해 기존 이메일 자동화 또는 시퀀스의 상태를 수정합니다.
- 4브로드캐스트 사전 점검 수행에이전트를 사용하여 브로드캐스트가 수신자에게 공식적으로 발송되기 전에 유효성을 검사합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Mailrith MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Mailrith MCP 설치
$ claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-serverCursor에 Mailrith MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}VS Code에 Mailrith MCP 설치
.vscode/mcp.json
{
"servers": {
"mailrith": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}VS Code CLI에 Mailrith MCP 설치
$ code --add-mcp '{"name":"mailrith","type":"stdio","command":"npx","args":["-y","@mailrith/mcp-server"],"env":{"MAILRITH_API_KEY":"<YOUR_MAILRITH_API_KEY>"}}'Claude Desktop에 Mailrith MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}Codex에 Mailrith MCP 설치
$ codex mcp add mailrith --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' -- npx -y @mailrith/mcp-serverCodex config.toml에 Mailrith MCP 설치
~/.codex/config.toml
[mcp_servers.mailrith] command = "npx" args = ["-y", "@mailrith/mcp-server"] [mcp_servers.mailrith.env] MAILRITH_API_KEY = "<YOUR_MAILRITH_API_KEY>"
Gemini CLI에 Mailrith MCP 설치
$ gemini mcp add -s user -e 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith npx -- -y @mailrith/mcp-serverGemini settings.json에 Mailrith MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mailrith": {
"command": "npx",
"args": [
"-y",
"@mailrith/mcp-server"
],
"env": {
"MAILRITH_API_KEY": "<YOUR_MAILRITH_API_KEY>"
}
}
}
}구성
MAILRITH_API_KEY필수비밀A Mailrith workspace API key.
| 이름 | 설명 | 유형 |
|---|---|---|
| MAILRITH_API_KEY | A Mailrith workspace API key. | 필수비밀 |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능anrawool/mailrith-agent-platform is public and reachablegithub.com/anrawool/mailrith-agent-platform ↗통과
- 패키지가 이 저장소를 소스로 명시@mailrith/mcp-server names anrawool/mailrith-agent-platform as sourcenpmjs.com/package/@mailrith/mcp-server ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @mailrith/mcp-servernpmjs.com/package/@mailrith/mcp-server/v/2.0.1#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-11github.com/anrawool/mailrith-agent-platform ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @mailrith/mcp-server통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음101 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 98 ms통과
README
GitHub에서 보기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 질문
Mailrith MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'MAILRITH_API_KEY=<YOUR_MAILRITH_API_KEY>' mailrith -- npx -y @mailrith/mcp-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Mailrith MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Mailrith MCP server 인증은 어떻게 하나요?
Claude Desktop 및 other 원격 클라이언트는 Mailrith OAuth를 사용하며, 코드 중심 클라이언트는 Authorization 헤더에 workspace API key 또는 OAuth access token을 사용할 수 있습니다.
기본 프로필에서 사용할 수 있는 도구는 무엇인가요?
기본 'submitted' 프로필에는 구독자 관리, 브로드캐스트 생성 및 예약, 시퀀스 및 자동화 상태 업데이트를 위한 도구가 포함되어 있습니다.