Claude Desktop

Connectez l’API AstroWay à Claude Desktop via MCP. Les deux transports sont disponibles : hosted (HTTP) et local stdio-paquet.

Prérequis

Obtenez une clé API sur la console. Pour le test gratuit, utilisez la clé de sandbox aw_test_* - elle ne facture pas les crédits.

Connexion

Ouvrez Paramètres → Développeur → Modifier la configuration - Claude Desktop affichera le chemin du fichier claude_desktop_config.json. Insérez l’un des blocs ci-dessous et redémarrez Claude Desktop.

Hosted (HTTP) : sans installation, authentification via un jeton Bearer :

claude_desktop_config.json

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

Stdio (npx) : processus local, authentification via une 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 : « Affichez les outils Astroway » - ou demandez l’appel d’un outil de référence gratuit, par exemple, obtenez la liste des signes du zodiaque. Si vous recevez une réponse, la connexion fonctionne.

Résolution des problèmes

• 401 / clé invalide : assurez-vous que la clé a un préfixe aw_live_* ou aw_test_* et n’a pas été révoquée. Vous pouvez vérifier cela dans la console.
• Les outils ne s’affichent pas : redémarrez complètement Claude Desktop (sortez, pas simplement fermez la fenêtre) et vérifiez le chemin du fichier claude_desktop_config.json.
• Erreurs de validation -32602 (pour stdio) : mettez à jour le paquet : npm i @astroway/mcp@latest. Les schémas sont re-générés avec la spécification actuelle.

Tous les clients - Paramètres de l’agent.