Claude Desktop

Підключіть API AstroWay до Claude Desktop через MCP. Доступні обидва транспорти: hosted (HTTP) і локальний stdio-пакет.

Передумови

Отримайте API-ключ у дашборді. Для безкоштовного тестування використовуйте sandbox-ключ aw_test_* — він не списує кредити.

Підключення

Відкрийте Settings → Developer → Edit Config — Claude Desktop покаже шлях до файлу claude_desktop_config.json. Вставте один із блоків нижче і перезапустіть Claude Desktop.

Hosted (HTTP) — без встановлення, автентифікація через Bearer-токен:

claude_desktop_config.json

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

Stdio (npx) — локальний підпроцес, автентифікація через env-змінну, працює офлайн:

claude_desktop_config.json

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

Перевірка

Напишіть Claude у чаті: «Перелічи інструменти Astroway» — або попросіть викликати безкоштовний reference-інструмент, наприклад отримати список знаків зодіаку. Якщо у відповідь приходить результат, підключення працює.

Усунення проблем

• 401 / invalid key — переконайтеся, що ключ має префікс aw_live_* або aw_test_* і не відкликаний. Перевірити можна в дашборді.
• Інструменти не з’являються — повністю перезапустіть Claude Desktop (вийдіть, а не просто закрийте вікно) і перевірте шлях до claude_desktop_config.json.
• Помилки валідації -32602 (для stdio) — оновіть пакет: npm i @astroway/mcp@latest. Схеми перегенеровуються з актуальної специфікації.

Усі клієнти — Налаштування агента.