MCP Server — spiritflow mit KI verbinden

Der spiritflow MCP Server ermöglicht KI-Assistenten wie Claude, ChatGPT und Mistral den direkten Zugriff auf Aufgaben, Projekte, Zeiterfassung und mehr. Steuere spiritflow per natürlicher Sprache.

npm: spiritflow-mcp MIT Lizenz

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der KI-Modellen den strukturierten Zugriff auf externe Tools und Datenquellen ermöglicht. Anstatt Copy-Paste oder manuelle Exporte zu nutzen, kommuniziert die KI direkt mit spiritflow.

Natürliche Sprache

Sage der KI was du brauchst — sie führt die Aktionen in spiritflow aus.

Automatisierung ohne Code

Keine Skripte oder API-Kenntnisse nötig — die KI übernimmt die technischen Details.

Breite Kompatibilität

Funktioniert mit Claude, ChatGPT, Mistral und allen MCP-fähigen Clients.

Sicherer Zugriff

Scoped API-Keys steuern exakt, welche Daten und Aktionen die KI nutzen darf.

Quick Start

Füge den MCP Server in deine ~/.claude/settings.json oder auf Projekt-Ebene ein:

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

Konfiguriere den Server in ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

ChatGPT unterstützt MCP-Server nativ. Konfiguriere den Server in den ChatGPT-Einstellungen unter "MCP Servers":

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

Hinweis: MCP-Support in ChatGPT erfordert einen Plus- oder Team-Plan.

Mistral Le Chat und Mistral-Agents unterstützen das Model Context Protocol. Füge den Server in deiner Konfiguration hinzu:

{
  "mcpServers": {
    "spiritflow": {
      "command": "npx",
      "args": ["-y", "spiritflow-mcp"],
      "env": {
        "SPIRITFLOW_API_KEY": "sf_live_..."
      }
    }
  }
}

Hinweis: MCP-Support bei Mistral ist über Le Chat und die Agents-API verfügbar.

Starte den MCP Server direkt über die Kommandozeile — kompatibel mit jedem MCP-Client:

SPIRITFLOW_API_KEY=sf_live_... npx spiritflow-mcp

Verfügbare Tools

Der MCP Server stellt alle wichtigen spiritflow-Funktionen als Tools bereit, die KI-Assistenten nutzen können.

Tasks

Aufgaben erstellen, aktualisieren, Status ändern und zuweisen.

Projects

Projekte verwalten, Mitglieder und Aufgaben einsehen.

Customers

Kundenverwaltung — anlegen, bearbeiten und suchen.

Time Tracking

Zeiteinträge erfassen, bearbeiten und auswerten.

Receipts & Invoices

Belege und Rechnungen abrufen und verwalten.

Users

Workspace-Nutzer und Rollen auflisten.

Search

Volltextsuche über alle Entitäten.

Webhooks

Webhooks registrieren und verwalten.

CTI

Kundensuche per Telefonnummer (Computer-Telephony-Integration).

Notifications

Benachrichtigungen abrufen und verwalten.

Vacation

Urlaub und Abwesenheiten verwalten.

Umgebungsvariablen

Variable	Pflicht	Default	Beschreibung
`SPIRITFLOW_API_KEY`	Ja	—	Dein spiritflow API-Key
`SPIRITFLOW_URL`	Nein	https://app.spiritflow.team	Basis-URL deiner Instanz

API-Key erstellen

Key anlegen

In spiritflow unter Einstellungen > API-Keys einen neuen Key anlegen.

Scopes wählen

Berechtigungen auswählen: tasks:read, tasks:write, projects:read, time:write und weitere.

Key eintragen

Key kopieren und in der MCP-Konfiguration als SPIRITFLOW_API_KEY eintragen.

Ressourcen

npm-Paket spiritflow-mcp

GitHub Source Code

MCP Protocol Spezifikation

REST API API-Referenz

Jetzt kostenlos testen