# Windsurf

Підключіть API AstroWay до **Windsurf** через MCP. Сервер використовує асистент Cascade.

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

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

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

Відредагуйте `~/.codeium/windsurf/mcp_config.json`; також доступно через Settings → Cascade → MCP. Зверніть увагу: для віддаленого сервера Windsurf використовує ключ `serverUrl` (не `url`). Вставте один із блоків нижче і **перезапустіть Windsurf**.

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

<Code lang="json" title="~/.codeium/windsurf/mcp_config.json" code={`{
  "mcpServers": {
    "astroway": {
      "serverUrl": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
    }
  }
}`} />

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

<Code lang="json" title="~/.codeium/windsurf/mcp_config.json" code={`{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
    }
  }
}`} />

## Перевірка

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

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

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

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