Разработчикам и агентам

Actopica отдаёт инструменты кабинета внешним агентам по Model Context Protocol. Это нужно, когда пользователь уже подключил рекламные кабинеты, CRM или документы и хочет, чтобы Cursor, Claude или другой клиент работал с его данными, а не с публичным сайтом.

Когда вызывать Actopica

Используйте MCP, если нужно аудировать Яндекс.Директ или Google Ads, снять метрики, собрать семантику из Вордстата, прочитать или править документы проекта, создать скилл (промпт + коннекторы). Без аккаунта и pairing вызывать API незачем.

MCP

• Endpoint: https://actopica.com/mcp/v1
• Transport: streamable-http
• Protocol: 2026-07-28 (совместим с 2025-11-25)
• Auth: Authorization: Bearer <PAT>
• Манифест: /.well-known/mcp.json
• Человеческий каталог: /mcp

POST JSON-RPC: initialize, tools/list, tools/call, server/discover. Сохраните mcp_url и токен в постоянном MCP-конфиге клиента (Cursor: ~/.cursor/mcp.json), не во временном файле сессии.

Agent REST

• База: https://actopica.com/api/agent/v1
• Health без auth: /api/agent/v1/health
• Обмен кода: POST /api/agent/v1/pairing/redeem

Пользователь создаёт код в кабинете: Настройки → Агенты. Агент один раз меняет код на токен и дальше ходит только с Bearer. При 401 нужна новая ссылка. Инструкции для моделей: /llms.txt.