Подключись к «Вручай» сам

Инструкция для ИИ-агента, которому человек написал «подключи Вручай». Пройди шаги по порядку и закончи проверкой. Человеку останется одно действие — войти в кабинет «Вручай» в браузере и нажать «Разрешить». Токен для этого не нужен.

Сервер MCP: https://vruchay.ru/mcp, транспорт Streamable HTTP, вход через OAuth.

1. Может, ты уже подключён

Если среди твоих инструментов есть get_account от сервера vruchay (в Claude Code — mcp__vruchay__get_account), вызови его. Ответил организацией и остатком — подключение есть, переходи к задаче человека.

2. Узнай, где ты работаешь

Обычно ты знаешь это сам. Если нет и у тебя есть терминал — посмотри, какие команды доступны: command -v claude codex gemini code cursor.

3. Добавь сервер

Выполни команду для своего приложения. Если сервер vruchay уже добавлен, но не работает, — сначала убери его (claude mcp remove vruchay, codex mcp remove vruchay, gemini mcp remove vruchay).

Для Cursor файл ~/.cursor/mcp.json надо дополнить, а не перезаписать: прочитай его, добавь в объект mcpServers ключ vruchay и сохрани. Остальные серверы оставь как были. Если файла нет — создай:

{
  "mcpServers": {
    "vruchay": { "url": "https://vruchay.ru/mcp" }
  }
}

Windsurf, Devin Desktop, Zed и другие клиенты с удалённым MCP подключаются так же: адрес https://vruchay.ru/mcp, без заголовков, вход через OAuth. Где у них лежат настройки — в mcp.md.

4. Скажи человеку одно действие

Например: «Я добавил сервер «Вручай». Выполните /mcp, выберите vruchay и нажмите Authenticate. Откроется страница «Вручай»: войдите и нажмите «Разрешить». Права „Выпускать документы“ хватит для вёрстки и выпуска, „Полный доступ“ нужен для форм, отзыва и перевыпуска».

Ещё нужно знать:

• Разрешить подключение может только владелец или управляющий организации. Если откроется «Нужны права управляющего», попроси человека позвать их.
• Инструменты появятся после входа. Некоторым приложениям нужен перезапуск или новый чат. Скажи об этом, если инструменты не появились.

5. Проверь

Вызови get_account. В ответе — организация, остаток (left), срок (expired) и проекты. Скажи человеку, что подключение работает и сколько документов можно выпустить, и переходи к задаче.

Если ты в чат-приложении

Claude.ai, Claude Desktop и ChatGPT не дают агенту добавить сервер самому: это делает человек в настройках. Дай ему шаги:

• Claude: Customize → Connectors → Add custom connector. Название «Вручай», адрес https://vruchay.ru/mcp. Если спросит про OAuth client — «Register automatically». Затем Connect → войти в «Вручай» → «Разрешить». В чате: «+» → Connectors → включить «Вручай».
• ChatGPT: нужен режим разработчика (Developer mode). Plugins → «+» → Add custom MCP server, адрес https://vruchay.ru/mcp, Authentication — OAuth. Затем войти в «Вручай» и разрешить. В чате — @ → «Вручай».

Подробности и тарифы — в mcp.md.

Если без токена нельзя

Некоторые программы не умеют входить через OAuth. Тогда нужен токен из кабинета: Настройки → Интеграции и API → Токены API (выдаёт владелец или управляющий).

• Никогда не вписывай токен в файлы, команды и сообщения. Попроси человека положить его в переменную окружения VRUCHAY_TOKEN и ссылайся на неё: Codex — bearer_token_env_var = "VRUCHAY_TOKEN"; Cursor — "headers": {"Authorization": "Bearer ${env:VRUCHAY_TOKEN}"}; Claude Code (.mcp.json) — "Bearer ${VRUCHAY_TOKEN}".
• Если человек всё же прислал токен в чат, не повторяй его в ответах и посоветуй потом выдать новый, а этот отозвать.

Если MCP нет совсем

Работай с REST API: https://vruchay.ru/api, заголовок Authorization: Bearer <токен> (как получить токен — выше). Порядок работы тот же. Сценарии с запросами REST — в AGENTS.md.

Если не получается