MuntuAI MCP

Этот репозиторий содержит публичную документацию, манифест и референсные клиенты для работающего MCP-сервера MuntuAI. Реализация запускаемого сервера находится в основном бэкенде Muntu.

Официальный сервер Model Context Protocol (MCP) для MuntuAI — предоставляет ИИ-агентам программный доступ к кампаниям email-аутрича, управлению лидами, доменной инфраструктуре и событиям рабочего пространства в реальном времени.

Что это такое

MuntuAI — AI-нативная платформа для email-аутрича. Этот MCP-сервер позволяет внешним агентам (Claude, Cursor, пользовательские скрипты) подключаться к рабочему пространству MuntuAI и выполнять действия: создавать кампании, импортировать лиды, верифицировать домены, отправлять письма и подписываться на webhook-события — всё через стандартный интерфейс MCP поверх HTTP.

Протокол: Model Context Protocol поверх HTTP (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

Быстрый старт

1. Получите ключ агента

Войдите в app.muntuai.com, перейдите в Настройки → Agent Keys и создайте ключ. Выберите уровень автономности, соответствующий потребностям вашего агента:

Вы увидите сырой ключ только один раз: mnt_<keyId>.<secret>. Скопируйте его сразу.

2. Настройте свой клиент

Примечание по безопасности: храните сырой ключ агента в переменной окружения или менеджере секретов. Не коммитьте его в систему контроля версий и не вставляйте в общие файлы.

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 или Настройки → 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-сеанс для контроля безопасности и бюджетирования в рамках сеанса.

3. Сделайте первый вызов

После подключения попросите вашего агента:

«Перечисли все кампании в моём рабочем пространстве MuntuAI»

Агент вызовет resources/read на muntu://campaigns/{workspaceId} и вернёт список кампаний.

Или через 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

Что могут делать агенты

Ресурсы (представления только для чтения)

Инструменты (всего 30)

Сгруппированы по категориям — полный список см. в tools/README.md.

• Кампании — создавать, запускать, приостанавливать, возобновлять, отслеживать, проверять черновики, отправлять

• Лиды — импортировать из массива или CSV-URL, обогащать, делать выборку

• Отправители — создавать, удалять, проверять работоспособность, назначать на кампанию

• Домены — добавлять, верифицировать, проверять статус

• Генерация писем — предпросмотр, доработка, создание руководства по кампании

• Webhooks — подписка на события рабочего пространства

• Мета — получение информации о ключе агента

Структура репозитория

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 и ресурс events. См. workflows/monitor-campaign.md.

Верификация домена — Перед отправкой домен должен быть верифицирован у почтового провайдера. Для этого нужно опубликовать DNS-записи и запустить верификацию. См. workflows/domain-setup.md.

Поддержка

• Проблемы с документацией: Откройте issue в этом репозитории

• Поддержка платформы: support@muntuai.com

• Веб-сайт: muntuai.com