Вы когда-нибудь ловили себя на мысли: «Вот бы Claude сам сходил в мою базу данных, вытащил нужные цифры и выдал отчёт, пока я пью кофе»? Я вот ловлю постоянно. Это не фантастика 2026 года, а ежедневная реальность, которую можно настроить прямо сейчас.

В этой статье мы разберем, как подключить Claude Code к любой базе данных через MCP Registry. Вы получите конкретные конфиги и пошаговые инструкции, чтобы самостоятельно настроить эту мощную интеграцию и автоматизировать рутинные задачи.

Зачем Claude Code нужен доступ к вашей базе данных?

Давайте начистоту: ИИ-системы хороши в обработке информации. Но до сих пор у многих фаундеров и разработчиков они работают в вакууме. Мой опыт работы с Claude Code показывает: самая большая ценность раскрывается, когда он получает доступ к реальным данным. К вашим данным. К той информации, которая хранится в вашей базе данных и определяет ваш бизнес.

Представьте: вы спрашиваете Claude: «Покажи, сколько новых пользователей пришло за прошлую неделю и какой у них средний чек». Claude Code сам идёт в PostgreSQL, выполняет запрос и возвращает вам ответ. Никаких промежуточных интерфейсов. Просто диалог.

Это сокращает время принятия решений. Это освобождает вас от рутины. Это даёт вам второго мозга, который всегда готов предоставить нужные данные. Всё это стало возможным благодаря Model Context Protocol (MCP) — открытому стандарту, который позволяет Claude Code общаться с внешним миром. Если хотите глубже погрузиться в возможности Claude Code, рекомендую почитать мою статью 5 навыков Claude Code, экономящих часы еженедельно.

Что такое MCP Registry и как он связывает Claude с БД?

Model Context Protocol (MCP) — это универсальный язык, на котором Claude Code может общаться с чем угодно: базами данных, сторонними API, вашими внутренними инструментами. MCP Registry — это публичный или приватный каталог этих самых "инструментов", или, как их называют, MCP-серверов.

MCP Registry — это такой "магазин приложений" для Claude Code. Когда вы подключаете Claude Code к MCP Registry, он получает список доступных инструментов и может использовать их по мере необходимости. Для нас, разработчиков и фаундеров, это означает, что мы можем взять готовый MCP-сервер для PostgreSQL, MySQL или любой другой базы, либо написать свой собственный, зарегистрировать его, и Claude Code тут же сможет к нему обращаться.

Например, для доступа к базе данных я использую Supabase MCP. Он позволяет Claude Code не просто выполнять SQL-запросы, но и понимать схему базы, помогать с миграциями, давать советы по оптимизации. Это интеллектуальный интерфейс к вашей БД.

Шаг 1: Установка и настройка Claude Code CLI

Прежде чем мы начнём, убедитесь, что у вас установлен Claude Code CLI. Это ваш основной инструмент для взаимодействия с Claude Code и MCP-серверами. Если ещё нет, то вот как это сделать:

npm install -g @anthropic/claude-code-cli

После установки нужно авторизоваться. Claude Code попросит у вас API-ключ. Его можно получить в вашей учётной записи Anthropic.

claude-code login

Этот шаг критичен. Без него Claude Code не сможет выполнять команды и подключаться к MCP Registry.

Шаг 2: Выбор и запуск MCP-сервера для вашей БД

Теперь самое интересное — подключение к базе данных. MCP Registry предлагает множество готовых серверов. Вы можете найти их на Official MCP Registry. Для примера, я буду использовать условный postgres-mcp-server, который я сам настроил для своих нужд. Предположим, что вы уже скачали или сгенерировали такой сервер.

Обычно, MCP-сервера запускаются как обычные Node.js приложения. У каждого сервера есть свои переменные окружения для подключения к базе данных. Вот пример, как я запускаю свой postgres-mcp-server:

DATABASE_URL="postgresql://user:password@host:port/database" \
MCP_SERVER_PORT=8080 \
node /path/to/your/postgres-mcp-server/index.js

Здесь DATABASE_URL — это строка подключения к вашей PostgreSQL базе. MCP_SERVER_PORT — порт, на котором будет работать MCP-сервер. Замените эти значения на свои.

Важно: Для локальной разработки вы можете запустить сервер на localhost. Если ваша база данных находится во внутренней сети, убедитесь, что MCP-сервер имеет к ней доступ. Это особенно актуально, если вы планируете развернуть MCP-сервер на отдельном хостинге.

Шаг 3: Добавление MCP-сервера в Claude Code

После того как ваш MCP-сервер запущен и доступен (например, по адресу http://localhost:8080), вам нужно добавить его в Claude Code. Это делается с помощью команды claude-code mcp add.

claude-code mcp add my-postgres-db http://localhost:8080

my-postgres-db — это имя, которое вы даёте этому MCP-серверу в Claude Code. Используйте понятное имя, чтобы потом не запутаться.
http://localhost:8080 — адрес, по которому запущен ваш MCP-сервер.

Claude Code сохранит эту конфигурацию. Вы можете проверить список подключённых серверов:

claude-code mcp list

Эта команда покажет вам все активные MCP-серверы, к которым Claude Code может обращаться. Если вы хотите узнать больше о подключении к серверам MCP, загляните в документацию Подключение к серверам MCP - Claude Code Docs.

Шаг 4: Тестирование интеграции и выполнение запросов

Итак, сервер добавлен. Теперь давайте проверим, работает ли всё. Вы можете начать чат с Claude Code и попросить его взаимодействовать с вашей базой данных.

Например, я могу попросить Claude Code сделать следующее:

@claude-code chat

Покажи мне 5 последних заказов из таблицы `orders` из базы `my-postgres-db`. Мне нужны поля `id`, `user_id`, `amount` и `created_at`.

Claude Code распознает, что вы хотите обратиться к MCP-серверу my-postgres-db и сгенерирует соответствующий SQL-запрос. Он покажет вам этот запрос и спросит подтверждения перед выполнением. Это очень важная функция безопасности, позволяющая убедиться, что ИИ делает именно то, что вы от него ожидаете.

После подтверждения Claude Code выполнит запрос через MCP-сервер и вернёт вам результат. Это может выглядеть как таблица или структурированный JSON, в зависимости от конфигурации MCP-сервера.

Конфигурация для сложных запросов

Если ваша база данных сложнее или вам нужны более детальные возможности, можно настроить MCP-сервер так, чтобы он предоставлял Claude Code не только прямое выполнение SQL, но и информацию о схеме базы, индексах, отношениях между таблицами. Это повышает "интеллект" Claude Code при работе с БД.

Например, я использую CLAUDE.md файлы в своих проектах, где описываю структуру базы данных, ключевые таблицы, бизнес-логику. Claude Code автоматически читает эти файлы и использует их для более точного понимания моих запросов. Это как дать Claude Code "техническое задание" на вашу базу. Подробнее о том, как Claude использует контекст, я писал в статье ИИ-контекст: почему файлы на компьютере важнее чем платная память у ChatGPT.

Вот пример конфигурации, которую я могу использовать для своего postgres-mcp-server, чтобы он передавал Claude Code схему базы данных:

// Внутри вашего postgres-mcp-server/index.js

const { Client } = require('pg');
const express = require('express');
const bodyParser = require('body-parser');
const app = express();
const port = process.env.MCP_SERVER_PORT || 8080;

const dbClient = new Client({
    connectionString: process.env.DATABASE_URL,
});

app.use(bodyParser.json());

// Определение инструмента для выполнения SQL-запросов
// Этот skill будет доступен Claude Code
app.post('/execute-sql', async (req, res) => {
    const { query, params } = req.body;
    try {
        await dbClient.connect();
        const result = await dbClient.query(query, params);
        res.json({ success: true, data: result.rows });
    } catch (error) {
        console.error('Error executing SQL:', error);
        res.status(500).json({ success: false, error: error.message });
    } finally {
        await dbClient.end();
    }
});

// Новый endpoint для получения схемы БД
app.get('/get-schema', async (req, res) => {
    try {
        await dbClient.connect();
        const schemaQuery = `
            SELECT table_name, column_name, data_type
            FROM information_schema.columns
            WHERE table_schema = 'public'
            ORDER BY table_name, ordinal_position;
        `;
        const result = await dbClient.query(schemaQuery);
        res.json({ success: true, schema: result.rows });
    } catch (error) {
        console.error('Error fetching schema:', error);
        res.status(500).json({ success: false, error: error.message });
    } finally {
        await dbClient.end();
    }
});

// MCP Registry endpoint для описания доступных инструментов
app.get('/mcp-manifest', (req, res) => {
    res.json({
        name: "my-postgres-db",
        description: "Инструмент для взаимодействия с PostgreSQL базой данных.",
        skills: [
            {
                name: "execute-sql",
                description: "Выполняет SQL-запрос к базе данных.",
                parameters: {
                    type: "object",
                    properties: {
                        query: { type: "string", description: "SQL-запрос для выполнения." },
                        params: { type: "array", description: "Массив параметров для SQL-запроса." }
                    },
                    required: ["query"]
                }
            },
            {
                name: "get-schema",
                description: "Получает схему всех таблиц в базе данных.",
                parameters: {
                    type: "object",
                    properties: {}
                }
            }
        ]
    });
});

app.listen(port, () => {
    console.log(`MCP Postgres Server listening on port ${port}`);
});

В этом примере я добавил новый skill get-schema, который Claude Code может вызвать, чтобы получить структуру вашей базы данных. Если Claude Code не знает, какие таблицы есть или как они связаны, он может сначала вызвать get-schema, а потом уже сформулировать запрос через execute-sql. Это значительно расширяет его возможности как разработчика.

Как это работает на практике: сокращаем время на отчёты

Я внедрил подобную систему для одного из своих клиентов — фаундера SaaS-проекта. Он тратил несколько часов в неделю на ручное формирование отчётов по активности пользователей, конверсии и метрикам удержания. Ему приходилось каждый раз заходить в админку, копировать данные, сводить их в Excel. Мои глаза слезились, когда я это видел.

Мы подключили Claude Code к его PostgreSQL базе через MCP-сервер, который я специально для него написал. Теперь он просто открывает Claude Code и говорит:

@claude-code chat

Сделай мне отчёт по активности пользователей за последний месяц. Покажи количество новых регистраций, количество активных пользователей (логинились хотя бы раз), и среднее время в сессии. Все данные из базы `my-saas-db`.

Claude Code, зная структуру базы (благодаря get-schema и CLAUDE.md файлам), сам генерирует несколько SQL-запросов, выполняет их через MCP-сервер, агрегирует данные и выдаёт ему готовый, понятный отчёт.

Результат: Фаундер экономит 3-4 часа в неделю. Это время он теперь тратит не на рутину, а на стратегическое планирование и принятие решений. Это освобождает голову для роста бизнеса. В этом и есть реальный ROI от ИИ.

Частые вопросы

Можно ли подключить Claude Code к любой базе данных?

Да, теоретически можно. MCP — это открытый протокол. Если есть драйвер для вашей базы данных (SQL, NoSQL, графовые), то можно написать соответствующий MCP-сервер и подключить его к Claude Code.

Насколько безопасно давать Claude Code доступ к базе данных?

Безопасность критична. Я рекомендую использовать отдельные учётные записи для доступа к базе данных с минимальными привилегиями (только чтение или только необходимые операции). Кроме того, Claude Code всегда запрашивает подтверждение перед выполнением запросов, особенно тех, что могут модифицировать данные.

Нужно ли быть разработчиком, чтобы настроить MCP Registry?

Для использования готовых MCP-серверов в Claude Code CLI достаточно базовых навыков работы с командной строкой. Но для написания собственного MCP-сервера или его сложной настройки, да, потребуется знание программирования (чаще всего Node.js).

Может ли Claude Code сам писать миграции базы данных?

Да, с правильно сконфигурированным MCP-сервером и соответствующими skill'ами, Claude Code может не только читать, но и предлагать изменения в схеме, а также генерировать SQL-миграции. Это требует особого внимания к безопасности и тестированию.

Где найти готовые MCP-серверы?

На официальном Official MCP Registry вы можете найти список доступных серверов. Сообщество активно разрабатывает новые MCP-серверы, так что список постоянно пополняется.

Готовы автоматизировать рутину и освободить время?

Если вы хотите системно разобраться в работе с ИИ и Claude Code, научиться создавать такие системы, которые реально работают и приносят результат — у меня есть гайд «ИИ вместо команды». Там я собрал готовые системы и команды, которые настраиваются за вечер, чтобы вы могли использовать ИИ по-настоящему, а не просто читать про него.