Подключение через MCP
Пошаговое руководство: подключить Typizer как MCP-сервер в Claude Desktop, Claude Code, Cursor и VS Code.
Typizer отдаёт свой API ИИ-агентам через MCP (Model Context Protocol,
протокол контекста модели) — сервер по адресу https://api.typizer.ru/mcp. Авторизация — ключ API
как Authorization: Bearer tz_live_… (скоупы те же, что у ключей REST API; подробнее —
«Ключи API» и справочник MCP). Отдельной регистрации
приложения или OAuth не требуется.
Подключение из браузера не поддерживается: у /mcp нет CORS. Клиент должен быть локальным
приложением (Claude Desktop, Claude Code, Cursor, VS Code) или сервером.
Claude Code
Claude Code поддерживает удалённые MCP-серверы с заголовком авторизации нативно:
claude mcp add --transport http typizer https://api.typizer.ru/mcp --header "Authorization: Bearer tz_live_…"Claude Desktop
Удалённые коннекторы Claude Desktop не умеют отправлять свой заголовок Authorization, поэтому
авторизация идёт через мост mcp-remote: он получает
вызовы от Claude Desktop по stdio и пересылает их на https://api.typizer.ru/mcp с заголовком
Authorization. Ключ передан через переменную окружения TYPIZER_AUTH, а не напрямую в args,
как рекомендует README mcp-remote — так он не остаётся в списке процессов. Добавьте в
claude_desktop_config.json:
{
"mcpServers": {
"typizer": {
"command": "npx",
"args": [
"mcp-remote",
"https://api.typizer.ru/mcp",
"--header",
"Authorization:${TYPIZER_AUTH}"
],
"env": {
"TYPIZER_AUTH": "Bearer tz_live_…"
}
}
}
}Эта схема может измениться в новой версии Claude Desktop — если заголовки авторизации для
удалённых серверов станут нативно поддерживаться, мост mcp-remote больше не понадобится.
Сверяйтесь с актуальной документацией Claude Desktop.
Cursor
Cursor поддерживает удалённые HTTP-серверы с заголовками нативно (по документации Cursor на
момент написания — сверяйтесь с актуальной документацией клиента). Добавьте в .cursor/mcp.json:
{
"mcpServers": {
"typizer": {
"url": "https://api.typizer.ru/mcp",
"headers": {
"Authorization": "Bearer tz_live_…"
}
}
}
}VS Code
VS Code поддерживает удалённые HTTP-серверы с заголовками нативно (по документации VS Code на
момент написания — сверяйтесь с актуальной документацией клиента). Добавьте в .vscode/mcp.json:
{
"servers": {
"typizer": {
"type": "http",
"url": "https://api.typizer.ru/mcp",
"headers": {
"Authorization": "Bearer tz_live_…"
}
}
}
}Проверка
После подключения спросите агента: «Какие типизаторы у меня есть?» — это вызовет инструмент
list_typizers. Полный список инструментов и их параметров — в справочнике
MCP.