Windsurf

Conecta la API AstroWay a Windsurf a través de MCP. El servidor usa el asistente Cascade.

Requisitos previos

Obtén la clave API en el dashboard. Para pruebas gratuitas usa la clave sandbox aw_test_* - no consume créditos.

Conexión

Edita ~/.codeium/windsurf/mcp_config.json; también está disponible a través de Settings → Cascade → MCP. Ten en cuenta: para el servidor remoto Windsurf usa la clave serverUrl (no url). Inserta uno de los bloques a continuación y reinicia Windsurf.

Hosted (HTTP): sin instalación, autenticación mediante token Bearer:

~/.codeium/windsurf/mcp_config.json

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

Stdio (npx): proceso local, autenticación mediante variable de entorno, funciona offline:

~/.codeium/windsurf/mcp_config.json

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

Verificación

En Cascade escribe: «Enumera las herramientas Astroway» - o pide ejecutar una herramienta de referencia gratuita, por ejemplo obtener la lista de signos del zodiaco. Si la respuesta contiene un resultado, la conexión funciona.

Solución de problemas

• 401 / invalid key: asegúrate de que la clave tenga el prefijo aw_live_* o aw_test_* y no esté revocada. Puedes verificarlo en el dashboard.
• Las herramientas no aparecen: reinicia completamente Windsurf y verifica la ruta ~/.codeium/windsurf/mcp_config.json (para hosted - la clave serverUrl).
• Errores de validación -32602 (para stdio): actualiza el paquete: npm i @astroway/mcp@latest. Los esquemas se regeneran a partir de la especificación actual.

Todos los clientes - Configuración del agente.