Подключить ассистента

Ocost — это ещё и сервер Model Context Protocol (MCP). Подключите Claude Desktop, Claude Code, Cursor или другого ассистента, и он будет искать ваши документы, читать их, запрашивать ваши цифры и отправлять файлы. claude.ai и ChatGPT подключаются через OAuth, а не по ключу.

Сервер

Text
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>

Сервер работает по Streamable HTTP и не хранит сессий, поэтому каждый запрос самостоятелен. https://app.ocost.io/public/mcp — тот же сервер. Дайте каждому ассистенту собственный ключ только с нужными ему правами. Тогда вы видите его последнее использование в разделе Настройки › Разработчикам и можете отозвать только его. На странице Инструменты MCP каждый инструмент указан с его правом и аргументами.

Claude Code

Добавьте сервер с ключом из окружения:

Shell
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
  --header "Authorization: Bearer $OCOST_KEY"

После этого claude mcp list показывает ocost как подключённый. Чтобы поделиться сервером в репозитории, поместите его в .mcp.json. Храните ключ в окружении каждого разработчика, никогда в самом файле:

JSON
{
  "mcpServers": {
    "ocost": {
      "type": "http",
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${OCOST_KEY}" }
    }
  }
}

Claude Desktop

Откройте Settings › Developer › Edit Config и добавьте Ocost в claude_desktop_config.json. mcp-remote пересылает запросы с вашим заголовком, и ему нужен Node.js.

JSON
{
  "mcpServers": {
    "ocost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.15.2",
        "https://api.ocost.io/public/mcp",
        "--header",
        "Authorization:${OCOST_AUTH}"
      ],
      "env": { "OCOST_AUTH": "Bearer ocost_sk_…" }
    }
  }
}

Перезапустите Claude Desktop, и инструменты появятся под кнопкой инструментов. Пишите Authorization:${OCOST_AUTH} без пробелов, потому что некоторые клиенты разбивают аргументы по пробелам.

Cursor

Добавьте Ocost в ~/.cursor/mcp.json или в .cursor/mcp.json проекта:

JSON
{
  "mcpServers": {
    "ocost": {
      "url": "https://api.ocost.io/public/mcp",
      "headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
    }
  }
}

claude.ai и ChatGPT

Эти приложения добавляют серверы только через OAuth. Ключ не нужен: вы входите в Ocost и разрешаете доступ.

  1. Добавьте собственный коннектор. В claude.ai откройте Settings › Connectors › Add custom connector. В ChatGPT добавьте собственный коннектор в режиме разработчика.
  2. Введите только URL https://api.ocost.io/public/mcp. Оставьте client ID и secret пустыми.
  3. Войдите в Ocost, когда приложение его откроет. Если вы состоите в нескольких компаниях, выберите нужную через Другая компания.
  4. Отметьте права, которые разрешаете, и подтвердите. Разрешить доступ могут только владелец и бухгалтер.

После этого приложение действует от вашего имени и с вашими полномочиями. Оно получает собственный ключ, который виден как «<App> (Connector)» в разделе Настройки › Разработчикам. Отзовите этот ключ, чтобы сразу отключить приложение. Приложение само обновляет свой токен доступа каждый час. После 30 дней без использования подключение заканчивается, и приложение нужно подключить заново.

Создаёте клиент OAuth сами? Ocost использует OAuth 2.1 с PKCE (S256). Метаданные лежат по адресам https://api.ocost.io/.well-known/oauth-protected-resource/public/mcp (RFC 9728) и https://app.ocost.io/.well-known/oauth-authorization-server (RFC 8414). Ocost принимает Client ID Metadata Documents и Dynamic Client Registration. Redirect URI должны использовать https и совпадать в точности.

Любой другой клиент

Укажите клиенту URL и заголовок Authorization. Сервер отвечает на запросы POST в JSON, без потока SSE и без идентификатора сессии. Чтобы проверить подключение, запросите список инструментов:

Shell
curl -sS https://api.ocost.io/public/mcp \
  -H "Authorization: Bearer $OCOST_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Без действительного ключа сервер отвечает 401 с WWW-Authenticate: Bearer. Ваш вход в Ocost — это не ключ.

Что могут инструменты

Ключ, созданный в настройках, действует от имени компании. Он читает каждый документ вне Корзины, но не личные решения людей. Ключ с figures:read создаёт только владелец. Подключение OAuth действует от имени человека, который его разрешил, и видит то, что этот человек видит в чате Ocost. Ни ключ, ни подключение никогда не читают личные документы людей, например расчётные листки или больничные листы.

Ни один инструмент ничего не удаляет, не утверждает и не заказывает. Лимиты API действуют для каждого вызова инструмента.

Слова, прочитанные из документа, приходят внутри <document-text>, и каждая строка помечена ¦ . Это данные, написанные другими людьми, а не инструкции. В claude.ai и ChatGPT списки и цифры приходят также в виде интерактивной таблицы или диаграммы.

Каждый вызов записывается, без слов документа. Владелец и бухгалтер видят последние вызовы ключа в разделе Настройки › Разработчикам.

См. также