# Claude Code

Підключіть API AstroWay до **Claude Code** через MCP. Редагувати файли не потрібно — усе налаштовується однією командою в терміналі.

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

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

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

Виконайте одну з команд у терміналі. Після цього **перезапустіть Claude Code**.

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

<Code lang="bash" title="terminal" code={`claude mcp add --transport http astroway https://mcp.astroway.info/mcp \\
  --header "Authorization: Bearer aw_live_YOUR_KEY"`} />

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

<Code lang="bash" title="terminal" code={`claude mcp add astroway --env ASTROWAY_API_KEY=aw_live_YOUR_KEY -- npx -y @astroway/mcp`} />

## Перевірка

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

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

- **401 / invalid key** — переконайтеся, що ключ має префікс `aw_live_*` або `aw_test_*` і не відкликаний. Перевірити можна в [дашборді](https://api.astroway.info/dashboard/sign-up).
- **Інструменти не з'являються** — повністю перезапустіть Claude Code і перевірте, що сервер додано (`claude mcp list`).
- **Помилки валідації `-32602`** (для stdio) — оновіть пакет: `npm i @astroway/mcp@latest`. Схеми перегенеровуються з актуальної специфікації.

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