Apiin

MCP для нейросетей

MCP (Model Context Protocol) — стандарт, по которому ИИ-ассистент получает доступ к инструментам. MCP-сервер Apiin ходит в тот же REST API по вашему ключу, а ассистент вызывает действия по команде на естественном языке.

Адрес сервера

Единый endpoint MCP-сервера Apiin:

https://mcp.apiin.ru/mcp

Есть два способа подключения — выберите по клиенту.

claude.ai и ChatGPT — по кнопке (OAuth)

Веб-клиенты подключают MCP через встроенный вход — ключ вставлять не нужно, всё проходит по защищённому OAuth.

  • Claude (claude.ai) — раздел Connectors / Settings, добавьте свой MCP-сервер с адресом https://mcp.apiin.ru/mcp. Откроется окно Apiin — войдите, выберите организации и права, подтвердите.
  • ChatGPT — в Developer Mode добавьте коннектор с тем же адресом и пройдите тот же вход. (На тарифах Plus/Pro инструменты доступны в режиме чтения, полный доступ — на Business/Enterprise.)

Подключение появится в кабинете (раздел API, MCP → Подключения) — оттуда его можно отозвать в любой момент. Права и организации вы выбираете на экране согласия сами.

Claude Code, Cursor, VS Code и другие — по OAuth (рекомендуем)

Достаточно адреса https://mcp.apiin.ru/mcp — клиент сам найдёт авторизацию (OAuth 2.1 + PKCE + динамическая регистрация), откроет браузер, вы выберете организации и права, и подключение появится в кабинете (API, MCP → Подключения) с возможностью отзыва. Можно просто прислать нейросети эту страницу или адрес mcp.apiin.ru — там машиночитаемая визитка со всем необходимым.

Claude Code — одна команда:

claude mcp add --transport http apiin https://mcp.apiin.ru/mcp

Cursor (.cursor/mcp.json) и Windsurf (mcp_config.json):

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

VS Code / Copilot (.vscode/mcp.json — ключ servers и обязательный type):

{ "servers": { "apiin": { "type": "http", "url": "https://mcp.apiin.ru/mcp" } } }

Codex CLI (~/.codex/config.toml; авторизация — codex mcp login apiin):

[mcp_servers.apiin]
url = "https://mcp.apiin.ru/mcp"

OpenCode (opencode.json; вход — opencode mcp auth apiin):

{ "mcp": { "servers": { "apiin": { "type": "remote", "url": "https://mcp.apiin.ru/mcp" } } } }

Если клиент не подхватывает OAuth напрямую (некоторые сборки Windsurf), используйте обёртку: "command": "npx", "args": ["mcp-remote", "https://mcp.apiin.ru/mcp"].

Альтернатива — по API-ключу (headless/серверные сценарии)

Создайте ключ в кабинете (app.apiin.ru), раздел API, MCP, с нужными правами — и передайте его заголовком:

{
  "mcpServers": {
    "apiin": {
      "url": "https://mcp.apiin.ru/mcp",
      "headers": { "Authorization": "Bearer apiin_live_xxxxxxxx" }
    }
  }
}

Что умеет ассистент

  • Вести контрагентов и подтягивать реквизиты по ИНН/БИК. create_counterparty заводит нового, update_counterparty правит реквизиты, руководителя, формат нумерации и comment — внутреннюю заметку о контрагенте (до 2000 символов; «» очищает её). Заметка видна в кабинете и через API, но в документы, публичные ссылки и письма не попадает.
  • Создавать счета, акты и другие документы (счёт-договор, счёт-фактуру, договор, отчёты) по описанию на естественном языке.
  • Помечать оплату — частичную или полную.
  • Выписывать акт на основе счёта с автоматической связкой.
  • Переносить историю из другого сервиса: import_invoice за один вызов создаёт счёт с вашим номером и датой, отмечает оплату датой платежа, выписывает и подписывает акт. Повторный прогон по тому же номеру и тому же контрагенту дублей не создаёт (тот же номер у другого контрагента — ошибка с просьбой сменить номер). Контрагентов переиспользует по ИНН create_counterparty; контрагенты без ИНН не сверяются. Продолжить нумерацию — set_numbering (для контрагента со своим форматом номера — вместе с его counterparty_id). Порядок действий ассистент видит в инструкциях сервера; человеку — страница «Перенос документов».
  • Готовить документ на английском: language: "en" в create_invoice/create_act/update_document (язык по умолчанию — в update_organization вместе с default_currency). Переводятся системные надписи, даты и суммы; введённые наименования и реквизиты остаются как есть, а счёт-фактура и УПД печатаются по-русски всегда.
  • Создавать публичные ссылки на счета и получать ссылку на PDF.
  • Выписывать доверенности М-2, М-2а и свободные (create_power_of_attorney, mark_poa_used, revoke_poa, reissue_poa), вести справочник сотрудников и получать журнал доверенностей.
  • Вести деньги: операции и остатки (list_money_operations, money_summary, create_money_operation), привязывать поступления к счетам (allocate_payment, decide_payment_suggestion), записывать чеки и документы поставщиков (create_expense_document), загружать выписку «в 1С» (import_bank_statement).
  • Вести переписку: беседы и ленту (list_message_threads, read_thread_messages), отвечать с документами во вложении (send_message), открывать обсуждение документа командой (start_document_discussion). Подпись — «Нейросеть (MCP) от имени …».
  • Настраивать вебхуки — до 10 приёмников на организацию (list_webhooks, create_webhook, set_webhook, rotate_webhook_secret, get_webhook_secret, test_webhook, delete_webhook) — и смотреть журнал доставок (list_webhook_deliveries, в том числе по конкретному приёмнику).

Денежные значения в инструментах — в копейках (45 000 ₽ → 4500000), как и в REST API. Валют 19 — от рубля и доллара до тенге, лиры и дирхама; полный список и правила языка описаны в документации REST API.

Права ключа для MCP

Ассистент действует строго в рамках прав ключа. Для типового ведения документов достаточно documents:read, documents:write, counterparties:read/write и public_links:write; отметки оплаты требуют payments:write, удаление — documents:delete (в documents:write они не входят); для настройки вебхуков — webhooks:write. Полный каталог — на странице Права и роли. Выдавайте только необходимое и отзывайте ключ, когда он больше не нужен.

Полный перечень операций и форматов — в разделе REST API. Создайте ключ в кабинете.