# Claude Desktop

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

## Передумови

Отримайте API-ключ у [дашборді](https://api.astroway.info/dashboard/sign-up). Для безкоштовного тестування використовуйте sandbox-ключ `aw_test_*` — він не списує кредити.

## Підключення

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

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

<Code lang="json" title="claude_desktop_config.json" code={`{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
    }
  }
}`} />

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

<Code lang="json" title="claude_desktop_config.json" code={`{
  "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_*` і не відкликаний. Перевірити можна в [дашборді](https://api.astroway.info/dashboard/sign-up).
- **Інструменти не з'являються** — повністю перезапустіть Claude Desktop (вийдіть, а не просто закрийте вікно) і перевірте шлях до `claude_desktop_config.json`.
- **Помилки валідації `-32602`** (для stdio) — оновіть пакет: `npm i @astroway/mcp@latest`. Схеми перегенеровуються з актуальної специфікації.

Усі клієнти — [Налаштування агента](/agent-setup/).