MCP-Server

Überblick

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem KI-Assistenten externe Werkzeuge nutzen. Unser MCP-Server stellt die Funktionen der REST-API als Werkzeuge bereit.

Im Alltag heißt das: Sie sagen Ihrem Assistenten „Ich brauche einen Businessplan für den Gründungszuschuss, ich eröffne ein Café in Leipzig“. Er stellt die Fragen, die auch unser Fragebogen stellt, nur im Gespräch und mit Rückfragen, wo eine Antwort zu dünn ist.

• Gründerinterview führen und fehlende Angaben gezielt nachfragen.
• Kostenlosen Entwurf anlegen und die Executive Summary besprechen.
• Nach ausdrücklicher Zustimmung den vollständigen Plan bestellen.
• Finanzplan erklären: Wann ist der Break-even, wo wird es knapp, was passiert, wenn der Umsatz langsamer anläuft.

Zugang

Der MCP-Server nutzt dieselben Schlüssel und dieselbe Abrechnung wie die API: Entwürfe kostenlos, jeder bestellte Plan 199,00 €, Monatsrechnung. Schlüssel vergeben wir von Hand über [email protected].

Für Gründungsberatungen bietet sich ein eigener Schlüssel je Beraterin an. So sehen Sie auf der Rechnung, wer welchen Plan bestellt hat.

Serveradresse

Der Server spricht MCP über Streamable HTTP unter https://mcp.businessplanersteller.de/mcp. Authentifiziert wird mit dem API-Schlüssel als Bearer-Token.

curl https://mcp.businessplanersteller.de/health
# {"status":"ok","protocol":["2025-06-18","2025-03-26"]}

Client einrichten

Claude Code

claude mcp add --transport http businessplan \
  https://mcp.businessplanersteller.de/mcp \
  --header "Authorization: Bearer $BPE_API_KEY"

Claude Desktop

Claude Desktop bindet entfernte Server über mcp-remote an. Eintrag in claude_desktop_config.json, danach die App neu starten.

{
  "mcpServers": {
    "businessplan": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.businessplanersteller.de/mcp",
        "--header", "Authorization: Bearer ${BPE_API_KEY}"
      ],
      "env": { "BPE_API_KEY": "sk_live_..." }
    }
  }
}

Cursor und andere Clients

Clients, die entfernte Server direkt unterstützen, brauchen nur Adresse und Header.

{
  "mcpServers": {
    "businessplan": {
      "url": "https://mcp.businessplanersteller.de/mcp",
      "headers": { "Authorization": "Bearer ${env:BPE_API_KEY}" }
    }
  }
}

Zum Ausprobieren einen sk_test_-Schlüssel verwenden. Bestellungen kosten dann nichts und liefern einen Beispielplan.

Werkzeuge

Ein Werkzeug zum Löschen gibt es bewusst nicht. Löschen bleibt eine Entscheidung, die Sie über die API oder per E-Mail treffen.

Werkzeugdefinitionen

Jedes Werkzeug hat ein JSON-Schema für die Eingabe und eine Beschreibung, die für das Modell geschrieben ist. Bei order_plan steht dort die wichtigste Regel: nur nach ausdrücklicher Zustimmung zum genannten Preis.

{
  "name": "order_plan",
  "description": "Bestellt den vollständigen Businessplan zu einem Entwurf. KOSTENPFLICHTIG. Nur aufrufen, wenn der Nutzer in dieser Unterhaltung ausdrücklich zugestimmt hat, nachdem ihm der Preis genannt wurde. Setze confirmed_price auf den Betrag, dem er zugestimmt hat.",
  "inputSchema": {
    "type": "object",
    "required": ["plan_id", "confirmed_price"],
    "properties": {
      "plan_id": { "type": "string" },
      "confirmed_price": { "type": "integer", "description": "Preis in Cent, dem der Nutzer zugestimmt hat" },
      "notify_email": { "type": "string", "format": "email" }
    }
  },
  "annotations": { "readOnlyHint": false, "destructiveHint": false, "idempotentHint": true }
}

Werkzeugergebnisse

Ergebnisse enthalten einen kurzen Text für den Assistenten, einen Verweis auf die Ressource und structuredContent mit den genauen Werten. Bei start_plan gehört dazu die Liste der Felder, die noch fehlen, damit der Assistent nachfragt statt zu raten.

{
  "content": [
    {
      "type": "text",
      "text": "Entwurf angelegt. Executive Summary und Gliederung sind fertig (kostenlos). Nicht angegeben wurden: gruenderprofil, investitionen, angebot_preise. Ohne diese Angaben wird der Finanzplan aus Branchenwerten geschätzt; frage den Nutzer danach, bevor du bestellst."
    },
    { "type": "resource_link", "uri": "plan://bp_7Kx2mQ9tLw", "name": "Entwurf", "mimeType": "application/json" }
  ],
  "structuredContent": {
    "plan_id": "bp_7Kx2mQ9tLw",
    "teaser_status": "completed",
    "missing_fields": ["gruenderprofil", "investitionen", "angebot_preise"],
    "price": 19900,
    "currency": "eur"
  },
  "isError": false
}

Ressourcen

Neben Werkzeugen stellt der Server Ressourcen bereit, die ein Client als Kontext in das Gespräch laden kann, etwa um ein Kapitel gemeinsam durchzugehen.

plan://{id}                     Antworten, Status, Teaser
plan://{id}/chapters/{key}      ein Kapitel als Markdown
finance://{id}                  Kapitalbedarf, Finanzierung, Kennzahlen, 36 Monate
options://wizard                erlaubte Werte aller Auswahlfelder

Prompts

Der Server bringt fertige Prompts mit, die Clients als Befehle anzeigen. Sie geben dem Assistenten den Ablauf vor.

• gruenderinterview: sammelt alle Angaben in sinnvoller Reihenfolge und legt danach den Entwurf an.
• plan_gruendungszuschuss: Interview mit Fokus auf Tragfähigkeit, hauptberufliche Gründung und Lebensunterhalt.
• plan_bankgespraech: Interview mit Fokus auf Investitionen, Sicherheiten und Kapitaldienst.
• finanzplan_erklaeren: geht die Kennzahlen eines fertigen Plans durch und bereitet auf Rückfragen von Bank oder Agentur vor.

{
  "name": "gruenderinterview",
  "description": "Führt ein strukturiertes Gespräch mit einer Gründerin oder einem Gründer, sammelt alle Angaben für den Businessplan und legt danach einen kostenlosen Entwurf an.",
  "arguments": [
    { "name": "zweck", "description": "gruendungszuschuss, einstiegsgeld, kredit, investoren oder sonstiges", "required": false },
    { "name": "branche", "required": false }
  ]
}

Beispielgespräch

Ein Elektromeister erarbeitet seinen Plan mit Claude. Werkzeugaufrufe stehen in eckigen Klammern.

Nutzer:  Ich mache mich als Elektromeister selbstständig und brauche
         einen Businessplan für den Gründungszuschuss.

Agent:   [list_options] Gern. Ein paar Fragen: Wo sitzt der Betrieb, planen
         Sie Mitarbeiter, und was müssen Sie anfangs anschaffen?

Nutzer:  Heilbronn, im ersten Jahr ein Geselle. Transporter und Werkzeug,
         zusammen etwa 31.000 Euro, 9.000 habe ich selbst.

Agent:   [start_plan: branche=handwerk, zweck=gruendungszuschuss, ...]
         Der Entwurf steht, hier die Executive Summary: ...
         Der vollständige Plan mit Markt, Finanzplan über drei Jahre und
         Word/Excel-Dateien kostet 199,00 €. Soll ich ihn bestellen?

Nutzer:  Ja, bitte.

Agent:   [order_plan: confirmed_price=19900]
         [get_plan ... pipeline_status=completed]
         Fertig. Break-even im 9. Monat, niedrigster Kontostand 3.120 € im
         Monat 5. PDF, Word und Excel: https://businessplanersteller.de/...

Was der Assistent nicht tut

• Er bestellt nie ohne Ihre ausdrückliche Zustimmung zum genannten Preis. Der Server prüft das: order_plan braucht confirmed_price, und der muss dem aktuellen Preis entsprechen.
• Er erfindet keine Zahlen zu Ihren Investitionen, Preisen oder Ihrem Eigenkapital. Fehlt etwas, fragt er nach oder sagt ausdrücklich, dass der Finanzplan aus Branchenwerten schätzt.
• Er verspricht keine Bewilligung von Gründungszuschuss, Einstiegsgeld oder Kredit und gibt sich nicht als fachkundige Stelle aus.
• Er löscht keine Pläne.

Scopes

Auf Wunsch stellen wir Schlüssel mit eingeschränkten Rechten aus, etwa für einen Assistenten, der Entwürfe anlegen, aber nichts bestellen darf.

Werkzeuge außerhalb der Scopes eines Schlüssels werden dem Client gar nicht erst angezeigt.

Fehler

Schlägt ein Werkzeugaufruf fehl, enthält das Ergebnis isError: true und einen Text, der dem Assistenten sagt, was schiefging und was er als Nächstes tun soll. So kann er sich selbst korrigieren oder Sie fragen.

{
  "content": [
    {
      "type": "text",
      "text": "Bestellung abgelehnt: confirmed_price (14900) weicht vom Preis ab (19900). Nenne dem Nutzer den aktuellen Preis von 199,00 € und frage erneut, bevor du order_plan aufrufst."
    }
  ],
  "isError": true
}

Limits

Werkzeugaufrufe zählen gegen dieselben Limits wie die API: 60 Anfragen pro Minute, 200 kostenlose Entwürfe pro Tag, 20 gleichzeitig laufende Pläne je Schlüssel. Die Links aus get_download_links gelten eine Stunde und lassen sich jederzeit neu abrufen.

Datenschutz

Der MCP-Server speichert nichts aus Ihrem Gespräch. Er erhält nur die Werkzeugaufrufe mit ihren Argumenten, also dieselben Angaben wie bei einer API-Anfrage, und verarbeitet sie wie dort beschrieben.

Was Ihr Assistent mit den Angaben macht, bestimmt dessen Anbieter. Wenn Sie Angaben von Mandanten besprechen, prüfen Sie die Datenschutzeinstellungen Ihres KI-Clients.

Support

Verbindet sich Ihr Client nicht oder verhält sich ein Werkzeug anders als beschrieben, schreiben Sie an [email protected] mit Name des Clients, Werkzeug und Uhrzeit.