Cursor

Connectez l’API AstroWay à Cursor via MCP. Les deux transports sont disponibles : hébergé (HTTP) et package stdio local.

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

Modifiez ~/.cursor/mcp.json (ou .cursor/mcp.json au niveau du projet); également accessible via Paramètres → MCP. Insérez l’un des blocs ci-dessous et redémarrez Cursor.

Hosted (HTTP) : sans installation, authentification via le token Bearer :

~/.cursor/mcp.json

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

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

~/.cursor/mcp.json

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

Vérification

Écrivez à l’agent dans le chat : “Listez 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 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’a pas été révoquée. Vous pouvez vérifier dans le tableau de bord.
• Les outils n’apparaissent pas : redémarrez complètement Cursor et vérifiez le chemin vers ~/.cursor/mcp.json (pour le projet - .cursor/mcp.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.