MCP Server

• Was ist MCP?
• Endpoint URL
• Verfügbare Tools
  • search_docs
  • get_doc
  • list_docs
• MCP Client konfigurieren
  • Claude Desktop
  • Cursor
  • VS Code (GitHub Copilot)
• Smoke Test mit curl

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

Der Server nutzt das Streamable HTTP Transport-Protokoll und ist als Netlify Function implementiert.

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–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

Claude Desktop

Öffne die Datei claude_desktop_config.json (unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) und füge folgenden Eintrag hinzu:

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

Cursor

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

• Name: flyo-docs
• Type: streamableHttp
• 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": "streamableHttp",
      "url": "https://docs.flyo.cloud/api/mcp"
    }
  }
}

Smoke Test mit curl

Tools auflisten:

curl -s -X POST https://docs.flyo.cloud/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"capabilities":{},"clientInfo":{"name":"test","version":"1.0"},"protocolVersion":"2025-03-26"}}' | jq

Dokumentation durchsuchen:

curl -s -X POST https://docs.flyo.cloud/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_docs","arguments":{"query":"Content Pool","limit":3}}}' | jq

Einzelne Seite abrufen:

curl -s -X POST https://docs.flyo.cloud/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_doc","arguments":{"path":"account"}}}' | jq