Skip to main content

​
Setup & Authentifizierung

Der Fyvel MCP-Server wird mit einem eigenen MCP-Credential abgesichert. Dieses Credential ist nicht identisch mit dem API-Key für Excel oder Google Sheets.

​
Endpoint

https://www.fyvel.io/mcp

​
Authentifizierung

Sende die MCP-Credentials als Bearer-Token im HTTP-Header:
Fehlt der Header oder ist der Token ungültig, lehnt der Server den Aufruf ab.

​
MCP-Credential in Fyvel erzeugen

  1. Öffne in Fyvel Unternehmenseinstellungen > MCP
  2. Klicke auf Neues MCP-Credential
  3. Bestätige die Erstellung
  4. Kopiere den Token sofort - er wird nur einmal angezeigt

​
Verhalten der Credentials

  • MCP-Credentials sind organisationsgebunden
  • Wenn du ein neues MCP-Credential erzeugst, werden bestehende MCP-Credentials dieser Organisation widerrufen
  • Der API-Key für Excel und Google Sheets bleibt davon unberührt

​
Erster Aufruf

Für neue MCP-Clients ist diese Reihenfolge sinnvoll:
  1. list_companies
  2. passende companyUuid auswählen
  3. danach das benötigte organisationsweite oder unternehmensbezogene Tool aufrufen

​
Wichtige Scope-Regeln

  • Die Organisation ergibt sich aus dem Bearer-Token
  • Viele Tools erwarten zusätzlich eine companyUuid
  • Die companyUuid erhältst du über list_companies