Zum Hauptinhalt springen

Dokumentation

SDK Quickstart

Slonge Billing bietet drei npm-Pakete:

  • @slonge/cli — Kommandozeilen-Tool
  • @slonge/agent-sdk — TypeScript-SDK für die HTTP-API
  • @slonge/mcp-server — MCP-Server (stdio) für Claude Desktop / Cursor

Installation

npm install -g @slonge/cli

Token erstellen

  1. Im Dashboard zu Einstellungen → API-Tokens
  2. Neuer Token klicken
  3. Token kopieren (wird nur einmal angezeigt)

Konfiguration

export SLONGE_API_TOKEN=slk_...
export SLONGE_API_BASE_URL=https://app.slonge-billing.ch

Erster Aufruf

slonge client list
slonge invoice send <id>

Siehe slonge --help für die vollständige Referenz.

Programmatic SDK Usage

import { SdkClient, ClientResource } from '@slonge/agent-sdk';

const client = new SdkClient({
  baseUrl: 'https://app.slonge-billing.ch',
  apiToken: process.env.SLONGE_API_TOKEN!,
});

const clients = await new ClientResource(client).list();

MCP (Claude Desktop / Cursor)

Lokal via stdio:

npm install -g @slonge/mcp-server

Dann in claude_desktop_config.json:

{
  "mcpServers": {
    "slonge-billing": {
      "command": "slonge-mcp",
      "env": {
        "SLONGE_API_TOKEN": "slk_...",
        "SLONGE_API_BASE_URL": "https://app.slonge-billing.ch"
      }
    }
  }
}

Oder hosted via HTTP unter https://app.slonge-billing.ch/api/mcp — falls Ihr Client Remote-MCP-Server unterstützt.

ZurückBearbeitenWeiter