Claude Desktop

Σύνδεσε το API AstroWay με το Claude Desktop μέσω MCP: με επέκταση σε ένα κλικ ή χειροκίνητα μέσω ρυθμίσεων, με hosted-διακομιστή (HTTP) ή τοπικό πακέτο stdio.

Προαπαιτούμενα

Πάρε το API-κλειδί από τον πίνακα ελέγχου. Για δωρεάν δοκιμή χρησιμοποίησε το sandbox-κλειδί aw_test_* - δεν αφαιρεί credits.

Επέκταση σε ένα κλικ

1. Κατέβασε το astroway.mcpb.
2. Άνοιξε το αρχείο. Το Claude Desktop θα εμφανίσει διάλογο εγκατάστασης.
3. Επικόλλησε το API-κλειδί, επίλεξε τις ομάδες εργαλείων (προεπιλογή: γενέθλια χάρτες, μεταβάσεις, προόδους, επιστροφές, συναστρία και ημερολόγιο) και ενεργοποίησε την επέκταση.

Δεν χρειάζεται να επεξεργαστείς τη ρύθμιση. Η επέκταση είναι το npm-paket @astroway/mcp με τις εξαρτήσεις του, χτισμένο από την ίδια έκδοση. Καθάρισε το πεδίο ομάδων για να φορτώσεις όλα τα 700+ εργαλεία.

Χειροκίνητη σύνδεση

Άνοιξε Settings → Developer → Edit Config - το Claude Desktop θα εμφανίσει τη διαδρομή προς το αρχείο claude_desktop_config.json. Επικόλλησε ένα από τα παρακάτω μπλοκ και επανεκκίνησε το Claude Desktop.

Hosted (HTTP): χωρίς το πακέτο μας, πιστοποίηση μέσω Bearer-token. Η ρύθμιση του Claude Desktop εκτελεί μόνο τοπικές εντολές και παραλείπει την εγγραφή με το ίδιο url, γι’ αυτό ο hosted-διακομιστής συνδέεται μέσω της γέφυρας 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" }
  }
}
}

Το κλειδί βρίσκεται στο env, όχι στα args, επειδή το Claude Desktop στα Windows χωρίζει το όρισμα στο κενό μετά το Bearer. Για να φορτώσεις ένα μόνο θέμα αντί για ολόκληρο τον κατάλογο, αντικατέστησε το /mcp με έναν domain server, π.χ. /mcp/core ή /mcp/vedic.

Stdio (npx): τοπική υποδιαδικασία, πιστοποίηση μέσω μεταβλητής περιβάλλοντος, λειτουργεί offline:

claude_desktop_config.json

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

Έλεγχος

Γράψε στο Claude στο chat: “Κατάλογε τα εργαλεία Astroway” - ή ζήτησε να καλέσει ένα δωρεάν reference-εργαλείο, π.χ. να πάρει τη λίστα των ζωδιακών σημείων. Αν η απάντηση περιέχει αποτέλεσμα, η σύνδεση λειτουργεί.

Επίλυση προβλημάτων

• 401 / invalid key: βεβαιώσου ότι το κλειδί έχει πρόθεμα aw_live_* ή aw_test_* και δεν έχει ανακληθεί. Μπορείς να το ελέγξεις στον πίνακα ελέγχου.
• “Some MCP servers couldn’t be loaded”: στο πεδίο url αντί για command. Χρησιμοποίησε το μπλοκ με mcp-remote παραπάνω.
• Τα εργαλεία δεν εμφανίζονται: επανεκκίνησε πλήρως το Claude Desktop (αποσυνδέσου, όχι μόνο κλείσε το παράθυρο) και έλεγξε τη διαδρομή προς το claude_desktop_config.json.
• Σφάλματα επικύρωσης -32602 (για stdio): ενημέρωσε το πακέτο: npm i @astroway/mcp@latest. Τα σχήματα επαναδημιουργούνται από την τρέχουσα προδιαγραφή.

Όλοι οι πελάτες - Ρυθμίσεις πράκτορα.