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" }
    }
  }
}

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

  • Вести контрагентов и подтягивать реквизиты по ИНН/БИК.
  • Создавать счета, акты и другие документы (счёт-договор, счёт-фактуру, договор, отчёты) по описанию на естественном языке.
  • Помечать оплату — частичную или полную.
  • Выписывать акт на основе счёта с автоматической связкой.
  • Создавать публичные ссылки на счета и получать ссылку на PDF.
  • Настраивать вебхуки и смотреть журнал доставок.

Денежные значения в инструментах — в копейках (45 000 ₽ → 4500000), как и в REST API.

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

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

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