MCP-Integration für KI-Assistenten #
Vigoba unterstützt das Model Context Protocol (MCP) – ein offener Standard für die Integration von KI-Assistenten mit externen Datenquellen und Tools.
💡 Hinweis: MCP-Zugang ist im Large Plan verfügbar. Jetzt upgraden
Was ist MCP? #
Das Model Context Protocol ermöglicht es KI-Assistenten wie Claude, ChatGPT oder lokalen LLMs, direkt mit Vigoba zu interagieren. Statt manuell im Dashboard zu klicken, kannst du per natürlicher Sprache:
- "Erstelle einen Goodie Bag für die Marketing-Konferenz"
- "Füge einen Rabattcode für 20% hinzu"
- "Zeige mir die Analytics der letzten Woche"
- "Wer hat den VIP-Bag noch nicht geöffnet?"
Voraussetzungen #
- Large Plan mit aktivem Abonnement
- MCP-fähiger KI-Client (z.B. Claude Desktop, Cursor, Continue)
- MCP-Token aus den Team-Einstellungen
Token erstellen #
- Gehe zu MCP in der Seitenleiste
- Klicke auf Token erstellen
- Vergib einen Namen (z.B. "Claude Desktop")
- Kopiere den Token – er wird nur einmal angezeigt!
Integration einrichten #
Claude Desktop #
Öffne die Claude Desktop Konfiguration:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%Claudeclaude_desktop_config.json
Füge den Vigoba MCP-Server hinzu:
{
"mcpServers": {
"vigoba": {
"command": "npx",
"args": ["-y", "@anthropic/mcp-client"],
"env": {
"VIGOBA_MCP_TOKEN": "YOUR_TOKEN_HERE",
"VIGOBA_MCP_URL": "https://app.vigoba.de/mcp"
}
}
}
}
Starte Claude Desktop neu.
Cursor IDE #
In den Cursor-Einstellungen unter "MCP Servers":
{
"vigoba": {
"url": "https://app.vigoba.de/mcp",
"token": "YOUR_TOKEN_HERE"
}
}
Andere MCP-Clients #
Die meisten MCP-Clients unterstützen Server-URLs. Verwende:
- URL:
https://app.vigoba.de/mcp - Token: Dein MCP-Token (als Bearer-Token oder in der Konfiguration)
Verfügbare Tools #
Nach der Integration stehen dem KI-Assistenten folgende Tools zur Verfügung:
Events #
| Tool | Beschreibung |
|---|---|
list_events |
Alle Events des Teams auflisten |
get_event |
Details eines Events abrufen |
create_event |
Neues Event erstellen |
update_event |
Event bearbeiten |
delete_event |
Event löschen |
Goodie Bags #
| Tool | Beschreibung |
|---|---|
list_bags |
Alle Bags auflisten (optional nach Event) |
get_bag |
Details eines Bags abrufen |
create_bag |
Neuen Bag erstellen |
update_bag |
Bag bearbeiten |
publish_bag |
Bag veröffentlichen |
get_bag_link |
Öffentlichen Link abrufen |
Goodies #
| Tool | Beschreibung |
|---|---|
list_goodies |
Alle Goodies eines Bags |
add_goody |
Goody hinzufügen |
update_goody |
Goody bearbeiten |
delete_goody |
Goody entfernen |
reorder_goodies |
Reihenfolge ändern |
Empfänger #
| Tool | Beschreibung |
|---|---|
list_recipients |
Empfänger eines Bags |
add_recipient |
Empfänger hinzufügen |
add_recipients_bulk |
Mehrere Empfänger hinzufügen |
send_magic_links |
Magic Links versenden |
check_access_status |
Wer hat geöffnet? |
Analytics #
| Tool | Beschreibung |
|---|---|
get_overview_stats |
KPI-Übersicht |
get_timeseries |
Zeitverlaufs-Daten |
get_device_stats |
Geräte-Verteilung |
get_top_performers |
Best-performende Bags/Goodies |
get_interactions |
Interaktions-Breakdown |
Beispiel-Konversationen #
Goodie Bag erstellen #
Du: "Erstelle einen Goodie Bag für unser Team-Meeting nächste Woche mit einem Link zu unserer Präsentation und einem Feedback-Formular."
Claude: "Ich erstelle den Goodie Bag für euer Team-Meeting. Ich werde:
- Einen neuen Bag erstellen
- Einen Link-Goody für die Präsentation hinzufügen
- Einen Link-Goody für das Feedback-Formular hinzufügen
[Ruft create_bag, add_goody (2x) auf]
Fertig! Der Bag ‘Team-Meeting Q1’ ist erstellt. Hier ist der Link: https://app.vigoba.de/b/xyz123
Soll ich ihn direkt veröffentlichen?"
Analytics abfragen #
Du: "Wie hat unser Konferenz-Bag letzte Woche performed?"
Claude: [Ruft get_overview_stats, get_top_performers auf]
"Hier die Analytics für ‘Tech Conference 2026’ (letzte 7 Tage):
📊 Übersicht:
- 847 Aufrufe (+23% zur Vorwoche)
- 612 unique Besucher
- 234 Interaktionen
🏆 Top-Goodies:
- ‘Speaker Slides’ – 156 Downloads
- ‘30% Rabattcode’ – 89 Kopien
- ‘Networking-Liste’ – 67 Downloads
📱 Geräte:
- 58% Mobile
- 38% Desktop
- 4% Tablet
Soll ich einen detaillierten Report erstellen?"
Empfänger verwalten #
Du: "Wer hat den VIP-Bag noch nicht geöffnet? Schick denen nochmal den Magic Link."
Claude: [Ruft check_access_status, send_magic_links auf]
"Von 45 VIP-Empfängern haben 12 den Bag noch nicht geöffnet. Ich habe ihnen gerade den Magic Link erneut gesendet:
- max.mustermann@example.com
- anna.schmidt@example.com
- [… 10 weitere]
Die E-Mails sind raus!"
Sicherheit #
- Token-Scope: MCP-Tokens haben nur Zugriff auf Team-Ressourcen
- Audit-Log: Alle MCP-Aktionen werden protokolliert
- Token-Widerruf: Tokens können jederzeit widerrufen werden
- Rate Limits: 100 Requests pro Minute pro Token
Fehlerbehebung #
"Token ungültig" #
- Prüfe, ob der Token korrekt kopiert wurde
- Stelle sicher, dass das Team einen aktiven Large Plan hat
- Erstelle ggf. einen neuen Token
"Keine Berechtigung" #
- Der Token gehört zu einem anderen Team
- Das Feature ist nicht im Plan enthalten
"Verbindung fehlgeschlagen" #
- Prüfe die URL:
https://app.vigoba.de/mcp - Firewall/Proxy-Einstellungen prüfen
Best Practices #
✅ Einen Token pro Client – Einfacheres Widerrufen bei Bedarf
✅ Aussagekräftige Namen – "Claude Desktop Arbeit", "Cursor Projekt X"
✅ Regelmäßige Rotation – Tokens alle 90 Tage erneuern
✅ Audit-Log prüfen – Bei verdächtigen Aktivitäten Token widerrufen
Weiterführende Links #
- API-Dokumentation – REST API für eigene Integrationen
- Webhook-Integrationen – Automatisierungen mit externen Systemen
🤖 Fragen zur MCP-Integration? Schreib uns an support@vigoba.de