Claude Desktop

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

Передумови

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

Розширення в один клік

1. Завантажте astroway.mcpb.
2. Відкрийте файл. Claude Desktop покаже діалог встановлення.
3. Вставте API-ключ, виберіть групи інструментів (за замовчуванням натальні карти, транзити, прогресії, повернення, синастрія і календар) і ввімкніть розширення.

Конфіг редагувати не треба. Розширення це npm-пакет @astroway/mcp з його залежностями, зібраний з того самого релізу. Очистіть поле груп, щоб завантажити всі 700+ інструментів.

Підключення вручну

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

Hosted (HTTP): без нашого пакета, автентифікація через Bearer-токен. Конфіг 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 на доменний сервер, наприклад /mcp/core або /mcp/vedic.

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_* і не відкликаний. Перевірити можна в дашборді.
• “Some MCP servers couldn’t be loaded”: у записі url замість command. Використайте блок із mcp-remote вище.
• Інструменти не з’являються: повністю перезапустіть Claude Desktop (вийдіть, а не просто закрийте вікно) і перевірте шлях до claude_desktop_config.json.
• Помилки валідації -32602 (для stdio): оновіть пакет: npm i @astroway/mcp@latest. Схеми перегенеровуються з актуальної специфікації.

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