Необходимые cookie-файлы нужны для работы сайта. Аналитические cookie (Яндекс Метрика) — только с вашего согласия. Политика cookie-файлов

Тема оформления
Обучение

Подключение через 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-серверы с заголовком авторизации нативно:

bash
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:

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:

JSON
{
  "mcpServers": {
    "typizer": {
      "url": "https://api.typizer.ru/mcp",
      "headers": {
        "Authorization": "Bearer tz_live_…"
      }
    }
  }
}

VS Code

VS Code поддерживает удалённые HTTP-серверы с заголовками нативно (по документации VS Code на момент написания — сверяйтесь с актуальной документацией клиента). Добавьте в .vscode/mcp.json:

JSON
{
  "servers": {
    "typizer": {
      "type": "http",
      "url": "https://api.typizer.ru/mcp",
      "headers": {
        "Authorization": "Bearer tz_live_…"
      }
    }
  }
}

Проверка

После подключения спросите агента: «Какие типизаторы у меня есть?» — это вызовет инструмент list_typizers. Полный список инструментов и их параметров — в справочнике MCP.