Подключение Claude к digna¶

Это руководство подключает Claude к digna MCP Server. Вам понадобятся конечная точка MCP вашей инсталляции digna и ключ API, как описано в обзоре ИИ-агентов.

В примерах в качестве конечной точки используется https://digna.example.com/mcp. Замените её на свою.

Выберите способ подключения¶

Для инсталляции digna, работающей внутри корпоративной сети, используйте Claude Code или Claude Desktop с локальным мостом.

Claude Code¶

1. Добавьте сервер¶

Поместите ключ API в переменную окружения, затем добавьте сервер:

export DIGNA_API_KEY='<api key>'
claude mcp add --transport http --scope user digna https://digna.example.com/mcp --header "Authorization: Bearer $DIGNA_API_KEY"

Командная оболочка подставляет $DIGNA_API_KEY при выполнении команды, поэтому Claude Code сохраняет ключ в собственной конфигурации.

--scope определяет, где доступен сервер:

2. Предоставьте сервер команде (необязательно)¶

Чтобы у всех участников проекта был один и тот же сервер, добавьте файл .mcp.json в корень проекта. Не записывайте ключ в файл. Claude Code подставляет ${DIGNA_API_KEY} из окружения каждого человека:

{
  "mcpServers": {
    "digna": {
      "type": "http",
      "url": "https://digna.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DIGNA_API_KEY}"
      }
    }
  }
}

Каждый задаёт в DIGNA_API_KEY собственный ключ. Когда Claude Code впервые находит этот файл, он спрашивает, использовать ли серверы из него.

3. Проверьте подключение¶

В командной оболочке:

claude mcp list

Сервер digna должен показывать ✔ Connected. В сеансе Claude Code выполните /mcp, чтобы увидеть сервер и его инструменты.

Claude Desktop с локальным мостом¶

Файл конфигурации Claude Desktop запускает локальные серверы MCP на вашей машине. Небольшой мост — пакет с открытым исходным кодом mcp-remote — работает там и пересылает каждый запрос на конечную точку digna с вашим ключом API. Поскольку мост работает на вашей машине, этот способ подходит для digna внутри корпоративной сети.

1. Установите Node.js¶

Мосту нужен Node.js версии 18 или новее. Claude Desktop использует версию Node.js, установленную в вашей системе. Проверьте её командой:

node --version

2. Отредактируйте файл конфигурации¶

Откройте claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте сервер digna. Если в файле уже есть раздел mcpServers, добавьте запись digna в него:

{
  "mcpServers": {
    "digna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://digna.example.com/mcp",
        "--transport",
        "http-only",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <api key>"
      }
    }
  }
}

3. Перезапустите Claude Desktop¶

Полностью закройте Claude Desktop и запустите его снова. В новом чате нажмите + и откройте Connectors: digna должен быть в списке и включён.

Пользовательский коннектор¶

Пользовательский коннектор делает digna доступной в claude.ai, Claude Desktop и мобильных приложениях Claude без какой-либо локальной настройки. К конечной точке подключается облако Anthropic, поэтому это работает только при следующих условиях:

• Конечная точка digna доступна из интернета по HTTPS
• В вашей организации Claude есть параметр Request headers в диалоговом окне Add custom connector. Anthropic предлагает его в виде беты ограниченному кругу организаций

1. Откройте настройки коннекторов¶

• Тарифы Free, Pro, Max и Ultra: перейдите в Customize > Connectors и нажмите Add custom connector.
• Тарифы Team и Enterprise: владелец (Owner) переходит в Organization settings > Connectors, нажимает Add, затем Custom и, если запрашивается тип, выбирает Web.

2. Введите данные коннектора¶

1. MCP server URL: https://digna.example.com/mcp
2. Authentication: No sign-in
3. Request headers: выберите authorization в качестве имени заголовка, введите Bearer <api key> в качестве значения, вместе со словом Bearer и пробелом, и отметьте его как Required.
4. Нажмите Add.

В тарифах Team и Enterprise участники затем подключаются в Customize > Connectors, где коннектор отмечен меткой Custom.

Claude не может изменить заголовок существующего коннектора. Чтобы использовать новый ключ, удалите коннектор и добавьте его снова.

Устранение неполадок Claude¶

claude mcp list показывает Failed to connect¶

Выполните claude mcp get digna, чтобы увидеть причину. 401 означает, что ключ отклонён; см. 401 Unauthorized. Claude Code также предупреждает о пробелах или переносе строки в начале или в конце ключа, которые часто появляются при копировании.

digna не появляется в Claude Desktop¶

• Проверьте, установлен ли Node.js 18 или новее: node --version.
• Проверьте, что claude_desktop_config.json содержит корректный JSON. Пропущенная запятая не даёт загрузиться ни одному серверу из файла.
• Полностью закройте Claude Desktop, а не только окно, и запустите его снова.

Пользовательский коннектор не может достичь сервера¶

Облако Anthropic не может достичь конечной точки. Проверьте, что она доступна из интернета по HTTPS с действительным сертификатом, или подключитесь вместо этого через Claude Code.

См. также¶

• Обзор ИИ-агентов: конечная точка, ключ API, безопасность и общее устранение неполадок
• Gemini: подключение Antigravity или Gemini CLI
• digna Agentic: что ИИ-агенты могут делать с digna