VS Code

Connectez l’API AstroWay à VS Code via MCP. La configuration lit Copilot Chat en mode Agent.

Prérequis

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

Connexion

Créez .vscode/mcp.json à la racine du projet. Notez : dans VS Code, la clé est servers (pas mcpServers), et chaque serveur nécessite un champ type. Insérez l’un des blocs ci-dessous et redémarrez VS Code.

Hébergé (HTTP) : sans installation, authentification via le token Bearer :

.vscode/mcp.json

{
"servers": {
  "astroway": {
    "type": "http",
    "url": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

Stdio (npx) : processus local, authentification via variable d’environnement, fonctionne hors ligne :

.vscode/mcp.json

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

Vérification

Dans Copilot Chat (mode Agent), écrivez : « Énumérer les outils AstroWay » - ou demandez d’appeler un outil de référence gratuit, par exemple pour obtenir la liste des signes du zodiaque. Si une réponse est renvoyée, la connexion fonctionne.

Résolution des problèmes

• 401 / clé invalide : assurez-vous que la clé a le préfixe aw_live_* ou aw_test_* et n’a pas été révoquée. Vous pouvez vérifier sur le tableau de bord.
• Outils qui n’apparaissent pas : redémarrez complètement VS Code et vérifiez le chemin .vscode/mcp.json (clé servers, champ type).
• Erreurs de validation -32602 (pour stdio) : mettez à jour le package : 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.