Подключить Gemini

MCP через Gemini CLI (~/.gemini/settings.json).

Подключение AstroCodex к вашему ИИ-ассистенту связывает его с Account MCP — чтобы он мог работать с вашими сохранёнными картами, запускать техники, получать транзиты и вычислять синастрию прямо в разговоре.

Что нужно

1

Аккаунт AstroCodex на тарифе с Account API/MCP. Многие ассистенты подключаются входом по OAuth — ключ создавать не нужно; Account API ключ (со страницы /api-keys) нужен только клиентам, которые вы настраиваете вручную.

2

Установленный Gemini CLI (npm i -g @google/gemini-cli) с входом в аккаунт Google.

Нужен ли API-ключ?

Часто нет. При вставке MCP-URL многие ассистенты (Claude, ChatGPT) показывают кнопку «Войти / Подключить» — подтвердите доступ к вашему аккаунту AstroCodex, и всё готово, без ключа. Шаги ниже описывают ручной способ с API-ключом — для клиентов, которым ключ передаётся в заголовке X-API-Key.

Account MCP URL

Account MCP URL
https://api.astrocodex.ai/api/v1/mcp

Шаги подключения

  1. 1

    Obtain an AstroCodex Account API key at astrocodex.ai/api-keys.

  2. 2

    Install the Gemini CLI (npm i -g @google/gemini-cli) and sign in with your Google account.

  3. 3

    Add AstroCodex in one command: gemini mcp add --transport http -H "X-API-Key: acx_YOUR_KEY" astrocodex https://api.astrocodex.ai/api/v1/mcp (or edit ~/.gemini/settings.json by hand — see the snippet below).

  4. 4

    Restart the Gemini CLI and run /mcp — "astrocodex" should show as connected.

  5. 5

    Ask: "Show my AstroCodex birth charts." Gemini calls the AstroCodex tools.

Фрагмент конфигурации

Config
{
  "mcpServers": {
    "astrocodex": {
      "httpUrl": "https://api.astrocodex.ai/api/v1/mcp",
      "headers": {
        "X-API-Key": "acx_YOUR_KEY_HERE"
      }
    }
  }
}

Gemini connects to MCP servers through the Gemini CLI and Gemini Code Assist agent mode — config lives in ~/.gemini/settings.json (global) or .gemini/settings.json (per project). Use the "httpUrl" key (not "url") for streamable-HTTP servers like AstroCodex. The gemini.google.com chat web app does not take custom MCP servers.

Что вы получаете — и сколько это стоит

После подключения ваш ИИ-ассистент может создавать и редактировать карты в вашем аккаунте AstroCodex, забирать их рассчитанные данные (планеты, дома, йоги, даши, транзиты, синастрию…) и интерпретировать их — прямо в обычном чате. Анализ выполняется на той модели, за которую вы уже платите (Claude, GPT-4o, Gemini, Grok…), поэтому токены AstroCodex НЕ расходуются. Применяются только лимит запросов и месячная квота вашего тарифа: получение данных карты считается запросами, а не токенами.