MCP для ИИ-агентов

В Veresk встроен MCP-сервер (Streamable HTTP, без состояния), чтобы ИИ-агент мог делать ту же работу, что и REST API: читать и править файлы, управлять версиями и тегами, сравнивать и публиковать. У них общая логика и одинаковые права.

Эндпоинт: https://<your-veresk-host>/api/mcp. Аутентификация — API-токеном.

Claude Code

claude mcp add --transport http veresk https://<your-veresk-host>/api/mcp \
  --header "Authorization: Bearer <YOUR_API_TOKEN>"

Codex

Codex читает токен из переменной окружения, поэтому сам токен в конфиг-файл не попадает.

1. Задайте переменную в оболочке, из которой запускаете Codex:

   export VERESK_API_TOKEN="<YOUR_API_TOKEN>"
   

2. Добавьте сервер в ~/.codex/config.toml:

   [mcp_servers.veresk]
   url = "https://<your-veresk-host>/api/mcp"
   bearer_token_env_var = "VERESK_API_TOKEN"
   

В bearer_token_env_var указывается имя переменной, а не сам токен. Если переменная не задана на момент запуска Codex, Codex не отправит токен, и Veresk ответит 401 Unauthorized. Чтобы проверить, что сервер настроен, выполните codex mcp list.

Cursor, VS Code, Claude Desktop и другие

Добавьте сервер в MCP-конфигурацию клиента (в этом варианте токен передаётся в заголовке):

{
  "mcpServers": {
    "veresk": {
      "url": "https://<your-veresk-host>/api/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_TOKEN>" }
    }
  }
}

Страница Account & API показывает эти варианты с подставленным вашим хостом и, сразу после создания токена, с вашим токеном.

Ограничения

• Аутентификация — токеном в заголовке. OAuth не поддерживается, поэтому веб-коннекторы, которым нужен OAuth (например, коннекторы claude.ai или ChatGPT), подключиться не могут.
• У агентов те же ограничения, что и у REST API: нельзя создавать и удалять проекты, менять роли и трогать шифрование и Git.
• Файлы, изменённые агентом, получают теги api-created и api-edited.

Эта документация для агентов

Документация публикуется обычным HTML, а также по адресам /llms.txt и /llms-full.txt, чтобы агент мог читать её без браузера.