> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-Server

> Verbinde KI-Tools direkt mit deinen Fynn-Daten. Der Fynn MCP-Server stellt Rechnungen, Debitoren, Zahlungen und den DATEV-Export als Werkzeuge bereit, die dein KI-Client aufruft.

Der **Fynn MCP-Server** verbindet KI-Tools mit deinen Fynn-Daten. MCP (Model Context Protocol) ist ein offener Standard, über den KI-Clients wie Claude Code, Claude Desktop oder andere MCP-fähige Anwendungen Werkzeuge aufrufen. Statt Antworten zu erfinden, fragt der KI-Client die echten Daten direkt bei Fynn ab: Rechnungen suchen, den Saldo eines Kunden prüfen, eine Storno-Kette nachvollziehen oder einen DATEV-Export anstoßen.

<Info>
  Endpunkt: `https://coreapi.io/portal/mcp` (Sandbox: `https://preview.coreapi.io/portal/mcp`). Die Verbindung läuft über den Streamable-HTTP-Transport der MCP-Spezifikation.
</Info>

## Verfügbare Werkzeuge

Alle Werkzeuge sind lesend. Die einzige Ausnahme ist das Anstoßen eines DATEV-Exports.

| Werkzeug             | Zweck                                                                      |
| -------------------- | -------------------------------------------------------------------------- |
| Rechnungs-Suche      | Rechnungen nach Zeitraum, Status, Kunde und weiteren Kriterien finden      |
| Debitoren-Suche      | Kunden anhand von Name, Nummer oder weiteren Merkmalen suchen              |
| Storno-Ketten        | Ausgangs-, Korrektur- und Storno-Rechnungen im Zusammenhang nachvollziehen |
| Kundensaldo          | Offenen Saldo eines Kunden abrufen                                         |
| Zahlungen            | Zahlungen zu Rechnungen und Kunden auflisten                               |
| Rechnungs-PDF        | Das PDF einer Rechnung herunterladen                                       |
| DATEV-Export starten | Einen DATEV-Export für einen Zeitraum anstoßen                             |
| DATEV-Export-Status  | Den Fortschritt eines laufenden Exports abfragen                           |
| Ping                 | Verbindung und Authentifizierung testen                                    |

## Zugriffs-Token in der App anlegen

Der MCP-Server authentifiziert sich mit einem persönlichen API-Token. Jeder Nutzer legt seine Token selbst an.

<Steps>
  <Step title="API-Tokens öffnen">
    Öffne in der App **Konto** und dort **API-Tokens**.
  </Step>

  <Step title="Token erstellen">
    Lege einen neuen Token an. Vergib einen sprechenden Namen, damit du später erkennst, wofür der Token gedacht ist, etwa nach Werkzeug oder Gerät.
  </Step>

  <Step title="Ablaufdatum setzen">
    Setze ein Ablaufdatum. So läuft der Token automatisch aus, falls du ihn vergisst.
  </Step>

  <Step title="Token kopieren">
    Der Token wird genau einmal angezeigt. Kopiere ihn sofort und speichere ihn sicher. Danach lässt er sich nicht mehr einsehen.
  </Step>
</Steps>

<Tip>
  Lege pro Werkzeug oder Gerät einen eigenen Token an. So kannst du einen einzelnen Zugang widerrufen, ohne die anderen zu unterbrechen.
</Tip>

Alternativ funktioniert auch ein organisationsweiter API-Schlüssel aus **Einstellungen > Entwickler > API-Schlüssel**. Ein solcher Schlüssel ist an die Organisation gebunden, nicht an einen einzelnen Nutzer.

## Claude Code anbinden

In Claude Code fügst du den Server mit einem Befehl hinzu. Ersetze `api_DEIN_TOKEN` durch deinen Token.

```bash theme={null}
claude mcp add --transport http fynn https://coreapi.io/portal/mcp \
  --header "Authorization: Bearer api_DEIN_TOKEN"
```

Danach stehen die Fynn-Werkzeuge in Claude Code zur Verfügung. Mit dem Ping-Werkzeug prüfst du, ob die Verbindung steht.

## Andere MCP-Clients anbinden

Viele MCP-Clients lesen ihre Serverliste aus einer `.mcp.json`. Trage den Fynn-Server als HTTP-Server ein und schicke deinen Token im `Authorization`-Header mit.

```json theme={null}
{
  "mcpServers": {
    "fynn": {
      "type": "http",
      "url": "https://coreapi.io/portal/mcp",
      "headers": {
        "Authorization": "Bearer api_DEIN_TOKEN"
      }
    }
  }
}
```

## Sicherheit und Berechtigungen

<Warning>
  Ein Token gibt Zugriff auf deine Fynn-Daten. Behandle ihn wie ein Passwort. Trage ihn nicht in geteilte Repositories ein und gib ihn nicht weiter.
</Warning>

* **Der Token trägt deine Rechte.** Er ist an deinen Benutzer gebunden und hat exakt die Berechtigungen, die du in der jeweiligen Organisation hast. Was du in der App nicht sehen darfst, liefert auch der MCP-Server nicht.
* **Alle Ergebnisse sind organisationsgetrennt.** Ein Token gibt niemals Daten anderer Organisationen zurück.
* **Abgelaufene Token werden abgelehnt.** Nach dem Ablaufdatum funktioniert ein Token nicht mehr.
* **Werkzeuge sind lesend.** Die einzige schreibende Aktion ist das Anstoßen eines DATEV-Exports.

### Zielorganisation wählen

Gehörst du zu mehreren Organisationen, kannst du die Zielorganisation über den zusätzlichen Header `X-Fynn-Tenant-Id` festlegen.

```bash theme={null}
claude mcp add --transport http fynn https://coreapi.io/portal/mcp \
  --header "Authorization: Bearer api_DEIN_TOKEN" \
  --header "X-Fynn-Tenant-Id: DEINE_ORGANISATIONS_ID"
```

Ohne diesen Header gilt deine Standard-Organisation. Bei einem organisationsweiten API-Schlüssel gilt immer dessen Organisation, der Header hat dann keine Wirkung.

## Token widerrufen

Vermutest du, dass ein Token in falsche Hände geraten ist, lösche ihn in der App unter **Konto > API-Tokens**. Ab dem nächsten Aufruf wird der Zugriff sofort abgelehnt. Erstelle bei Bedarf einen neuen Token und trage ihn in deinem MCP-Client ein.