# VS Code

Підключіть API AstroWay до **VS Code** через MCP. Конфіг читає Copilot Chat в режимі Agent.

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

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

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

Створіть `.vscode/mcp.json` у корені проєкту. Зверніть увагу: у VS Code ключ — `servers` (не `mcpServers`), і кожен сервер потребує поля `type`. Вставте один із блоків нижче і **перезапустіть VS Code**.

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

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

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

<Code lang="json" title=".vscode/mcp.json" code={`{
  "servers": {
    "astroway": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
    }
  }
}`} />

## Перевірка

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

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

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

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