MCP-сервер: используйте AstroAPI из AI-ассистентов

AstroAPI предоставляет размещённый сервер Model Context Protocol (MCP). Подключите его к AI-ассистенту, такому как Claude Code, Claude Desktop или Cursor, и ассистент сможет обращаться к AstroAPI напрямую — искать места рождения, рассчитывать карты и объяснять результаты простым языком.

Это также самый быстрый способ создать интеграцию: подключите MCP-сервер к своему AI-ассистенту для программирования и попросите его написать код интеграции за вас. Ассистент может выполнять реальные вызовы API во время работы, поэтому он видит настоящие ответы, а не строит догадки.

Код не требуется

После подключения вы можете просто задавать ассистенту вопросы вроде «Рассчитай натальную карту для человека, родившегося 15 июня 1990 года в 14:30 в Амстердаме» — ассистент определит местоположение, вызовет API и подытожит результат.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Транспорт: Streamable HTTP
• Аутентификация: ваш обычный ключ AstroAPI, передаваемый в заголовке X-Api-Key
• Модули, ограничения частоты запросов и квоты вашей подписки действуют точно так же, как и при прямых вызовах API.

Создать API-ключ можно в панели управления в разделе API Keys. Подробности см. в разделе Аутентификация.

---

Подключение Claude Code

Выполните эту команду один раз в терминале:

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Затем просто попросите Claude Code использовать AstroAPI — например: «Используй инструменты astroapi, чтобы рассчитать натальную карту для 1990-06-15 14:30 в Амстердаме, и создай мне React-компонент, который её отображает».

Подключение Cursor

Добавьте следующее в .cursor/mcp.json в вашем проекте (или в ~/.cursor/mcp.json глобально):

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Подключение других MCP-клиентов

Подойдёт любой клиент, поддерживающий MCP по Streamable HTTP с пользовательскими заголовками. Настройте:

Параметр	Значение
URL	https://mcp.astroapi.cloud/mcp
Транспорт	Streamable HTTP
Заголовок	X-Api-Key: YOUR_API_KEY

Хостируемые клиенты без пользовательских заголовков

Некоторые хостируемые клиенты (например, веб-коннекторы claude.ai) не могут отправлять пользовательские заголовки и требуют OAuth. Поддержка OAuth есть в планах; пока используйте клиент, который поддерживает пользовательские заголовки, например Claude Code, Claude Desktop или Cursor.

---

Доступные инструменты

Инструмент	Что он делает
astro_resolve_place	Ищет название места и возвращает координаты и часовой пояс IANA. Ассистентам предписано вызывать этот инструмент первым, чтобы они никогда не угадывали координаты.
astro_natal_chart	Рассчитывает натальную карту (точки, дома, аспекты), при необходимости с текстами интерпретаций, и возвращает компактное читабельное резюме.

Другие инструменты (транзиты, синастрия, совместимость, фазы Луны, изображения карт и прочее) уже на подходе. Доступность инструментов определяется модулями вашей подписки: инструмент, не входящий в ваш тарифный план, возвращает понятное сообщение вместо данных.

---

Пример сеанса

Разговор с подключённым ассистентом может выглядеть так:

Вы: Какой солнечный знак и асцендент у человека, родившегося 3 марта 1985 года в 6:45 в Барселоне?

Ассистент: вызывает astro_resolve_place с «Barcelona», затем astro_natal_chart с полученными координатами и часовым поясом — Солнце находится в Рыбах на 12°41′ в 1-м доме, а асцендент — Водолей 28°10′ …

Ассистент берёт на себя геокодирование, преобразование часовых поясов и вызов API — то, что обычно идёт не так при ручном вводе данных о рождении.

---

Следующие шаги

• Аутентификация — создание и управление API-ключами
• Начало работы — основы API, лежащие в основе этих инструментов
• Натальные карты — что возвращает натальный расчёт