GitHub Copilot + Occult API
Зарегистрируйте MCP-сервер в VS Code, чтобы Copilot в режиме агента мог вызывать API. Настройка займёт около двух минут, а сервер работает локально — ваш ключ не покидает компьютер.
Что это даёт
Через MCP-сервер Copilot в режиме агента получает 299 астрологических эндпоинтов в виде инструментов. Вместо того чтобы описывать API и надеяться, что модель напишет правильный запрос, агент сам ищет по каталогу, читает настоящую схему запроса и делает вызов, — так что числа в ответе берутся из эфемерид, а не из обучающих данных.
Поиск и чтение схем бесплатны. Кредит тратится только на успешный call_endpoint, а неудачные вызовы ничего не стоят.
1. Получите ключ
Создайте его в личном кабинете. Он выглядит как yt_live_… и привязан к вашему балансу кредитов, поэтому обращайтесь с ним как с паролем: никогда не кладите его в клиентский код и не коммитьте.
2. Добавьте сервер
Откройте .vscode/mcp.json (если файла нет, создайте его) и добавьте:
{
"servers": {
"occult-api": {
"command": "npx",
"args": ["-y", "occult-api-mcp"],
"env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
}
}
}Если не хотите править файл вручную, то же самое есть в Command Palette → MCP: Add Server → Command (stdio).
Замените yt_live_your_key_here своим настоящим ключом. Больше ничего устанавливать не нужно — npx скачает сервер при первом запуске.
3. Проверьте подключение
Спросите Copilot в режиме агента:
Перечисли инструменты, которые у тебя есть от сервера occult-api.Должно вернуться пять инструментов:
search_endpointsdescribe_endpointcall_endpointget_panchangacheck_account
Если список пуст, сервер не запустился. Чаще всего файл конфигурации лежит в правильном месте, но имеет неправильную структуру, поэтому в первую очередь проверьте имя ключа выше.
4. Первый промпт, который стоит запустить
В режиме агента: с помощью инструментов occult-api проверь, есть ли в этой натальной карте манглик-доша, и покажи обоснование, которое возвращает API, без пересказа.Агент должен вызвать API, а не отвечать по памяти. Если ответ пришёл мгновенно и без вызова инструмента, агент ответил из обучающих данных — напишите «используй инструменты occult-api», и он их вызовет.
Что полезно знать о GitHub Copilot
- VS Code использует ключ верхнего уровня `servers`, а НЕ `mcpServers`. Все остальные инструменты в этом списке используют `mcpServers`, поэтому скопированный фрагмент загрузится как пустой список серверов и никакой ошибки не будет.
- MCP-инструменты доступны только в режиме агента. Переключите окно Chat с Ask на Agent, иначе сервер подключится, но обратиться к нему будет нечему.
- Файл коммитится вместе с репозиторием, поэтому для ключа используйте `${input:...}`, а не вставляйте его как есть — VS Code запросит значение при первом запуске.
Если MCP вам не нужен
Эндпоинты — это обычный HTTP. Ничего с этой страницы для их использования не требуется:
curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
-H 'X-API-Key: yt_live_your_key_here' \
-H 'Content-Type: application/json' \
-d '{
"date_time": "2026-09-17T06:00:00+05:30",
"latitude": 26.9124,
"longitude": 75.7873,
"timezone_as_float": 5.5,
"keys": ["tithi", "nakshatra_segments", "yogam", "karana"]
}'Обратите внимание на массив keys: четыре расчёта в одном запросе списывают один кредит. Четыре отдельных вызова стоят четыре.