Skip to main content

Setup & authentication

The Fyvel MCP server is protected with its own MCP credential. This credential is not the same as the API key for Excel or Google Sheets.

Endpoint

https://www.fyvel.io/mcp

Authentication

Send the MCP credentials as a bearer token in the HTTP header:
If the header is missing or the token is invalid, the server rejects the call. For Claude on claude.ai (custom connector), see Connect Claude.

Create an MCP credential in Fyvel

  1. In Fyvel, open Company settings > MCP
  2. Click New MCP credential
  3. Confirm creation
  4. Copy the token immediately — it is shown only once

How credentials behave

  • MCP credentials are bound to the organisation
  • When you create a new MCP credential, existing MCP credentials of that organisation are revoked
  • The API key for Excel and Google Sheets is not affected

First call

For new MCP clients this order works well:
  1. list_companies
  2. choose the matching companyUuid
  3. then call the organisation-wide or company-specific tool you need

Important scope rules

  • The organisation comes from the bearer token
  • Many tools also expect a companyUuid
  • You get the companyUuid from list_companies