nikolausm/mcp-sevdesk

API development

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

32 stars 9 forks 품질 73 트렌드 32

Repository Install

MCP Server für sevdesk Buchhaltungs-API - Kontakte, Rechnungen, Belege, Bankkonten und Artikel verwalten

개요

Ein MCP (Model Context Protocol) Server für die sevdesk API. Ermöglicht die Integration von sevdesk-Buchhaltungsfunktionen in Claude und andere MCP-kompatible Anwendungen. - : Erstellen, lesen, aktualisieren und löschen von Kontakten (Kunden, Lieferanten, Partner) - : Auflisten, abrufen, als PDF exportieren, per E-Mail versenden, buchen und stornieren - : Verwalten von Eingangsrechnungen und Ausgaben - : Verwalten von Bankkonten und Transaktionen - : Verwalten von Produkten und Dienstleistungen Setze die Umgebungsvariable SEVDESK_API_TOKEN mit deinem sevdesk API-Token: Den API-Token findest du in sevdesk unter: Einstellungen → Benutzer → API-Token Füge den Server zu deiner Claude Desktop Konfiguration hinzu (~/.config/claude/claude_desktop_config.json): Dieser Server basiert auf der offiziellen sevdesk API v1. Weitere Informationen zur API findest du in der sevdesk API-Dokumentation.

README

원문 README의 일부입니다. 원문 보기.

mcp-sevdesk

Ein MCP (Model Context Protocol) Server für die sevdesk API. Ermöglicht die Integration von sevdesk-Buchhaltungsfunktionen in Claude und andere MCP-kompatible Anwendungen.

Features

Kontakte: Erstellen, lesen, aktualisieren und löschen von Kontakten (Kunden, Lieferanten, Partner)
Rechnungen: Auflisten, abrufen, als PDF exportieren, per E-Mail versenden, buchen und stornieren
Belege (Voucher): Verwalten von Eingangsrechnungen und Ausgaben
Bankkonten: Verwalten von Bankkonten und Transaktionen
Artikel: Verwalten von Produkten und Dienstleistungen

Installation

npm install
npm run generate-types
npm run build

Konfiguration

Setze die Umgebungsvariable SEVDESK_API_TOKEN mit deinem sevdesk API-Token:

export SEVDESK_API_TOKEN="dein-32-zeichen-hex-token"

Den API-Token findest du in sevdesk unter: Einstellungen → Benutzer → API-Token

Verwendung

Als MCP-Server

Füge den Server zu deiner Claude Desktop Konfiguration hinzu (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sevdesk": {
      "command": "node",
      "args": ["/pfad/zu/mcp-sevdesk/dist/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "dein-api-token"
      }
    }
  }
}

Direkt ausführen

SEVDESK_API_TOKEN="dein-token" npm start

Verfügbare Tools

Kontakte

Tool	Beschreibung
`list_contacts`	Alle Kontakte auflisten
`get_contact`	Einzelnen Kontakt abrufen
`create_contact`	Neuen Kontakt erstellen
`update_contact`	Kontakt aktualisieren
`delete_contact`	Kontakt löschen

Rechnungen

Tool	Beschreibung
`list_invoices`	Alle Rechnungen auflisten
`get_invoice`	Einzelne Rechnung abrufen
`get_invoice_pdf`	Rechnung als PDF abrufen
`send_invoice_by_email`	Rechnung per E-Mail versenden
`mark_invoice_as_sent`	Rechnung als versendet markieren
`book_invoice`	Rechnung als bezahlt buchen
`cancel_invoice`	Rechnung stornieren

Belege (Voucher)

Tool	Beschreibung
`list_vouchers`	Alle Belege auflisten
`get_voucher`	Einzelnen Beleg abrufen
`book_voucher`	Beleg als bezahlt buchen
`get_voucher_positions`	Belegpositionen abrufen
`upload_voucher_file`	Belegdatei hochladen

Bankkonten

Tool	Beschreibung
`list_check_accounts`	Alle Bankkonten auflisten
`get_check_account`	Einzelnes Bankkonto abrufen
`get_check_account_balance`	Kontostand abrufen
`list_transactions`	Transaktionen auflisten
`get_transaction`	Einzelne Transaktion abrufen
`create_transaction`	Neue Transaktion erstellen

Artikel

Tool	Beschreibung
`list_parts`	Alle Artikel auflisten
`get_part`	Einzelnen Artikel abrufen
`create_part`	Neuen Artikel erstellen

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "sevdesk": {
      "command": "node",
      "args": ["/pfad/zu/mcp-sevdesk/dist/index.js"],
      "env": {
        "SEVDESK_API_TOKEN": "dein-api-token"
      }
    }
  }
}