Claude Desktop

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

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

Λάβετε το κλειδί API από το πάνελ ελέγχου. Για δωρεάν δοκιμές, χρησιμοποιήστε το κλειδί δοκιμής aw_test_* - δεν αφαιρεί πιστώσεις.

Σύνδεση

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

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

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

claude_desktop_config.json

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

Επαλήθευση

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

Αντιμετώπιση προβλημάτων

• 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. Τα σχήματα regenerates με την τρέχουσα προδιαγραφή.

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