Паветта
Как подключить MCP-сервер к Claude Desktop
Claude Desktop запускает локальные MCP-серверы из claude_desktop_config.json. Удалённые серверы подключаются отдельно, как свои коннекторы в разделе Connectors.
Где лежит конфиг
~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS%APPDATA%\Claude\claude_desktop_config.jsonWindows~/.config/Claude/claude_desktop_config.jsonLinuxКак добавить сервер
1
Локальный сервер
Меню Claude в системной строке → Settings… → Developer → Edit Config. Впишите сервер в mcpServers с command и args, сохраните файл и полностью перезапустите приложение.
2
Удалённый сервер
Customize → Connectors → + Add → Add custom connector. Введите имя и адрес сервера, проверьте настройки входа и нажмите Add.
3
Удалённый сервер с ключом API
В форме коннектора в разделе Request headers добавьте ключ: Claude будет отправлять его с каждым запросом.
Как проверить и удалить
ПроверкаНажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
УдалениеЛокальный сервер: удалите его запись из claude_desktop_config.json и перезапустите приложение. Коннектор удаляется в разделе Connectors.
Логиmcp.log — общий журнал подключений, mcp-server-ИМЯ.log — stderr конкретного сервера. Папка: ~/Library/Logs/Claude на macOS, %APPDATA%\Claude\logs на Windows, ~/.config/Claude/logs на Linux.
Подтверждение действийПеред каждым вызовом инструмента Claude спрашивает разрешение, запрос можно отклонить.
Права коннектораВ настройках коннектора можно включать и выключать отдельные инструменты.
Перенос в Claude CodeСерверы из claude_desktop_config.json переносятся командой claude mcp add-from-claude-desktop.
Готовые конфиги для Claude Desktop
Нажмите на сервер, чтобы раскрыть конфиг в формате Claude Desktop.
Playwright MCPДаёт агенту настоящий браузер
{
"mcpServers": {
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
GitHub MCPПодключает агента к GitHub
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://api.githubcopilot.com/mcp/
Request headers: Authorization: Bearer <GitHub PAT>
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.context7.com/mcp
Request headers: Authorization: Bearer <ключ Context7>
Figma MCPПодключает агента к макетам Figma
{
"mcpServers": {
"figma": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<ваш токен Figma>"
}
}
}
}
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
"mcpServers": {
"chrome-devtools": {
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Fetch MCPДаёт агенту читать веб-страницы
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Memory MCPДаёт агенту долгую память между чатами
{
"mcpServers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
}
}
}
}
Supabase MCPПодключает агента к проектам Supabase
Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.supabase.com/mcp
Notion MCPЛокальный сервер Notion поверх Notion API
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
Blender MCPСвязывает агента с запущенным Blender
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://<веб-сервер>/<имя публикации>/hs/mcp/
Request headers: Authorization: Basic <логин и пароль пользователя 1С>Ограничения
!
Пути в args указывайте абсолютные.
!
На тарифе Free доступен один свой коннектор.
!
Свой коннектор Claude подключает из облака Anthropic, поэтому сервер должен быть доступен из интернета.
!
Изменить коннектор нельзя: его удаляют и добавляют заново.
Если не работает
Сервер не появился
Полностью перезапустите приложение, проверьте синтаксис JSON и абсолютные пути, посмотрите логи.
Нужно понять, почему сервер не стартует
Запустите ту же команду в терминале, например npx -y @modelcontextprotocol/server-filesystem и пути, и посмотрите ошибку.
ENOENT и ${APPDATA} в пути на Windows
Добавьте в env сервера "APPDATA": "C:\\Users\\user\\AppData\\Roaming\\" и перезапустите Claude Desktop.
npx всё равно не запускается на Windows
Установите npm глобально: npm install -g npm. Признак установки — папка %APPDATA%\npm.
Инструменты вызываются с ошибкой
Проверьте логи, убедитесь, что сервер запускается без ошибок, и перезапустите приложение.
Частые вопросы
Где лежит claude_desktop_config.json?
На macOS в ~/Library/Application Support/Claude, на Windows в %APPDATA%\Claude, на Linux в ~/.config/Claude. Быстрее открыть его кнопкой Edit Config в Settings → Developer.
Можно ли прописать удалённый сервер в claude_desktop_config.json?
Файл описывает локальные серверы. Удалённый подключается как свой коннектор: Customize → Connectors → Add custom connector.
Нужно ли перезапускать приложение после правки конфига?
Да. Закройте Claude Desktop полностью и откройте снова, иначе новый сервер не запустится.
Как передать ключ API удалённому серверу?
В форме своего коннектора есть раздел Request headers: ключ из него отправляется с каждым запросом.
Источники: modelcontextprotocol.io, modelcontextprotocol.io, support.claude.com