Cursor

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

Передумови

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

Підключення

Відредагуйте ~/.cursor/mcp.json (або проєктний .cursor/mcp.json); також доступно через Settings → MCP. Вставте один із блоків нижче і перезапустіть Cursor.

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

~/.cursor/mcp.json

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

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

~/.cursor/mcp.json

{
"mcpServers": {
  "astroway": {
    "command": "npx",
    "args": ["-y", "@astroway/mcp"],
    "env": { "ASTROWAY_API_KEY": "aw_live_YOUR_KEY" }
  }
}
}

Перевірка

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

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

• 401 / invalid key — переконайтеся, що ключ має префікс aw_live_* або aw_test_* і не відкликаний. Перевірити можна в дашборді.
• Інструменти не з’являються — повністю перезапустіть Cursor і перевірте шлях до ~/.cursor/mcp.json (для проєктного — .cursor/mcp.json).
• Помилки валідації -32602 (для stdio) — оновіть пакет: npm i @astroway/mcp@latest. Схеми перегенеровуються з актуальної специфікації.

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