MCP Server

• Was ist MCP?
• Endpoint URL
• Verfügbare Tools
  • search_docs
  • get_doc
  • list_docs
• MCP Client konfigurieren
  • Claude Code
  • Claude Desktop und claude.ai
  • Cursor
  • VS Code (GitHub Copilot)

Die Flyo-Dokumentation stellt einen Remote MCP Server (Model Context Protocol) bereit. Damit können AI-Assistenten wie Claude Desktop, Cursor, VS Code Copilot und andere MCP-fähige Clients die gesamte Flyo-Dokumentation durchsuchen und einzelne Seiten abrufen.

Was ist MCP?

Das Model Context Protocol (MCP) ist ein offener Standard, der es AI-Assistenten ermöglicht, auf externe Datenquellen und Tools zuzugreifen. Über einen MCP Server können AI-Modelle in Echtzeit Informationen abfragen, in diesem Fall die vollständige Flyo-Dokumentation.

Endpoint URL

https://docs.flyo.cloud/api/mcp

Verfügbare Tools

search_docs

Durchsucht alle Dokumentationsseiten nach einem Suchbegriff (Titel und Inhalt).

Parameter	Typ	Pflicht	Beschreibung
query	string	Ja	Suchbegriff oder Phrase
limit	number	Nein	Max. Anzahl Ergebnisse (1 bis 20, Standard 8)

get_doc

Gibt den vollständigen Markdown-Inhalt einer einzelnen Dokumentationsseite zurück.

Parameter	Typ	Pflicht	Beschreibung
path	string	Ja	Slug der Seite, z.B. account, entities-fields, integrations-api

list_docs

Listet alle verfügbaren Dokumentationsseiten mit Slug und Titel auf. Nützlich, um herauszufinden, welche Seiten existieren.

Keine Parameter erforderlich.

MCP Client konfigurieren

Der Server verwendet den Transport Streamable HTTP. Wähle in deinem Client deshalb den Typ http (nicht sse). Mit dem veralteten Typ sse bleibt die Verbindung hängen und läuft nach 30 Sekunden in einen Timeout.

Claude Code

Im Terminal:

claude mcp add --transport http flyo-docs https://docs.flyo.cloud/api/mcp

Oder in der Datei .mcp.json im Projekt:

{
  "mcpServers": {
    "flyo-docs": {
      "type": "http",
      "url": "https://docs.flyo.cloud/api/mcp"
    }
  }
}

Claude Desktop und claude.ai

Gehe zu Settings → Connectors → Add custom connector und trage als URL https://docs.flyo.cloud/api/mcp ein. Eine Authentifizierung ist nicht nötig.

Cursor

Gehe zu Settings → MCP Servers → Add Server und trage ein:

• Name: flyo-docs
• Type: http (Streamable HTTP)
• URL: https://docs.flyo.cloud/api/mcp

Alternativ in .cursor/mcp.json:

{
  "mcpServers": {
    "flyo-docs": {
      "url": "https://docs.flyo.cloud/api/mcp"
    }
  }
}

VS Code (GitHub Copilot)

In der VS Code Datei .vscode/mcp.json:

{
  "servers": {
    "flyo-docs": {
      "type": "http",
      "url": "https://docs.flyo.cloud/api/mcp"
    }
  }
}