Wie Sie Fine Structure mit MCP an Windsurf anbinden

Windsurf Cascade verbindet sich über mcp_config.json mit MCP-Servern. Fine Structure funktioniert als entfernter HTTP-Server mit Token.

Windsurf eignet sich für einen Arbeitsablauf, in dem Cascade beim Bauen und Bearbeiten von Code hilft. Die Anbindung von Fine Structure über MCP gibt Cascade einen kontrollierten Weg, Ihre Anwendungen zu verstehen und über die Werkzeuge der Plattform auf sie einzuwirken.

Die Konfigurationsdatei: Windsurf verwendet in der Regel ~/.codeium/windsurf/mcp_config.json.

Das URL-Feld: Verwenden Sie für einen entfernten MCP-Server serverUrl oder url je nach Version der Konfiguration, wobei serverUrl in der aktuellen Dokumentation die sichere Wahl ist.

Geheimnisse: Sie können Umgebungsvariablen verwenden, wenn das Team es vorzieht, das Token nicht direkt in der Datei zu speichern.

Erstellen Sie eine kontrollierte Verbindung

Beginnen Sie mit einem app-scoped Token, wenn Cascade nur an einer einzigen Anwendung arbeitet. Das verringert das Risiko und erleichtert die Verwaltung von Kunden.

Schritte

• Melden Sie sich in Ihrem Fine-Structure-Konto an.
• Öffnen Sie die MCP-Seite über die Schaltfläche Create MCP token in den Docs oder direkt über /mcp.
• Wählen Sie aus, ob der Agent Zugriff auf alle Anwendungen in Ihrem Besitz oder nur auf eine einzige Anwendung erhält.
• Wählen Sie die Berechtigungen: Read only zum Prüfen, Build zum Bearbeiten, Full access nur für einen Agenten, dem Sie vertrauen.
• Klicken Sie auf Create MCP setup und kopieren Sie das Token oder den Konfigurationsblock. Das Token wird nur ein einziges Mal angezeigt.
• Öffnen Sie in Windsurf Cascade und dann MCP settings oder View raw config.
• Fügen Sie die Konfiguration unten innerhalb von mcpServers ein.
• Speichern Sie und aktualisieren Sie die MCP-Server.
• Bitten Sie Cascade, eine einfache Verbindungsprüfung über get_platform_guide auszuführen.

{
  "mcpServers": {
    "fine-structure": {
      "serverUrl": "https://finestructure.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer fse2_mcp_<token>"
      }
    }
  }
}

Funktionsprüfung: Wenn Windsurf den Server nicht anzeigt, prüfen Sie, ob das JSON gültig ist, ob das Token Bearer vor dem Wert enthält und ob kein Komma nach einem vorherigen Server fehlt.