Что такое MCP-сервер: простое объяснение и как подключить к Claude Code и Cursor

Что такое MCP простыми словами

Сразу скажу, за аббревиатурой ничего страшного нет. MCP расшифровывается как Model Context Protocol, это открытый протокол, по которому ИИ-агент обращается к внешним данным и инструментам. Агент здесь это программа вроде Claude Code или Cursor: вы пишете ей задачу, а она сама читает файлы, запускает команды и правит код.

Беда у любого агента одна. Всё, что он знает о вашей работе, это проект на диске и то, что вы написали ему в чате. Заметки, записи созвонов, данные в других сервисах ему не видны. Раньше это закрывали костылями: копировали текст в чат руками или писали под каждого агента свою интеграцию.

MCP даёт общий способ подключить к агенту внешний источник. С одной стороны сервер, который умеет что-то делать с вашими данными, с другой агент, который говорит по протоколу. Если оба понимают MCP, они договорятся без отдельной доработки под каждую пару. Поэтому слово и всплывает в настройках почти любого кодового агента, а вопрос «mcp сервер что это» задают так часто.

Как работает: клиент, сервер, инструменты

Участников три.

Первый это клиент MCP, то есть сам агент: Claude Code, Cursor или другая программа с поддержкой протокола. Клиент подключается к серверу и спрашивает, что тот умеет.

Второй это сервер MCP. В ответ на вопрос клиента он объявляет список инструментов. У каждого инструмента есть имя, описание и параметры, допустим «найти заметку по тексту» с параметром «строка поиска».

Третий это сами инструменты, действия, которые сервер готов выполнить по просьбе агента. И вот тут главное: агент сам решает, какой инструмент вызвать и когда. Вы не пишете ему «вызови search_notes с таким-то параметром». Вы пишете «найди в моих заметках, что мы решили про сроки». Агент смотрит на список, выбирает подходящий инструмент, вызывает его и читает ответ. Мало данных, вызывает следующий.

То есть по факту MCP-сервер это набор кнопок с подписями, а агент тот, кто по подписям понимает, какую нажать. Чем понятнее подписи, тем реже агент промахивается.

Локальный и удалённый сервер

Серверы бывают двух видов, и от этого зависит, как их подключать.

Локальный MCP-сервер запускается на вашем компьютере. Агент стартует его как обычную программу и обменивается с ним через стандартный ввод и вывод (stdin и stdout). Так подключают то, что живёт рядом с вами: файлы, локальную базу, утилиты. Минус понятный, сервер надо установить, следить за его зависимостями и обновлять самому.

Удалённый сервер работает в сети, агент обращается к нему по HTTP. Ставить ничего не нужно, в настройках клиента указывается адрес и, как правило, ключ доступа. Это удобно, когда данные и так лежат в сервисе: тащить их к себе на диск ради агента смысла нет.

Выбор тут не про вкус, а про то, где лежат данные. Файлы на вашем диске логично отдавать локальным сервером, заметки и расшифровки в облачном сервисе удалённым.

Как подключить MCP-сервер к Claude Code и Cursor

Покажу на примере Voisee, потому что это наш сервис и я знаю, как он устроен. MCP-сервер Voisee удалённый, поднимать у себя ничего не надо. Адрес:

https://voisee.pro/api/v1/mcp

Подключение идёт по ключу API. Ключ создаётся в кабинете, в разделе ключей API, и есть он на тарифах Pro и Pro+. Передаётся ключ заголовком Authorization: Bearer, как и в остальном API Voisee.

Claude Code

Одна команда в терминале, вместо wsk_… подставьте свой ключ:

claude mcp add --transport http voisee https://voisee.pro/api/v1/mcp --header "Authorization: Bearer wsk_…"

Так сервер подключится к одному проекту. Флаг --scope user подключает его для всех ваших проектов:

claude mcp add --scope user --transport http voisee https://voisee.pro/api/v1/mcp --header "Authorization: Bearer wsk_…"

Проверка подключения, сервер voisee должен появиться в списке:

claude mcp list

Cursor

В Cursor сервер добавляется в файл .cursor/mcp.json в проекте:

{
  "mcpServers": {
    "voisee": {
      "url": "https://voisee.pro/api/v1/mcp",
      "headers": { "Authorization": "Bearer wsk_…" }
    }
  }
}

Чтобы сервер работал во всех проектах, ту же запись кладут в ~/.cursor/mcp.json.

С другими клиентами схема та же. Подойдёт любой клиент MCP, который умеет HTTP-транспорт и передаёт свои заголовки: указываете адрес сервера и заголовок Authorization.

Отдельно про ключ. Он даёт агенту доступ ко всем вашим заметкам и расшифровкам, поэтому в репозиторий его не публикуйте: файл .cursor/mcp.json в проекте добавьте в .gitignore или храните запись в ~/.cursor/mcp.json.

Для Claude Code у нас есть ещё скилл, папка с инструкцией, которую агент находит в ~/.claude/skills. Скилл подсказывает агенту, когда идти в Voisee и в каком порядке вызывать инструменты. Рядом лежит скрипт проверки на Python: он берёт ключ из переменной VOISEE_API_KEY, просит у сервера список инструментов и печатает их имена. Команды установки и полный текст скилла лежат на странице MCP-сервер Voisee, а параметры инструментов и коды отказов в справочнике для разработчиков.

Для чего нужен MCP-сервер: агент находит ваши заметки и расшифровки

Инструменты интересны тем, к каким данным они ведут. У Voisee это две вещи: голосовые заметки, которые вы наговорили в приложении, и расшифровки ваших записей. Сервер даёт агенту пять инструментов:

• search_notes ищет заметки по тексту и тегу, сначала свежие;
• get_note отдаёт заметку целиком по id;
• create_note создаёт новую заметку, и она сразу появляется в приложениях Voisee;
• search_transcripts ищет по тексту расшифровок, можно начиная с даты;
• get_transcript отдаёт расшифровку целиком по id.

Вручную их вызывать не нужно. Вы просите обычными словами, а агент сам собирает цепочку вызовов. Например:

• «Найди в моих заметках, что решили про сроки, и составь план».
• «Найди расшифровку созвона за прошлую неделю и выпиши задачи».
• «Сохрани этот план заметкой с тегом work».

В первом случае агент вызовет поиск по заметкам, откроет найденное и уже по нему напишет план. Во втором найдёт расшифровку по тексту и дате и прочитает её целиком. В третьем создаст заметку, которую вы потом увидите в приложении.

Чего сервер не делает, тоже стоит знать заранее. Правки и удаления заметок через MCP нет: агент ищет, читает и создаёт, но не меняет и не стирает ваши данные. Инструменты видят только данные владельца ключа. У вызовов инструментов свой суточный лимит, он считается отдельно от запросов на распознавание.

Итог

MCP-сервер это способ дать агенту доступ к данным, которых нет у него в проекте. Сервер объявляет инструменты, агент сам выбирает, какой вызвать. Локальный сервер живёт на вашем компьютере, удалённый в сети и подключается по адресу и ключу.

Если вы и так работаете в Claude Code или Cursor и держите мысли и записи созвонов в Voisee, подключение занимает одну команду или одну запись в mcp.json. Дальше агент сам находит нужную заметку или расшифровку, а вы перестаёте копировать текст в чат руками. Ключ API есть на тарифах Pro и Pro+, всё про подключение собрано на странице MCP-сервер Voisee.