Claude Desktop

Connectez l’API AstroWay à Claude Desktop via MCP : extension en un clic ou manuellement via la configuration, avec un serveur hébergé (HTTP) ou un package stdio local.

Prérequis

Obtenez une clé API dans le tableau de bord. Pour un test gratuit, utilisez la clé sandbox aw_test_* - elle ne consomme pas de crédits.

Extension en un clic

1. Téléchargez astroway.mcpb.
2. Ouvrez le fichier. Claude Desktop affichera une boîte de dialogue d’installation.
3. Insérez la clé API, sélectionnez les groupes d’outils (par défaut : cartes natales, transits, progressions, retours, synastrie et calendrier) et activez l’extension.

Aucune modification de configuration n’est nécessaire. L’extension est un package npm @astroway/mcp avec ses dépendances, construit à partir de la même version. Videz le champ des groupes pour charger tous les 700+ outils.

Connexion manuelle

Ouvrez Settings → Developer → Edit Config - Claude Desktop affichera le chemin vers le fichier claude_desktop_config.json. Insérez l’un des blocs ci-dessous et redémarrez Claude Desktop.

Hébergé (HTTP) : sans notre package, authentification via Bearer token. La configuration Claude Desktop ne lance que des commandes locales et ignore l’entrée avec url seul, donc le serveur hébergé se connecte via le pont mcp-remote :

claude_desktop_config.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
    "env": { "AUTH_HEADER": "Bearer aw_live_YOUR_KEY" }
  }
}
}

La clé se trouve dans env, pas dans args, car Claude Desktop sous Windows coupe l’argument sur les espaces après Bearer. Pour charger un seul thème au lieu de tout le catalogue, remplacez /mcp par un serveur de domaine, par exemple /mcp/core ou /mcp/vedic.

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

claude_desktop_config.json

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

Vérification

Écrivez à Claude dans le chat : “Listez les outils Astroway” - ou demandez d’appeler un outil de référence gratuit, par exemple obtenir la liste des signes du zodiaque. Si vous recevez un résultat en retour, la connexion fonctionne.

Dépannage

• 401 / clé invalide : assurez-vous que la clé a le préfixe aw_live_* ou aw_test_* et n’est pas révoquée. Vous pouvez vérifier dans le tableau de bord.
• “Certains serveurs MCP n’ont pas pu être chargés” : entrée url au lieu de command. Utilisez le bloc avec mcp-remote ci-dessus.
• Les outils n’apparaissent pas : redémarrez complètement Claude Desktop (quittez, ne fermez pas simplement la fenêtre) et vérifiez le chemin vers claude_desktop_config.json.
• 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.