концепции · технический гайд

MCP-серверы

MCP (Model Context Protocol) - открытый стандарт от Anthropic, единый способ подключать внешние инструменты и данные к LLM. Один разъём вместо десятка самописных интеграций - USB-C для AI. Этот гайд: что это, как устроено, как подключить готовый сервер и как написать свой.

MCP - единый протокол подключения инструментов и данных к LLM

MCP поддерживают Claude, Cursor, OpenAI/Codex и другие. Подключил сервер один раз - и он работает в любом клиенте.

что вы поймёте

Зачем нужен MCP
Раньше каждую связку LLM с сервисом писали вручную под каждую модель. MCP - один стандарт на всех.
Как подключить сервер
Где лежит конфиг в Claude Desktop, Cursor и проекте, как добавить filesystem или github и проверить.
Как написать свой
Официальный SDK на TS или Python, описываешь tools - и клиент их видит. Когда это вообще нужно.

главы гайда

00

Что такое MCP

Проблема: раньше каждую интеграцию LLM с сервисом писали вручную под каждую модель. Решение - единый открытый стандарт от Anthropic. USB для AI.

01

Как работает MCP

Хост/клиент с LLM и MCP-сервер. Что отдаёт сервер: tools, resources, prompts. Транспорт stdio для локальных и HTTP/SSE для удалённых.

02

Подключить готовый сервер

Где лежит конфиг: Claude Desktop, .mcp.json в проекте, настройки Cursor. Пример подключения filesystem и github. Перезапуск клиента и проверка.

03

Топ готовых MCP-серверов

filesystem, github, postgres, playwright, fetch, slack, notion, brave-search. Что делает каждый и зачем его подключать.

04

Свой MCP-сервер

Официальные SDK на TypeScript и Python от Anthropic. Что определяешь: tools с описанием. Как клиент это видит. Минимальный пример и когда писать свой.

05

Шпаргалка

Где какой конфиг - таблицей. Глоссарий: tool, resource, transport, host, server. Ссылки на смежные разделы базы знаний.

06

Context7: свежая документация

MCP-сервер Context7 подгружает агенту актуальную документацию библиотек и фреймворков (Next.js, React и др.), чтобы он не выдумывал устаревший код. Как подключить и когда полезен.

07

Playwright: браузер для агента

MCP-сервер Playwright даёт агенту управлять браузером: открывать страницы, кликать, заполнять формы, делать скриншоты, тестировать веб. Зачем нужен и как подключить.

08

Чтение веба: WebFetch и Fetch

Агент может сходить по URL и прочитать страницу: встроенный WebFetch у некоторых агентов и MCP-сервер fetch. Зачем это нужно и чем отличается от полноценного браузера.