Подключить ассистента
Ocost — это ещё и сервер Model Context Protocol (MCP). Подключите Claude Desktop, Claude Code, Cursor или другого ассистента, и он будет искать ваши документы, читать их, запрашивать ваши цифры и отправлять файлы. claude.ai и ChatGPT подключаются через OAuth, а не по ключу.
Сервер
https://api.ocost.io/public/mcp
Authorization: Bearer ocost_sk_<id>_<secret>Сервер работает по Streamable HTTP и не хранит сессий, поэтому каждый запрос самостоятелен. https://app.ocost.io/public/mcp — тот же сервер. Дайте каждому ассистенту собственный ключ только с нужными ему правами. Тогда вы видите его последнее использование в разделе Настройки › Разработчикам и можете отозвать только его. На странице Инструменты MCP каждый инструмент указан с его правом и аргументами.
Claude Code
Добавьте сервер с ключом из окружения:
claude mcp add --transport http ocost https://api.ocost.io/public/mcp \
--header "Authorization: Bearer $OCOST_KEY"После этого claude mcp list показывает ocost как подключённый. Чтобы поделиться сервером в репозитории, поместите его в .mcp.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.
{
"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 проекта:
{
"mcpServers": {
"ocost": {
"url": "https://api.ocost.io/public/mcp",
"headers": { "Authorization": "Bearer ${env:OCOST_KEY}" }
}
}
}claude.ai и ChatGPT
Эти приложения добавляют серверы только через OAuth. Ключ не нужен: вы входите в Ocost и разрешаете доступ.
- Добавьте собственный коннектор. В claude.ai откройте Settings › Connectors › Add custom connector. В ChatGPT добавьте собственный коннектор в режиме разработчика.
- Введите только URL
https://api.ocost.io/public/mcp. Оставьте client ID и secret пустыми. - Войдите в Ocost, когда приложение его откроет. Если вы состоите в нескольких компаниях, выберите нужную через Другая компания.
- Отметьте права, которые разрешаете, и подтвердите. Разрешить доступ могут только владелец и бухгалтер.
После этого приложение действует от вашего имени и с вашими полномочиями. Оно получает собственный ключ, который виден как «<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 и без идентификатора сессии. Чтобы проверить подключение, запросите список инструментов:
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 списки и цифры приходят также в виде интерактивной таблицы или диаграммы.
Каждый вызов записывается, без слов документа. Владелец и бухгалтер видят последние вызовы ключа в разделе Настройки › Разработчикам.