developer › getting-started

Запуск MCP-сервера локально

Поднимаем mcp-server-core через Docker за 5 минут и подключаем его к Claude Desktop как локальный MCP-сервер.

Что вам понадобится

Docker 24+ и docker compose v2
Node.js 20+ — опционально, для разработки коннекторов
Свободный порт 8080 (или измените в .env)
Claude Desktop — для проверки подключения

Шаг 1 · Клон репозитория

Публичный репозиторий откроется в Q3 2026. До этого — подпишитесь на Telegram-канал для анонса.

# После публичного релиза в Q3 2026:
# git clone <ссылка-будет-объявлена-в-канале>
# cd mcp-server-core

Шаг 2 · Настройте окружение

Скопируйте example-файл и при желании поправьте параметры:

cp .env.example .env

Минимальный набор переменных:

Переменная	По умолчанию	Что делает
`MCP_PORT`	`8080`	HTTP-порт сервера
`MCP_TRANSPORT`	`sse`	`sse` или `http`
`MCP_AUTH_MODE`	`none`	`none` / `oauth` / `apikey`
`MCP_DATA_DIR`	`./data`	Где хранятся локальные данные
`LOG_LEVEL`	`info`	`trace` / `debug` / `info`

Для локальной разработки оставьте MCP_AUTH_MODE=none. Это отключит OAuth — сервер будет доступен без авторизации (только для localhost).

Шаг 3 · Запустите сервер

docker compose up -d

# Логи
docker compose logs -f mcp

Проверьте, что сервер отвечает:

curl http://localhost:8080/mcp/v1/health

Ожидаемый ответ:

{
  "status": "ok",
  "version": "0.1.0",
  "tools": 6,
  "transport": "sse"
}

Шаг 4 · Подключите к Claude Desktop

Откройте Settings → Developer → Edit Config и добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "edl-os-local": {
      "url": "http://localhost:8080/mcp/v1",
      "transport": "sse"
    }
  }
}

Перезапустите Claude Desktop. В выпадушке инструментов появится edl-os-local с доступными tools.

Шаг 5 · Вызов tool из Claude

В чате Claude спросите:

Используй tool list_tools из edl-os-local и покажи все доступные инструменты.

Claude вызовет tools/list через MCP и покажет в ответе список — типа этого:

[
  { "name": "founder_score",    "description": "Расчёт Founder OS Score" },
  { "name": "get_revenue",      "description": "Выручка по периодам" },
  { "name": "list_customers",   "description": "Список клиентов" }
  // ...ещё 3
]

Дальше

Хотите подключить свой источник данных? → Свой коннектор
Нужно понять формат запросов? → JSON-RPC схема
Готовы выкатить в прод? Используйте managed-хостинг с готовым OAuth + audit log.

← назад

Введение

Свой коннектор