Подключение

MCP сервер Dockhost работает по HTTP и поддерживается большинством AI-клиентов. Для подключения понадобится URL сервера и токен авторизации.

Получение токена

Токен создаётся в личном кабинете Dockhost в разделе Управление токенами — это тот же токен, что используется для REST API.

Настройка клиента

Выберите ваш клиент и добавьте конфигурацию сервера. В примерах ниже подставьте свой токен вместо <DOCKHOST_API_TOKEN> или настройте переменную окружения DOCKHOST_TOKEN.

Claude Desktop

Добавьте в claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
    "mcpServers": {
        "dockhost": {
            "url": "https://mcp.dockhost.io",
            "headers": {
                "Authorization": "Bearer <DOCKHOST_API_TOKEN>"
            }
        }
    }
}

Cursor

Создайте файл .cursor/mcp.json в корне проекта (или глобально ~/.cursor/mcp.json):

{
    "servers": {
        "dockhost": {
            "url": "https://mcp.dockhost.io",
            "headers": {
                "Authorization": "Bearer <DOCKHOST_API_TOKEN>"
            }
        }
    }
}

VS Code (GitHub Copilot)

Создайте файл .vscode/mcp.json в корне проекта (или глобально через настройки VS Code):

{
    "servers": {
        "dockhost": {
            "type": "sse",
            "uri": "https://mcp.dockhost.io",
            "headers": {
                "Authorization": "Bearer <DOCKHOST_API_TOKEN>"
            }
        }
    }
}

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

{
    "mcpServers": {
        "dockhost": {
            "serverUrl": "https://mcp.dockhost.io",
            "headers": {
                "Authorization": "Bearer <DOCKHOST_API_TOKEN>"
            }
        }
    }
}

OpenCode

Добавьте в opencode.json в корне проекта (или глобально ~/.config/opencode/opencode.json):

{
    "mcp": {
        "dockhost": {
            "type": "remote",
            "url": "https://mcp.dockhost.io",
            "headers": {
                "Authorization": "Bearer {env:DOCKHOST_TOKEN}"
            },
            "oauth": false
        }
    }
}

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.dockhost]
url = "https://mcp.dockhost.io"
bearer_token_env_var = "DOCKHOST_TOKEN"

Проверка подключения

Попросите AI-ассистента выполнить служебный tool ping — он проверяет доступность MCP сервера и корректность токена. Этот инструмент не входит в общий список tools и доступен всегда. Также можно проверить подключение напрямую:

curl -X POST https://mcp.dockhost.io/mcp \
  -H "Authorization: Bearer <DOCKHOST_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Типичные ошибки

Ошибка	Причина	Решение
401 Unauthorized	Токен отсутствует, невалиден или истёк	Проверьте токен и заголовок `Authorization`
Сервер не виден в клиенте	Неверный формат конфигурации	Сверьте конфиг с примером выше, перезапустите клиент

По умолчанию AI-ассистенту доступны все инструменты, включая удаление ресурсов. Рекомендуем настроить ограничение доступа (scope) — например, режим «только чтение» для диагностики.