MCP-Server

Plan Feature

Diese Funktion ist nur in den Tarifen Growth und Scale verfugbar.

Der Templatical MCP-Server ermoglicht es KI-Agenten, programmatisch mit Ihren E-Mail-Vorlagen zu interagieren, indem das Model Context Protocol verwendet wird. Anstatt individuelle API-Integrationen zu entwickeln, konnen Ihre KI-Agenten strukturierte Tools fur Vorlagenverwaltung, Medienverwaltung und KI-gestutzte Inhaltserstellung erkennen und aufrufen.

Funktionsweise

Der MCP-Server stellt einen Standard-MCP-Endpunkt bereit, mit dem sich KI-Agenten uber HTTP verbinden. Der Agent authentifiziert sich mit einem dedizierten MCP-API-Schlussel und gibt das Zielprojekt und den Mandanten uber Request-Header an. Alle Operationen sind auf das angegebene Projekt und den Mandanten beschrankt.

Der Server verwendet JSON-RPC 2.0 mit der MCP-Transportschicht, sodass jeder MCP-kompatible Client ohne zusatzliche Konfiguration eine Verbindung herstellen kann.

Voraussetzungen

Bevor Sie den MCP-Server einrichten, stellen Sie sicher, dass Sie Folgendes haben:

1. Ein Templatical-Konto mit einem Growth- oder Scale-Tarif
2. Einen MCP-API-Schlussel — siehe MCP-API-Schlussel erstellen
3. Ihre Projekt-UUID und den Mandanten-Slug

MCP-API-Schlussel erstellen

MCP-API-Schlussel werden im Templatical-Dashboard unter MCP Keys in der Seitenleiste verwaltet.

1. Navigieren Sie zu MCP Keys in der Dashboard-Seitenleiste
2. Klicken Sie auf MCP-Schlussel erstellen
3. Geben Sie einen aussagekraftigen Namen ein (z.B. "Claude Desktop - Produktion")
4. Legen Sie optional ein Ablaufdatum fest
5. Wahlen Sie den Projektzugriffsbereich:
   • Alle Projekte (Standard) — der Schlussel kann auf jedes Projekt in Ihrem Team zugreifen
   • Bestimmte Projekte — wahlen Sie aus, auf welche Projekte der Schlussel zugreifen kann
6. Klicken Sie auf Erstellen

Nach der Erstellung sehen Sie den vollstandigen API-Schlussel einmalig. Kopieren Sie ihn und bewahren Sie ihn sicher auf — er kann nicht erneut abgerufen werden. Falls er verloren geht, konnen Sie das Secret uber die Schlussel-Karte im Dashboard neu generieren.

Jedes Team kann bis zu 10 MCP-API-Schlussel haben.

Endpunkt

POST https://templatical.com/api/v1/mcp

Alle Anfragen mussen die folgenden Header enthalten:

Header	Beschreibung
Authorization	Bearer {mcp_api_schlussel} — Ihr MCP-API-Schlussel aus dem Dashboard
X-Project-Id	Ihre Projekt-UUID (aus dem Templatical-Dashboard)
X-Tenant	Der Mandanten-Slug fur die Datenisolierung

Ratenlimitierung

Der MCP-Endpunkt erzwingt Ratenlimits pro API-Schlussel (oder IP-Adresse, wenn kein Schlussel angegeben ist):

Limit	Zeitfenster
120 Anfragen	Pro Minute
2.000 Anfragen	Pro Stunde

Bei Uberschreitung eines Ratenlimits antwortet der Server mit HTTP 429 Too Many Requests. Der Retry-After-Header gibt an, wie viele Sekunden bis zum nachsten Versuch gewartet werden soll.

Einen KI-Agenten verbinden

Claude Desktop

Fugen Sie Folgendes zur MCP-Konfigurationsdatei von Claude Desktop (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "templatical": {
      "type": "streamable-http",
      "url": "https://templatical.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer {mcp_api_schlussel}",
        "X-Project-Id": "{projekt_id}",
        "X-Tenant": "{mandanten_slug}"
      }
    }
  }
}

Ersetzen Sie {mcp_api_schlussel}, {projekt_id} und {mandanten_slug} durch Ihre tatsachlichen Werte.

Benutzerdefinierte MCP-Clients

Jeder MCP-Client, der den Streamable-HTTP-Transport unterstutzt, kann sich verbinden. Richten Sie ihn auf die Endpunkt-URL und fugen Sie die Header Authorization, X-Project-Id und X-Tenant hinzu.

Verfugbare Tools

Nach der Verbindung kann der KI-Agent alle verfugbaren Tools uber die MCP-Methode tools/list ermitteln. Die Tools sind nach Bereichen gruppiert:

Projektkonfiguration

Tool	Beschreibung
get-project-config	Projektkonfiguration einschliesslich Funktionen, Limits, Tarif, Medieneinstellungen und Speichernutzung abrufen

Vorlagen

Tool	Beschreibung
list-templates	Vorlagen des aktuellen Mandanten auflisten, mit optionaler Namenssuche. Gibt paginierte Ergebnisse (25 pro Seite) mit cursorbasierter Paginierung zuruck
get-template	Eine Vorlage nach ID abrufen, einschliesslich des vollstandigen Inhalts
create-template	Eine neue E-Mail-Vorlage erstellen
update-template	Name, Inhalt oder beides einer Vorlage aktualisieren
delete-template	Eine Vorlage dauerhaft loschen
export-template	Eine Vorlage als HTML (und optional MJML) exportieren

Snapshots

Tool	Beschreibung
list-snapshots	Snapshot-Verlauf einer Vorlage auflisten (bis zu 50, neueste zuerst)
get-snapshot	Einen bestimmten Snapshot mit vollstandigem Inhalt abrufen
create-snapshot	Einen manuellen Snapshot des aktuellen Vorlageninhalts erstellen
restore-snapshot	Eine Vorlage auf einen fruheren Snapshot-Zustand zurucksetzen

Kommentare

Diese Tools erfordern, dass die Kommentarfunktion in Ihrem Tarif aktiviert ist.

Tool	Beschreibung
list-comments	Alle Stammkommentare einer Vorlage auflisten, einschliesslich Antworten
create-comment	Einen Kommentar oder eine Antwort zu einer Vorlage erstellen
update-comment	Den Text eines Kommentars aktualisieren
delete-comment	Einen Kommentar dauerhaft loschen
resolve-comment	Einen Kommentar-Thread als gelost oder ungelost markieren

Medien

Tool	Beschreibung
browse-media	Mediendateien mit Ordnerfilterung, Suche und Sortierung durchsuchen
import-media-from-url	Eine Mediendatei von einer URL importieren
delete-media	Eine oder mehrere Mediendateien dauerhaft loschen

Medienordner

Diese Tools erfordern, dass die Medienordner-Funktion in Ihrem Tarif aktiviert ist.

Tool	Beschreibung
list-media-folders	Alle Medienordner als Baumstruktur auflisten
create-media-folder	Einen neuen Medienordner erstellen
update-media-folder	Einen Medienordner umbenennen
delete-media-folder	Einen Medienordner dauerhaft loschen

KI

Diese Tools erfordern, dass die KI-Generierungsfunktion in Ihrem Tarif aktiviert ist.

Tool	Beschreibung
generate-template	Eine E-Mail-Vorlage mittels KI aus einer Textanweisung generieren oder andern
score-template	Eine Vorlage hinsichtlich Qualitat in den Bereichen Spam, Lesbarkeit, Barrierefreiheit und Best Practices bewerten
rewrite-text	Textinhalt mit KI und einer benutzerdefinierten Anweisung umschreiben

Verfugbare Ressourcen

Ressourcen stellen statische oder halbstatische Inhalte bereit, die KI-Agenten als Kontext lesen konnen. Verwenden Sie die MCP-Methoden resources/list und resources/read, um darauf zuzugreifen.

Ressource	URI	Beschreibung
block-schema	templatical://schema/blocks	TypeScript-Typdefinitionen fur alle E-Mail-Vorlagen-Block-Interfaces, Typen und Enums

Verfugbare Prompts

Prompts sind wiederverwendbare Prompt-Vorlagen, die KI-Agenten durch haufige Arbeitsablaufe leiten. Verwenden Sie die MCP-Methoden prompts/list und prompts/get, um darauf zuzugreifen.

design-template

Leitet durch das Entwerfen einer neuen E-Mail-Vorlage basierend auf Zweck, Zielgruppe und Tonalitat. Der Prompt weist den Agenten an, die Projektkonfiguration und das Block-Schema zu lesen und dann eine Vorlage zu generieren, die den Markenrichtlinien und E-Mail-Best-Practices folgt.

Argument	Erforderlich	Beschreibung
purpose	Ja	Der Zweck der E-Mail-Vorlage (z.B. Willkommens-E-Mail, Newsletter, Werbekampagne)
audience	Nein	Die Zielgruppe fur die E-Mail (z.B. neue Benutzer, Bestandskunden)
tone	Nein	Die gewunschte Tonalitat (z.B. formell, locker, freundlich, professionell)

review-template

Uberpruft eine bestehende Vorlage hinsichtlich Qualitat, Barrierefreiheit und Best Practices. Der Prompt weist den Agenten an, die Vorlage abzurufen, sie zu bewerten und eine strukturierte Uberprufung mit Starken, Verbesserungsbereichen und vorrangigen Korrekturen bereitzustellen.

Argument	Erforderlich	Beschreibung
template_id	Ja	Die ID der zu uberprufenden Vorlage

Beispielinteraktion

So sieht eine typische KI-Agenten-Sitzung uber das MCP-Protokoll aus:

1. Vorlagen auflisten

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "tools/call",
  "params": {
    "name": "list-templates",
    "arguments": {}
  }
}

2. Vorlage mit KI generieren

{
  "jsonrpc": "2.0",
  "id": "2",
  "method": "tools/call",
  "params": {
    "name": "generate-template",
    "arguments": {
      "prompt": "Erstelle eine Willkommens-E-Mail fur neue Abonnenten mit einem Hero-Bild, einer Begruessung und einem CTA-Button"
    }
  }
}

3. Ergebnis exportieren

{
  "jsonrpc": "2.0",
  "id": "3",
  "method": "tools/call",
  "params": {
    "name": "export-template",
    "arguments": {
      "template_id": "01234567-89ab-cdef-0123-456789abcdef"
    }
  }
}

Fehlerbehandlung

MCP-Tool-Fehler folgen einem einheitlichen Format:

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "content": [
      {
        "type": "text",
        "text": "MCP Server is not available on your current plan."
      }
    ],
    "isError": true
  }
}

Haufige Fehlerszenarien:

Fehler	Ursache
HTTP 400 Bad Request	Fehlender X-Project-Id- oder X-Tenant-Header
HTTP 401 Unauthorized	Fehlender, ungultiger oder abgelaufener MCP-API-Schlussel
HTTP 403 Forbidden	MCP-Server-Funktion nicht in Ihrem Tarif verfugbar, oder der Schlussel hat keinen Zugriff auf das angegebene Projekt
HTTP 404 Not Found	Ungultige Projekt-UUID oder Mandanten-Slug im Projekt nicht gefunden
HTTP 429 Too Many Requests	Ratenlimit uberschritten — prufen Sie den Retry-After-Header
Feature 'commenting' is not available on your current plan.	Eine bestimmte Funktion ist im aktuellen Tarif nicht enthalten
Template not found.	Die Vorlagen-ID existiert nicht oder gehort zu einem anderen Mandanten