이 저장소는 운영 중인 MuntuAI MCP 서버에 대한 공개 문서, 매니페스트, 참조 클라이언트를 포함합니다. 실행 가능한 서버 구현은 기본 Muntu 백엔드에 있습니다.
MuntuAI용 공식 Model Context Protocol (MCP) 서버 — AI 에이전트에게 이메일 아웃리치 캠페인, 리드 관리, 도메인 인프라, 실시간 워크스페이스 이벤트에 대한 프로그래밍 방식 액세스를 제공합니다.
MuntuAI는 AI 네이티브 이메일 아웃리치 플랫폼입니다. 이 MCP 서버는 외부 에이전트(Claude, Cursor, 사용자 정의 스크립트)가 MuntuAI 워크스페이스에 연결하여 캠페인 생성, 리드 가져오기, 도메인 검증, 이메일 전송, 웹훅 이벤트 구독 등의 작업을 HTTP를 통한 표준 MCP 인터페이스로 수행할 수 있게 합니다.
프로토콜: HTTP를 통한 Model Context Protocol (JSON-RPC 2.0)
전송: Streamable HTTP (text/event-stream 또는 application/json)
서버 프로토콜 개정: 2025-03-26
서버 URL: https://api.muntuai.com/api/mcp
Related MCP server: KeyID Agent Kit
app.muntuai.com에 로그인하여 Settings → Agent Keys로 이동한 후 키를 생성하세요. 에이전트의 필요에 맞는 자율 수준을 선택하세요:
수준 | 수행할 수 있는 작업 |
| 모든 항목 읽기 — 캠페인, 리드, 도메인, 발신자, 이벤트 |
| 읽기 + 생성 및 수정 — 캠페인, 도메인, 발신자, 리드, 웹훅 |
| 위의 모든 기능 + 일시 중지, 재개, 삭제 |
원시 키는 한 번만 표시됩니다: mnt_<keyId>.<secret>. 즉시 복사하세요.
보안 참고: 원시 에이전트 키는 환경 변수나 비밀 관리자에 저장하세요. 소스 제어에 커밋하거나 공유 파일에 붙여넣지 마세요.
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"muntu": {
"url": "https://api.muntuai.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
}
}
}
}Cursor (.cursor/mcp.json 또는 Settings → MCP):
{
"mcpServers": {
"muntu": {
"url": "https://api.muntuai.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:MUNTU_AGENT_KEY}"
}
}
}
}Python:
pip install requests
export MUNTU_AGENT_KEY="mnt_YOUR_KEY_HERE"
python clients/python/muntu_mcp_client.py list-campaigns권장 사항:
export MUNTU_SESSION_ID="$(uuidgen)"Muntu는 선택적 MUNTU_SESSION_ID를 사용하여 요청을 하나의 논리적 MCP 세션으로 그룹화하고 세션 범위 안전 제어 및 예산 관리를 수행합니다.
연결되면 에이전트에게 다음과 같이 요청하세요:
"내 MuntuAI 워크스페이스의 모든 캠페인 나열"
에이전트는 muntu://campaigns/{workspaceId}에서 resources/read를 호출하고 캠페인 목록을 반환합니다.
또는 Python CLI로:
python clients/python/muntu_mcp_client.py list-campaigns
python clients/python/muntu_mcp_client.py list-domains
python clients/python/muntu_mcp_client.py list-emails리소스 | URI | 설명 |
workspace |
| 프로필, 정책, 인프라 수 |
domains |
| DNS 및 검증 상태를 포함한 모든 도메인 |
senders |
| 상태를 포함한 모든 이메일 계정 |
campaigns |
| 통합 캠페인 목록 |
campaign-plans |
| 초안 검토 대기열 |
events |
| 최근 시스템 이벤트 (필터 가능) |
도메인별로 그룹화 — 전체 색인은 tools/README.md 참조.
캠페인 — 생성, 시작, 일시 중지, 재개, 모니터링, 초안 검토, 전송
리드 — 배열 또는 CSV URL에서 가져오기, 강화, 샘플링
발신자 — 생성, 삭제, 상태 확인, 캠페인에 할당
도메인 — 추가, 검증, 상태 확인
이메일 생성 — 미리 보기, 다듬기, 캠페인 가이드 생성
웹훅 — 워크스페이스 이벤트 구독
메타 — 에이전트 키 정보 가져오기
muntuai-mcp/
├── README.md # This file
├── QUICKSTART.md # 5-minute setup guide
├── docs/
│ ├── authentication.md # Token format, headers, rate limits
│ ├── autonomy-levels.md # Permission model
│ ├── resources.md # All 6 resources with schemas
│ ├── events.md # All event types and payloads
│ ├── webhooks.md # Register, sign, verify
│ └── errors.md # Error codes and handling
├── tools/
│ ├── README.md # Full tool index
│ ├── campaigns.md
│ ├── leads.md
│ ├── senders.md
│ ├── domains.md
│ ├── email-generation.md
│ └── meta.md
├── workflows/
│ ├── README.md # What workflows are
│ ├── launch-first-campaign.md
│ ├── review-and-send-drafts.md
│ ├── domain-setup.md
│ └── monitor-campaign.md
├── reference/
│ ├── event-types.md
│ ├── resource-schemas.md
│ └── tool-schemas.md
├── clients/
│ └── python/
│ ├── muntu_mcp_client.py # Reference Python client
│ ├── README.md
│ └── examples/
├── agent-guides/
│ ├── for-claude.md
│ ├── for-cursor.md
│ └── decision-guide.md
└── .well-known/
└── mcp-manifest.json # Machine-readable capabilities manifest워크스페이스 — MuntuAI의 모든 데이터는 워크스페이스 범위로 지정됩니다. 에이전트 키는 하나의 워크스페이스에 바인딩되며 해당 워크스페이스 내의 데이터에만 액세스할 수 있습니다.
자율 수준 — 모든 도구에는 최소 요구 수준이 있습니다. 키의 수준이 요구 사항보다 낮으면 호출이 거부되고 시도가 기록됩니다. docs/autonomy-levels.md 참조.
캠페인 수명 주기 — uploaded → enriching → drafting → sending → completed. 에이전트는 get_campaign_performance 및 이벤트 리소스를 통해 이 수명 주기를 관찰할 수 있습니다. workflows/monitor-campaign.md 참조.
도메인 검증 — 전송 전에 도메인은 이메일 제공업체를 통해 검증되어야 합니다. 여기에는 DNS 레코드 게시 및 검증 트리거가 포함됩니다. workflows/domain-setup.md 참조.
문서 문제: 이 저장소에 이슈 열기
플랫폼 지원: support@muntuai.com
웹사이트: muntuai.com
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
Email for AI agents: send mail, manage contacts, automations & webhooks. Zero-DNS first send.
AI agents read & send email, manage mailboxes, domains and webhooks via the QMailing API.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/design-smith/MuntuAI-MCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server