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

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

bash

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 глобально):

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`	Рассчитывает натальную карту (точки, дома, аспекты), при необходимости с текстами интерпретаций, и возвращает компактное читабельное резюме.
`astro_synastry`	Сравнивает две карты рождения и перечисляет аспекты между картами в обоих направлениях.
`astro_composite`	Рассчитывает композитную карту отношений (по средним точкам) с собственными положениями и аспектами.
`astro_transits`	Находит транзиты к натальной карте за период (до 2 лет): даты начала, точного аспекта и окончания для каждого аспекта.
`astro_compatibility`	Быстрая оценка совместимости двух людей по солнечным знакам.
`astro_solar_return`	Карта соляра (солнечного возвращения) для заданного года — астрологическая карта дня рождения.
`astro_lunar_return`	Карта лунара (лунного возвращения) от заданной даты (примерно раз в месяц).
`astro_progressions`	Вторичные прогрессии на целевую дату, включая аспекты к натальной карте.
`astro_human_design`	Полный бодиграф Дизайна Человека: тип, стратегия, авторитет, профиль, центры, каналы и ворота.
`astro_moon_sun`	Фаза Луны, а также времена восхода/захода, солнечного полдня и сумерек для даты и места.
`astro_moon_calendar`	Отчёт за день (знак, фаза, Луна без курса) или обзор периода с фазами, сменами знаков и периодами без курса.
`astro_retrograde_calendar`	Периоды ретроградности с датами стояний, пройденными знаками и теневыми периодами.
`astro_chinese_horoscope`	Знак и элемент китайского зодиака или годовой прогноз.
`astro_numerology`	Полный нумерологический профиль по дате рождения и имени или только число жизненного пути.
`astro_numerology_compatibility`	Совместимость двух людей на основе их чисел жизненного пути.
`astro_horoscope`	Готовые гороскопы: ежедневные, еженедельные, годовые и годовые по асценденту.
`astro_ai_summary`	Пишет краткое резюме того, что означает гороскоп, на основе самых сильных положений и аспектов. Требуется модуль AI Summary.

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

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

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

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

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

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

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

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

Endpoint ​

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

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

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

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

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

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