MuntuAI MCP

Dieses Repository enthält die öffentliche Dokumentation, das Manifest und die Referenz-Clients für den Live-MuntuAI-MCP-Server. Die ausführbare Server-Implementierung befindet sich im Haupt-Muntu-Backend.

Der offizielle MCP-Server (Model Context Protocol) für MuntuAI — er bietet KI-Agenten programmatischen Zugriff auf E-Mail-Outreach-Kampagnen, Lead-Verwaltung, Domain-Infrastruktur und Echtzeit-Workspace-Ereignisse.

Was ist das?

MuntuAI ist eine KI-native E-Mail-Outreach-Plattform. Dieser MCP-Server ermöglicht es externen Agenten (Claude, Cursor, benutzerdefinierten Skripten), sich mit einem MuntuAI-Workspace zu verbinden und Aktionen auszuführen: Kampagnen erstellen, Leads importieren, Domains verifizieren, E-Mails senden und Webhook-Ereignisse abonnieren — alles über eine standardmäßige MCP-Schnittstelle per HTTP.

Protokoll: Model Context Protocol über HTTP (JSON-RPC 2.0)
Transport: Streamable HTTP (text/event-stream oder application/json)
Server-Protokollrevision: 2025-03-26
Server-URL: https://api.muntuai.com/api/mcp

Related MCP server: KeyID Agent Kit

Schnellstart

1. Agent-Key erstellen

Melden Sie sich bei app.muntuai.com an, gehen Sie zu Settings → Agent Keys und erstellen Sie einen Key. Wählen Sie die Autonomiestufe, die den Anforderungen Ihres Agenten entspricht:

Sie sehen den rohen Key nur einmal: mnt_<keyId>.<secret>. Kopieren Sie ihn sofort.

2. Client konfigurieren

Sicherheitshinweis: Speichern Sie den rohen Agent-Key in einer Umgebungsvariable oder in einem Secret-Manager. Committen Sie ihn nicht in die Versionskontrolle und fügen Sie ihn nicht in gemeinsam genutzte Dateien ein.

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 oder 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

Empfohlen:

export MUNTU_SESSION_ID="$(uuidgen)"

Muntu verwendet die optionale MUNTU_SESSION_ID, um Anfragen zu einer logischen MCP-Sitzung zu bündeln — für sitzungsbezogene Sicherheitskontrollen und Budgetierung.

3. Ersten Aufruf ausführen

Sobald die Verbindung steht, fragen Sie Ihren Agenten:

„Listen Sie alle Kampagnen in meinem MuntuAI-Workspace auf“

Der Agent ruft resources/read unter muntu://campaigns/{workspaceId} auf und gibt die Kampagnenliste zurück.

Oder über die 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

Was Agenten tun können

Ressourcen (schreibgeschützte Ansichten)

Tools (insgesamt 30)

Nach Themenbereich gruppiert — den vollständigen Index finden Sie in tools/README.md.

• Kampagnen — erstellen, starten, pausieren, fortsetzen, überwachen, Entwürfe prüfen, senden

• Leads — aus Array oder CSV-URL importieren, anreichern, Stichprobe entnehmen

• Absender — erstellen, löschen, Health-Check durchfüren, Kampange zuweisen

• Domains — hinzufügen, verifzieren, Status prüfen

• E-Mail-Generierung — Vorschau anzeigen, verfeinern, Kampagnenleitfaden generieren

• Webhooks — Workspace-Ereignisse abonneren

• Mta — Agent-Key-Informationen abrufen

Repositor-Struktur

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

Kernkonzepte

Workspace — Alle Daten in MuntuAI sind einem Workspace zugeordnet. Ihr Agent-Key ist an einen Workspace gebunden und kann nur auf Daten innerhalb dieses Workspace zugreifen.

Autonomiestufen — Jedes Tool hat eine mindestens erforderliche Stufe. Liegt die Stufe Ihres Keys unter der Anforderung, wird der Aufruf abgelehnt und der Versuch protokolliert. Siehe docs/autonomy-levels.md.

Kampagnenlebenszyklus — upoaded → enrichng → drafting → sending → completed. Agenten können diesen Lebenszyklus über get_campaign_performance und die Eeignis-Resource beobachten. Siehe workflows/monitor-campaign.md.

Domain-Verfizierung — Vor dem Senden muss eine Domain beim E-Mail-Anbieter verfiziert werden. Dazu gehört das Veröffenlichen von DNS-Einträgen und das Auslösen der Verfizierung. Siehe workflows/domain-setup.md.

Support

• Dokumentationsprobleme: Eröfnen Sie ein Issue in diesem Repositor

• Plattform-Support: support@muntuai.com

• Website: muntuai.com