Astrocal — MCP-сервер для Claude Code: что делает и как установить
Подключает календарь к ИИ-агенту для проверки слотов, бронирования встреч и ведения листа ожидания. Пригодится, когда ассистенту нужно назначать созвоны без ручной сверки расписания.
claude mcp add --transport http mcp-server https://api.astrocal.dev/mcpЧто делает Astrocal
Сервер даёт модели доступ к API платформы Astrocal через набор из восьми инструментов. Агент умеет запрашивать доступные интервалы времени, создавать записи, отменять встречи и менять время созвонов. Доступна синхронизация с Google Calendar, Microsoft 365 и CalDAV, поэтому проверка слотов идёт по реальной занятости.
Кроме обычных встреч поддерживаются платные консультации благодаря интеграции со Stripe Connect. Если у слотов закончились места, инструмент позволяет зарегистрировать человека в лист ожидания и проверять статус заявки. Для работы обязателен ключ ASTROCAL_API_KEY. Чтобы не передавать идентификатор типа встречи в каждом вызове, можно задать переменную ASTROCAL_DEFAULT_EVENT_TYPE_ID.
Боевые ключи создают реальные события и сразу отправляют письма участникам. Для отладки логики диалогов лучше использовать ключи вида ac_test_*: в этом режиме сервер не рассылает уведомления и не проводит платежи.
Какие задачи решает
- Проверять доступные слоты в Google Calendar, Microsoft 365 или CalDAV
- Бронировать и переносить встречи через диалог с моделью
- Оформлять платные консультации через Stripe Connect
- Записывать людей в лист ожидания при отсутствии свободных окон
Примеры запросов агенту
- Посмотри свободные слоты для консультации на следующую неделю
- Запиши [email protected] на 17 марта в 14:00 и добавь заметку о теме созвона
- Перенеси бронирование с идентификатором book_123 на 16:00
Как установить Astrocal
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp-server https://api.astrocal.dev/mcp2Командой платформы
claude mcp add --env ASTROCAL_API_KEY=<ASTROCAL_API_KEY> --env ASTROCAL_API_URL=<ASTROCAL_API_URL> --env ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> --transport stdio astrocal -- npx -y @astrocal/mcp-serverВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add astrocal --url https://api.astrocal.dev/mcp2Командой платформы
codex mcp add astrocal --env ASTROCAL_API_KEY=<ASTROCAL_API_KEY> --env ASTROCAL_API_URL=<ASTROCAL_API_URL> --env ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> -- npx -y @astrocal/mcp-serverВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"astrocal": {
"url": "https://api.astrocal.dev/mcp"
}
}
}{
"mcpServers": {
"astrocal": {
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<ASTROCAL_API_KEY>",
"ASTROCAL_API_URL": "<ASTROCAL_API_URL>",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<ASTROCAL_DEFAULT_EVENT_TYPE_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"astrocal": {
"type": "http",
"url": "https://api.astrocal.dev/mcp"
}
}
}{
"servers": {
"astrocal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@astrocal/mcp-server"
],
"env": {
"ASTROCAL_API_KEY": "<ASTROCAL_API_KEY>",
"ASTROCAL_API_URL": "<ASTROCAL_API_URL>",
"ASTROCAL_DEFAULT_EVENT_TYPE_ID": "<ASTROCAL_DEFAULT_EVENT_TYPE_ID>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http astrocal https://api.astrocal.dev/mcp2Командой платформы
gemini mcp add -e ASTROCAL_API_KEY=<ASTROCAL_API_KEY> -e ASTROCAL_API_URL=<ASTROCAL_API_URL> -e ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> astrocal npx -y @astrocal/mcp-serverВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Astrocal
Как установить Astrocal в Claude Code?
Выполните команду claude mcp add --transport http astrocal https://api.astrocal.dev/mcp для удалённого подключения или используйте stdio-вариант: `claude mcp add --env ASTROCAL_API_KEY=<ASTROCAL_API_KEY> --env ASTROCAL_API_URL=<ASTROCAL_API_URL> --env ASTROCAL_DEFAULT_EVENT_TYPE_ID=<ASTROCAL_DEFAULT_EVENT_TYPE_ID> --transport stdio astrocal -- npx -y @astrocal/mcp-server`.
Что делает MCP-сервер Astrocal?
Он предоставляет модели функции для поиска свободных слотов, создания или отмены встреч, пересмотра времени бронирования и ведения очереди ожидания.
Как протестировать работу без отправки реальных писем?
Передайте в переменную окружения ключ с префиксом ac_test_*. В тестовом режиме календарные события не создаются, списания через Stripe не происходят, а почтовые уведомления не отправляются.
