Windsurf

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

Передумови

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

Підключення

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

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

~/.codeium/windsurf/mcp_config.json

{
"mcpServers": {
  "astroway": {
    "serverUrl": "https://mcp.astroway.info/mcp",
    "headers": { "Authorization": "Bearer aw_live_YOUR_KEY" }
  }
}
}

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

~/.codeium/windsurf/mcp_config.json

{
"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_* і не відкликаний. Перевірити можна в дашборді.
• Інструменти не з’являються — повністю перезапустіть Windsurf і перевірте шлях ~/.codeium/windsurf/mcp_config.json (для hosted — ключ serverUrl).
• Помилки валідації -32602 (для stdio) — оновіть пакет: npm i @astroway/mcp@latest. Схеми перегенеровуються з актуальної специфікації.

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