API & MCP

Ihr CRM als Werkzeugkasten – für Claude, n8n und eigene Software

Jede Funktion von impulsCRM ist auch ein Endpunkt der REST-API. Der MCP-Server macht daraus 152 Werkzeuge, mit denen KI-Assistenten direkt im CRM arbeiten – mit Ihren Berechtigungen, in Ihrem Mandanten, mit Audit-Protokoll.

Swagger-Dokumentation MCP-Server anbinden

152

Werkzeuge – REST, MCP und KI-Chat teilen sich eine Basis

Gruppen – von Kunden bis Administration

Token-Stufen: read, write, admin

Clients: Claude Code, Claude Desktop, claude.ai, ChatGPT, n8n, Cursor

REST-API

Alles, was die Anwendung kann, kann auch Ihr Code

Die Oberfläche von impulsCRM benutzt dieselbe API, die Ihnen offensteht. Es gibt keine zweite, abgespeckte Schnittstelle – was Sie im Browser klicken, können Sie per HTTP aufrufen.

Jede Funktion der Anwendung ist auch ein Endpunkt – Kunden, Offerten, Aufträge, Rechnungen, Gutschriften, Lieferscheine, Produkte, Zeiten, Spesen, Verträge, Automatisierungen, Export
Interaktive Swagger-Dokumentation direkt in Ihrer Installation unter /api/docs
Persönliche API-Tokens unter Einstellungen → API: Scope, Ablaufdatum, letzte Verwendung, Widerruf mit einem Klick
Das CRM rechnet: Nummernkreise, MwSt., Rundung auf 5 Rappen und Mandantentrennung gelten auch für API-Aufrufe
Öffentlicher Web-Formular-Endpunkt für das Kontaktformular Ihrer Website (Plugin) – Leads werden zu Kunden
Webhooks an n8n bei Rechnung, Zahlung, Kunde, Offerte und Auftrag (Plugin)

API-Tokens · drei Stufen

read
Lesen und Suchen – Listen, Details, PDFs, Auswertungen. Erstellt und ändert nichts.
write
Alles aus read plus Erstellen, Ändern, Senden, Umwandeln und Löschen von Dokumenten.
admin
Alles aus write plus Benutzer, Einladungen, Plugins, Firmeneinstellungen und Audit-Protokoll.

curl https://crm.impulscrm.ch/api/invoices?status=overdue \
  -H "Authorization: Bearer icrm_IHR_TOKEN"

Tokens beginnen mit icrm_, werden nur als Hash gespeichert und zeigen im CRM, wann und von wo sie zuletzt benutzt wurden.

MCP-Server

https://mcp.impulscrm.ch/mcp

152 Tools

Web, Desktop-App und Mobile – ohne Installation, per OAuth-Freigabe.

Einstellungen → Connectors → Custom Connector hinzufügen
Name:       impulsCRM
URL:        https://mcp.impulscrm.ch/mcp
Client-ID:  (leer lassen)

→ Verbinden. Auf der Freigabeseite das API-Token
  (icrm_…) einfügen – fertig. impulsCRM steht in jedem
  Chat als Connector bereit. ChatGPT: gleiches Muster.

Token unter Einstellungen → API erstellen – Scope read, write oder admin. Der Server prüft es beim ersten Aufruf gegen das CRM.

MCP-Server

Claude arbeitet in Ihrem CRM – in fünf Minuten eingerichtet

Der MCP-Server stellt die ganze API als 152 Werkzeuge im Model Context Protocol bereit. Claude Code, Claude Desktop, claude.ai, ChatGPT, n8n oder Cursor verbinden sich mit einem API-Token – und können dann suchen, Kunden anlegen, Offerten schreiben, PDFs holen, Rechnungen senden und als bezahlt markieren.

Streamable-HTTP-Endpunkt /mcp – Verbindung mit einem Bearer-Token oder per OAuth-Freigabeseite (claude.ai, ChatGPT)
Reiner Proxy auf die REST-API: keine eigene Datenbank, keine Passwörter, keine eigene Logik
Scope gilt 1:1 – ein read-Token kann über MCP nichts erstellen, ein write-Token keine Benutzer ändern
Jeder Aufruf steht im CRM: «Zuletzt via MCP» am Token, Quelle «MCP» im Audit-Protokoll
PDFs kommen als Download-Link zurück (15 Minuten gültig, nur im Arbeitsspeicher)
Auch lokal per stdio für Claude Desktop und Claude Code ohne Netzwerkfreigabe

Läuft in der Cloud oder auf Ihrem Server neben dem CRM – als eigener Docker-Container, auch auf einer Synology-NAS.

Werkzeuge

152 Werkzeuge in 22 Gruppen

Identisch für REST-API, MCP-Server und den KI-Chat in der App. Namen wie in der Dokumentation – so findet ein Assistent sofort, was er braucht.

System & Suche

get_crm_status, search, list_overdue_invoices

Kunden

create_customer, get_customer_stats, create_customer_portal_token

Offerten

create_quote, share_quote, convert_quote_to_order

Aufträge

convert_order_to_invoice, merge_order_invoices

Rechnungen

send_invoice, mark_invoice_paid, get_invoice_pdf

Support-Verträge

create_support_contract, send_support_contract

Produkte

create_product, import_products_preview

Gutschriften & Lieferscheine

create_credit_note_from_invoice, mark_delivery_note_delivered

Zeiterfassung & Ausgaben

create_time_entry, generate_invoice_from_time_entries

Abo-Rechnungen

create_recurring_invoice, generate_recurring_invoice_now

Automatisierung

create_automation_rule, test_automation_rule

Aktivitäten, Benachrichtigungen, Web-Anfragen

create_activity, list_web_form_messages

Export

export_csv, export_pdf_report

Administration

invite_user, toggle_plugin, list_audit_log, update_company_settings

Vollständige Liste als JSON: https://mcp.impulscrm.ch/tools

Was damit entsteht

Drei Dinge, die Kunden als Erstes damit bauen

Claude als Sachbearbeiter

«Erstelle für Modehaus Lüthi eine Offerte mit 24 Stunden Webdesign und schick sie.» Claude sucht den Kunden, nimmt Preise aus dem Katalog, erstellt die Offerte und fragt vor dem Versand nach.

search → list_products → create_quote → send_quote

n8n-Agent für den Posteingang

Ein n8n-Workflow liest E-Mails, erkennt Anfragen und legt über den MCP-Server Kunden und Aktivitäten an – oder holt für den Support den Vertragsstatus des Absenders.

search → create_customer → create_activity → get_support_contract

Eigene Software und Auswertungen

Ihr Shop, Ihre Zeiterfassung oder ein Bericht in Ihrem BI-Werkzeug sprechen direkt mit der REST-API: Rechnungen abrufen, Zeiten buchen, offene Posten auswerten.

GET /api/invoices · POST /api/time-entries · GET /api/stats

Sicherheit

Die Kontrolle bleibt im CRM

Ein KI-Assistent bekommt nie mehr Rechte als das Token, mit dem er verbunden ist. Und alles, was er tut, ist nachvollziehbar.

Kein Umweg an den Rechten vorbei
Der MCP-Server ist ein Proxy auf die REST-API. Rollen, Scope und Mandant prüft das CRM bei jedem Aufruf – der Server selbst hat keine Datenbank und keine Passwörter.
Bearer-Token oder OAuth
Claude Code, Claude Desktop und n8n senden das Token als Header. claude.ai und ChatGPT nutzen die OAuth-Freigabeseite des Servers (PKCE, Refresh-Rotation, Widerruf).
Nachvollziehbar
Jeder Aufruf steht im Audit-Protokoll mit Quelle «MCP» oder «API», Benutzer und Zeitpunkt. Am Token sehen Sie «Zuletzt via MCP» und die Anzahl Aufrufe.
Rückfrage bei heiklen Aktionen
Löschen, Versenden und öffentliche Links sind als «destruktiv» markiert – ein Assistent fragt nach, bevor er sie ausführt. Widerrufen Sie das Token, ist die Verbindung sofort beendet.

KI-Modell nach Wahl

Auch die KI im CRM läuft auf Wunsch bei Ihnen

Der KI-Assistent, die Insights und die KI-Aktionen in Automatisierungen brauchen ein Sprachmodell. Welches, entscheiden Sie unter Einstellungen → KI: ein gehostetes über OpenRouter – oder ein lokales auf einem Server in Ihrem Netz.

KI-Chat mit allen 152 Werkzeugen
Insights auf dem Dashboard
Regeln aus natürlicher Sprache entwerfen
KI-Aktionen in Automatisierungen
KI-Mahnwesen und KI-MWST-Abrechnung (Plugins)

Daten bleiben im Haus

Lokal – Ihr eigener Server

Ein OpenAI-kompatibler Endpunkt in Ihrem Netz: Ollama, LM Studio, SGLang oder vLLM. Kein API-Schlüssel, keine Cloud – Kundendaten bleiben im Haus.

Ollama
LM Studio
SGLang
vLLM

Gehostet – OpenRouter

Zugriff auf Modelle von Anthropic, OpenAI, Meta, Google und weiteren mit einem einzigen Schlüssel. Modell jederzeit wechselbar, ohne Umbau.

Claude
GPT
Llama
Gemini

Nächster Schritt

Erzählen Sie uns, was Sie anbinden möchten.

Ob Claude im Alltag, ein n8n-Workflow oder Ihre eigene Software – wir richten Token, MCP-Server und auf Wunsch ein lokales KI-Modell mit Ihnen ein.

Anfrage stellen Demo ansehen