Windsurf

Verbind de AstroWay API met Windsurf via MCP. De server gebruikt de Cascade-assistent.

Voorwaarden

Verkrijg een API-sleutel in het dashboard. Voor gratis testen, gebruik de sandbox-sleutel aw_test_* - deze trekt geen credits af.

Verbinding

Bewerk ~/.codeium/windsurf/mcp_config.json; ook beschikbaar via Settings → Cascade → MCP. Let op: voor een externe server gebruikt Windsurf de sleutel serverUrl (niet url). Plak een van de blokken hieronder en herstart Windsurf.

Gehost (HTTP): zonder installatie, authenticatie via Bearer-token:

~/.codeium/windsurf/mcp_config.json

{
"mcpServers": {
  "astroway": {
    "serverUrl": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx): lokaal subprocess, authenticatie via omgevingsvariabele, werkt offline:

~/.codeium/windsurf/mcp_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

Verificatie

Schrijf in Cascade: «Lijst Astroway-tools» - of vraag om een gratis referentietool aan te roepen, bijvoorbeeld het verkrijgen van een lijst met dierenriemtekens. Als er een antwoord komt, werkt de verbinding.

Probleemoplossing

• 401 / ongeldige sleutel: zorg ervoor dat de sleutel het voorvoegsel aw_live_* of aw_test_* heeft en niet is ingetrokken. Controleren kan in het dashboard.
• Tools verschijnen niet: start Windsurf volledig opnieuw en controleer het pad ~/.codeium/windsurf/mcp_config.json (voor gehost - sleutel serverUrl).
• Validatiefouten -32602 (voor stdio): update het pakket: npm i @astroway/mcp@latest. De schema’s worden opnieuw gegenereerd met de actuele specificatie.

Alle clients - Agentconfiguratie.