Подключение ИИ-агента (MCP)

АвтоСчёт отдаёт ИИ-агентам инструменты по протоколу MCP: список покупателей, счета, акты, платежи, банковская выписка. Подключить агента можно двумя способами: программа с терминалом (Cursor, Claude Code, Codex) — по адресу сервера и API-ключу, браузерные ChatGPT и Claude — входом через АвтоСчёт, без ключа. Набор инструментов в обоих случаях определяется правами ключа или подключения. Эту страницу можно дать агенту как есть — она написана так, чтобы он настроил подключение сам.

Параметры

• Адрес сервера: https://autoschet.ru/api/mcp (транспорт Streamable HTTP).
• Авторизация: HTTP-заголовок Authorization: Bearer <API-ключ>.
• Ключ выпускается на странице API ключи (/api-keys) с нужным набором прав. Ключ показывается один раз.

Правила для агента

1. Значение ключа — секрет. Если ключ лежит в файле, не выводи его на экран, не цитируй в ответах и не вставляй в текст переписки: подставляй в команду через чтение файла ($(cat …)) или переменную окружения.
2. Ничего, кроме настройки MCP-подключения, по этой инструкции делать не нужно.
3. После настройки проверь, что сервер подключён и в списке инструментов есть get_organization. Если инструментов меньше, чем ожидалось, — это права ключа, а не ошибка: сообщи владельцу, каких прав не хватает.

Claude Code

Ключ в файле (например, ~/autoschet.key):

claude mcp add --transport http autoschet https://autoschet.ru/api/mcp \
  --header "Authorization: Bearer $(cat ~/autoschet.key)"
claude mcp get autoschet

Codex

Codex читает ключ из переменной окружения и не хранит его в файле настроек. Добавить в ~/.codex/config.toml:

[mcp_servers.autoschet]
url = "https://autoschet.ru/api/mcp"
bearer_token_env_var = "AUTOSCHET_API_KEY"

И задать переменную перед запуском (ключ из файла):

export AUTOSCHET_API_KEY="$(cat ~/autoschet.key)"

В сессии Codex команда /mcp показывает подключённые серверы.

Cursor

Настройки → MCP → Add new MCP server (откроется mcp.json). Запись сервера:

{
  "mcpServers": {
    "autoschet": {
      "url": "https://autoschet.ru/api/mcp",
      "headers": { "Authorization": "Bearer <API-ключ>" }
    }
  }
}

Агенту с доступом к терминалу: подставить ключ из файла в mcp.json командой, не показывая значение, например jq --arg k "$(cat ~/autoschet.key)" '.mcpServers.autoschet.headers.Authorization = "Bearer " + $k' mcp.json.

Другая программа

Нужны два значения: адрес https://autoschet.ru/api/mcp и заголовок Authorization: Bearer <API-ключ>. Если у программы есть поле «headers» или «authorization» для MCP-сервера — ключ туда.

ChatGPT и Claude в браузере

Браузерные ChatGPT и Claude ключа не принимают: они подключаются входом через АвтоСчёт. Адрес сервера тот же: https://autoschet.ru/api/mcp, поля client id и client secret оставьте пустыми — клиент зарегистрируется сам.

Claude (claude.ai): Настройки → Коннекторы → «Добавить пользовательский коннектор». Вставьте адрес — откроется окно АвтоСчёта.

ChatGPT: Настройки → Коннекторы (режим разработчика) → «Создать». Вставьте адрес — откроется то же окно.

В окне АвтоСчёта: войдите, если ещё не вошли, на экране «Подключить … к АвтоСчёту» (вместо многоточия — название клиента) отметьте права и нажмите «Разрешить» («Отклонить» закрывает окно без подключения). Права — те же наборы и галочки, что у API-ключа; по умолчанию отмечен набор «ИИ-агенту: чтение». Подключать может только владелец организации, как и выпускать ключи; права выдаются на активную организацию. Подключения доступны на тарифе «Про» и считаются в общий лимит с API-ключами.

Отзыв: страница API ключи (/api-keys), блок «Подключённые ИИ-агенты». После удаления подключения следующий запрос агента получит отказ — клиент предложит войти заново. Права задним числом не меняются: нужно удалить подключение и подключить заново с другим набором. Если подключением не пользоваться 30 дней, оно перестанет работать — подключите заново.

После подключения

Первый запрос агенту: «Начни с get_organization, list_clients и get_stats за текущий месяц и коротко расскажи, что видишь». Правила работы с данными (номера документов выдаёт сервер, документы создаются только по явной команде) сервер передаёт агенту сам при подключении.

Что агент сможет делать, зависит от прав ключа или подключения:

• только смотреть и считать — «Покупатели — чтение», «Счета — чтение», «Платежи — чтение», «Реквизиты организации — чтение», при необходимости «Банковская выписка — чтение»;
• выставлять документы — плюс «Счета — создание и правка», «Акты — создание и правка»; отправка писем покупателю — отдельное право «Счета — отправка на email»;
• разбирать выписку — «Банковская выписка — сопоставление»; «снятие сопоставления» удаляет платежи, давайте его осознанно.

Инструменты без прав агент не увидит вовсе. Соответствие инструментов и прав — в разделе «MCP для ИИ-агента» на странице Документация API (/api-docs).