Подключение Gemini к digna¶
Это руководство подключает инструменты Gemini от Google к digna MCP Server. Вам понадобятся конечная точка MCP вашей инсталляции digna и ключ API, как описано в обзоре ИИ-агентов.
В примерах в качестве конечной точки используется https://digna.example.com/mcp. Замените её на свою.
Выберите инструмент¶
| Инструмент | Для кого | Конфигурация |
|---|---|---|
| Antigravity CLI, IDE и приложение | Агентные инструменты Google. Antigravity CLI заменил Gemini CLI для личных аккаунтов Google в июне 2026 года | mcp_config.json |
| Gemini CLI | Лицензии Gemini Code Assist Standard и Enterprise, а также платные ключи Gemini API | settings.json или gemini mcp add |
| Приложение Gemini Enterprise | — | Не поддерживается. Его пользовательский коннектор MCP выполняет вход через OAuth или сервисный аккаунт Google Cloud, а digna MCP Server выполняет аутентификацию по ключам API |
Все эти инструменты подключаются с машины, на которой работают, поэтому они работают с digna внутри корпоративной сети, если эта машина может достичь конечной точки.
Antigravity¶
Antigravity читает свои серверы MCP из mcp_config.json, общего для CLI, IDE и приложения.
1. Откройте mcp_config.json¶
| Область | Файл |
|---|---|
| Все ваши проекты | ~/.gemini/config/mcp_config.json |
| Одно рабочее пространство | .agents/mcp_config.json в рабочем пространстве |
Чтобы открыть используемый файл:
- CLI: введите
/mcpи нажмите Enter, чтобы открыть менеджер MCP. - IDE: на боковой панели агента откройте меню …, выберите MCP Servers, затем Manage MCP Servers, затем View raw config.
- Приложение: перейдите в Customizations > Installed > MCP Servers и воспользуйтесь Copy Config File Path.
2. Добавьте сервер digna¶
Добавьте запись digna. Если в файле уже есть раздел mcpServers, добавьте её туда:
{
"mcpServers": {
"digna": {
"serverUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Antigravity обращается к удалённым серверам только по streamable HTTP, который использует digna MCP Server. Указывайте конечную точку как serverUrl; ключ httpUrl из Gemini CLI не поддерживается.
3. Проверьте подключение¶
В CLI введите /mcp: менеджер MCP показывает сервер digna с его состоянием и инструментами, а также может перезагрузить конфигурацию и показать журналы подключения. В IDE сервер появляется в Manage MCP Servers.
Защитите файл
mcp_config.json хранит ключ API в открытом виде. Не добавляйте файл рабочего пространства .agents/mcp_config.json в систему контроля версий, а глобальный файл разрешите читать только своей учётной записи.
Gemini CLI¶
1. Добавьте сервер¶
Поместите ключ API в переменную окружения, затем добавьте сервер:
export DIGNA_API_KEY='<api key>'
gemini mcp add --transport http --scope user --header "Authorization: Bearer $DIGNA_API_KEY" digna https://digna.example.com/mcp
Командная оболочка подставляет $DIGNA_API_KEY при выполнении команды, поэтому Gemini CLI сохраняет ключ в своих настройках. Без --scope user сервер добавляется только в текущий проект.
2. Или отредактируйте settings.json¶
Приведённая выше команда записывает данные в settings.json. Чтобы отредактировать файл самостоятельно:
| Область | Файл |
|---|---|
| Все ваши проекты | ~/.gemini/settings.json |
| Один проект | .gemini/settings.json в проекте |
{
"mcpServers": {
"digna": {
"httpUrl": "https://digna.example.com/mcp",
"headers": {
"Authorization": "Bearer <api key>"
}
}
}
}
Используйте httpUrl — ключ для streamable HTTP. Похожий ключ url выбирает более старый транспорт SSE, который digna MCP Server не поддерживает. Не используйте символы подчёркивания в имени сервера.
Не включайте trust
Gemini CLI запрашивает подтверждение перед каждым вызовом инструмента, если для сервера не задано "trust": true. Не включайте trust для digna, чтобы подтверждать каждое изменение, которое агент вносит в вашу конфигурацию.
3. Проверьте подключение¶
В командной оболочке:
Сервер digna должен отображаться как подключённый. В сеансе Gemini CLI выполните /mcp, чтобы увидеть сервер и его инструменты.
Устранение неполадок Gemini¶
Сервер отображается как отключённый¶
- Проверьте, что конечная точка заканчивается на
/mcpи доступна с вашей машины. - Проверьте имя ключа:
serverUrlв Antigravity,httpUrlв Gemini CLI. 401означает, что ключ отклонён; см. 401 Unauthorized.
Gemini CLI больше не запускается для моего аккаунта¶
С июня 2026 года личные аккаунты Google используют Antigravity CLI вместо Gemini CLI. Перенесите запись digna в mcp_config.json, как описано в разделе Antigravity, и переименуйте httpUrl в serverUrl.
См. также¶
- Обзор ИИ-агентов: конечная точка, ключ API, безопасность и общее устранение неполадок
- Claude: подключение Claude Code, Claude Desktop или пользовательского коннектора
- digna Agentic: что ИИ-агенты могут делать с digna