MCP в Claude: коннекторы, Claude Desktop и Claude Code

Коротко: в claude.ai и Claude Desktop удалённый MCP-сервер подключается как пользовательский коннектор — вставили ссылку, вошли, готово. В Claude Code — одной командой claude mcp add --transport http или записью в .mcp.json. Ниже оба пути по шагам, с живыми ссылками на серверы, которые можно подключить прямо сейчас.

Если вы ещё не разобрались, что такое MCP и чем удалённый сервер отличается от локального, начните с обзора MCP-серверов — там пять минут чтения.

Где в Claude подключается MCP

Способ 1. Коннектор в claude.ai и Claude Desktop

Коннектор настраивается один раз в аккаунте Claude и дальше работает везде, где вы в него вошли: в браузере, в Desktop и на телефоне.

1. Откройте Настройки → Коннекторы (в английском интерфейсе — Settings → Connectors).
2. Нажмите Add custom connector, дайте коннектору имя и вставьте ссылку сервера, например https://twelver.ru/api/mcp/v1/web-search.
3. Нажмите Connect — откроется окно входа. Войдите в аккаунт Twelver и разрешите доступ.
4. В новом чате откройте меню инструментов и убедитесь, что коннектор включён. Попросите: «найди в интернете, что нового вышло у Claude за эту неделю» — Claude вызовет web-search.

Одна деталь, которая объясняет почти все жалобы «не подключается»: соединение с сервером устанавливают серверы Anthropic, а не ваш компьютер. Поэтому через коннектор подключаются только серверы, доступные из интернета, — сервер на localhost так подключить нельзя, для него есть Claude Code или Claude Desktop с локальной конфигурацией.

Способ 2. Claude Code: claude mcp add

В Claude Code удалённый сервер добавляется одной командой. Флаг --transport http обязателен — без него команда ждёт локальный процесс.

claude mcp add --transport http twelver-web-search https://twelver.ru/api/mcp/v1/web-search
claude mcp add --transport http twelver-image https://twelver.ru/api/mcp/v1/image-generation

Затем запустите claude и выполните команду /mcp: у новых серверов будет пометка, что нужен вход. Выберите сервер, пройдите вход в браузере — и инструменты появятся в сессии. Тот же список /mcp показывает, какие серверы подключены и сколько у каждого инструментов.

Где хранится настройка: три области

Вход по ключу вместо OAuth

OAuth удобен, но требует браузера и зарегистрированного аккаунта, а токен живёт 7 дней — потом вход нужно повторить. Для сервера без браузера, CI или просто «настроил и забыл» удобнее ключ в заголовке Authorization. Ключ выдаётся кнопкой ниже, без регистрации:

claude mcp add --transport http --scope user twelver-web-search https://twelver.ru/api/mcp/v1/web-search \
  --header "Authorization: Bearer sk-<ваш-ключ>"

Для проектного .mcp.json ключ в файл лучше не класть — он уедет в git. Claude Code подставляет переменные окружения в этот файл, поэтому ключ можно держать в TWELVER_API_KEY:

{
  "mcpServers": {
    "twelver-web-search": {
      "type": "http",
      "url": "https://twelver.ru/api/mcp/v1/web-search",
      "headers": {
        "Authorization": "Bearer ${TWELVER_API_KEY}"
      }
    }
  }
}

Долгие инструменты: генерация видео и таймауты

Поиск отвечает за секунды, а генерация видео — это минуты: сервер держит вызов открытым, пока ролик не будет готов. Если Claude Code обрывает вызов раньше, поднимите таймаут для этого сервера полем timeout (в миллисекундах) или для всех — переменной MCP_TOOL_TIMEOUT:

{
  "mcpServers": {
    "twelver-video": {
      "type": "http",
      "url": "https://twelver.ru/api/mcp/v1/seedance-video-generation",
      "timeout": 600000
    }
  }
}

Подробно о том, что приходит в ответ на генерацию и как с этим работать, — в главе генерация изображений и видео в Claude.

Яндекс.Вордстат в Claude

Отдельный случай — статистика поисковых запросов. Набор wordstat отдаёт частотность, динамику по месяцам и разбивку по регионам, поэтому Claude может собрать семантику и сразу разобрать её: отсеять накрутку, сгруппировать по интенту, сложить в ядро. Своего ключа Яндекса при этом не нужно — вход по OAuth, как у остальных наборов.

claude mcp add --transport http twelver-wordstat https://twelver.ru/api/mcp/v1/wordstat

В claude.ai и Claude Desktop это тот же путь, что и выше: Настройки → Коннекторы → Add custom connector и та же ссылка. Что именно умеет сервер и какие в нём инструменты — на странице Wordstat MCP; а если Вордстат нужен не в агенте, а просто в диалоге, это Вордстат-ассистент.

Соберите свой набор

Отметьте инструменты — ниже появятся ссылки для коннекторов по одной на набор. Для Claude Code их же можно передать в claude mcp add.

Если не работает

Работаете не только в Claude? Та же схема для Cursor, Codex и OpenCode.

Попробуйте сами

Соберите свой MCP-сервер за минуту

Отметьте нужные инструменты — ссылки коннекторов и mcp.json соберутся сами. Подключается к Claude, Cursor, LM Studio, Codex и OpenCode.

Собрать MCP-сервер

🛠️Лендинг по темеMCP-инструментыTwelver на AndroidТот же чат в приложении