Windsurf

Connecte l’API AstroWay à Windsurf via MCP. Le serveur utilise l’assistant Cascade.

Prérequis

Obtiens la clé API sur le tableau de bord. Pour les tests gratuits, utilise la clé sandbox aw_test_* - elle ne consomme pas de crédits.

Connexion

Édite ~/.codeium/windsurf/mcp_config.json; également disponible via Settings → Cascade → MCP. Note : pour le serveur distant, Windsurf utilise la clé serverUrl (pas url). Insère l’un des blocs ci-dessous et redémarre Windsurf.

Hosted (HTTP) : sans installation, authentification 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) : processus local, authentification via variable d’environnement, fonctionne hors ligne :

~/.codeium/windsurf/mcp_config.json

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

Vérification

Dans Cascade, écris : «Liste les outils Astroway» - ou demande d’appeler un outil de référence gratuit, par exemple obtenir la liste des signes du zodiaque. Si la réponse renvoie un résultat, la connexion fonctionne.

Résolution des problèmes

• 401 / invalid key : assure-toi que la clé possède le préfixe aw_live_* ou aw_test_* et n’est pas révoquée. Tu peux vérifier dans le tableau de bord.
• Les outils n’apparaissent pas : redémarre complètement Windsurf et vérifie le chemin ~/.codeium/windsurf/mcp_config.json (pour hosted - la clé serverUrl).
• Erreurs de validation -32602 (pour stdio) : mets à jour le paquet : npm i @astroway/mcp@latest. Les schémas sont régénérés à partir de la spécification actuelle.

Tous les clients - Configuration de l’agent.